@hot-updater/server 1.0.0-rc.14 → 1.0.0-rc.16

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 (514) hide show
  1. package/dist/adapters/drizzle.cjs +35 -74
  2. package/dist/adapters/drizzle.d.cts +13 -5
  3. package/dist/adapters/drizzle.d.mts +13 -5
  4. package/dist/adapters/drizzle.mjs +34 -75
  5. package/dist/adapters/drizzleExecutor.cjs +114 -0
  6. package/dist/adapters/drizzleExecutor.d.cts +9 -0
  7. package/dist/adapters/drizzleExecutor.d.mts +9 -0
  8. package/dist/adapters/drizzleExecutor.mjs +112 -0
  9. package/dist/adapters/kysely.cjs +25 -31
  10. package/dist/adapters/kysely.d.cts +10 -6
  11. package/dist/adapters/kysely.d.mts +10 -6
  12. package/dist/adapters/kysely.mjs +25 -32
  13. package/dist/adapters/kyselyExecutor.cjs +32 -0
  14. package/dist/adapters/kyselyExecutor.d.cts +12 -0
  15. package/dist/adapters/kyselyExecutor.d.mts +12 -0
  16. package/dist/adapters/kyselyExecutor.mjs +32 -0
  17. package/dist/adapters/mongodb.cjs +28 -62
  18. package/dist/adapters/mongodb.d.cts +10 -5
  19. package/dist/adapters/mongodb.d.mts +10 -5
  20. package/dist/adapters/mongodb.mjs +28 -63
  21. package/dist/adapters/mongodbAdapter.cjs +174 -0
  22. package/dist/adapters/mongodbAdapter.d.cts +9 -0
  23. package/dist/adapters/mongodbAdapter.d.mts +9 -0
  24. package/dist/adapters/mongodbAdapter.mjs +173 -0
  25. package/dist/adapters/prisma.cjs +38 -257
  26. package/dist/adapters/prisma.d.cts +12 -7
  27. package/dist/adapters/prisma.d.mts +12 -7
  28. package/dist/adapters/prisma.mjs +38 -257
  29. package/dist/adapters/prismaExecutor.cjs +64 -0
  30. package/dist/adapters/prismaExecutor.mjs +64 -0
  31. package/dist/adapters/sqlProviders.cjs +9 -0
  32. package/dist/adapters/sqlProviders.mjs +9 -0
  33. package/dist/apiKeys.cjs +2 -6
  34. package/dist/apiKeys.d.cts +1 -23
  35. package/dist/apiKeys.d.mts +1 -23
  36. package/dist/apiKeys.mjs +2 -6
  37. package/dist/assembly/assemblePlugins.cjs +147 -0
  38. package/dist/assembly/assemblePlugins.d.cts +12 -0
  39. package/dist/assembly/assemblePlugins.d.mts +12 -0
  40. package/dist/assembly/assemblePlugins.mjs +146 -0
  41. package/dist/assembly/databasePlugins.cjs +23 -0
  42. package/dist/assembly/databasePlugins.d.cts +43 -0
  43. package/dist/assembly/databasePlugins.d.mts +43 -0
  44. package/dist/assembly/databasePlugins.mjs +22 -0
  45. package/dist/core/api.cjs +91 -0
  46. package/dist/core/api.d.cts +65 -0
  47. package/dist/core/api.d.mts +65 -0
  48. package/dist/core/api.mjs +87 -0
  49. package/dist/core/baseCandidates.cjs +71 -0
  50. package/dist/core/baseCandidates.d.cts +17 -0
  51. package/dist/core/baseCandidates.d.mts +17 -0
  52. package/dist/core/baseCandidates.mjs +69 -0
  53. package/dist/core/operations.cjs +350 -0
  54. package/dist/core/operations.mjs +350 -0
  55. package/dist/core/reads.cjs +273 -0
  56. package/dist/core/reads.d.cts +48 -0
  57. package/dist/core/reads.d.mts +48 -0
  58. package/dist/core/reads.mjs +267 -0
  59. package/dist/core/releases.cjs +193 -0
  60. package/dist/core/releases.mjs +190 -0
  61. package/dist/core/schema.cjs +279 -0
  62. package/dist/core/schema.d.cts +307 -0
  63. package/dist/core/schema.d.mts +307 -0
  64. package/dist/core/schema.mjs +277 -0
  65. package/dist/core/writes.cjs +96 -0
  66. package/dist/core/writes.mjs +91 -0
  67. package/dist/createHotUpdaterCore.cjs +58 -75
  68. package/dist/createHotUpdaterCore.d.cts +52 -44
  69. package/dist/createHotUpdaterCore.d.mts +52 -44
  70. package/dist/createHotUpdaterCore.mjs +59 -75
  71. package/dist/database/cursor.cjs +44 -0
  72. package/dist/database/cursor.d.cts +7 -0
  73. package/dist/database/cursor.d.mts +7 -0
  74. package/dist/database/cursor.mjs +40 -0
  75. package/dist/database/database.cjs +44 -0
  76. package/dist/database/database.d.cts +123 -0
  77. package/dist/database/database.d.mts +123 -0
  78. package/dist/database/database.mjs +44 -0
  79. package/dist/database/definitions.d.cts +68 -0
  80. package/dist/database/definitions.d.mts +68 -0
  81. package/dist/database/engine.cjs +37 -0
  82. package/dist/database/engine.d.cts +40 -0
  83. package/dist/database/engine.d.mts +40 -0
  84. package/dist/database/engine.mjs +37 -0
  85. package/dist/database/engineAggregates.cjs +115 -0
  86. package/dist/database/engineAggregates.mjs +112 -0
  87. package/dist/database/engineReads.cjs +180 -0
  88. package/dist/database/engineReads.d.cts +35 -0
  89. package/dist/database/engineReads.d.mts +35 -0
  90. package/dist/database/engineReads.mjs +179 -0
  91. package/dist/database/engineTransaction.cjs +403 -0
  92. package/dist/database/engineTransaction.d.cts +26 -0
  93. package/dist/database/engineTransaction.d.mts +26 -0
  94. package/dist/database/engineTransaction.mjs +402 -0
  95. package/dist/database/errors.cjs +27 -0
  96. package/dist/database/errors.d.cts +21 -0
  97. package/dist/database/errors.d.mts +21 -0
  98. package/dist/database/errors.mjs +24 -0
  99. package/dist/database/fence.cjs +124 -0
  100. package/dist/database/fence.d.cts +42 -0
  101. package/dist/database/fence.d.mts +42 -0
  102. package/dist/database/fence.mjs +116 -0
  103. package/dist/database/index.cjs +127 -0
  104. package/dist/database/index.d.cts +17 -0
  105. package/dist/database/index.d.mts +17 -0
  106. package/dist/database/index.mjs +15 -0
  107. package/dist/database/kv/kvAdapter.cjs +273 -0
  108. package/dist/database/kv/kvAdapter.d.cts +101 -0
  109. package/dist/database/kv/kvAdapter.d.mts +101 -0
  110. package/dist/database/kv/kvAdapter.mjs +272 -0
  111. package/dist/database/resolveSchema.cjs +196 -0
  112. package/dist/database/resolveSchema.d.cts +42 -0
  113. package/dist/database/resolveSchema.d.mts +42 -0
  114. package/dist/database/resolveSchema.mjs +193 -0
  115. package/dist/database/schema.cjs +21 -0
  116. package/dist/database/schema.d.cts +61 -0
  117. package/dist/database/schema.d.mts +61 -0
  118. package/dist/database/schema.mjs +20 -0
  119. package/dist/database/sql/sqlAdapter.cjs +282 -0
  120. package/dist/database/sql/sqlAdapter.d.cts +46 -0
  121. package/dist/database/sql/sqlAdapter.d.mts +46 -0
  122. package/dist/database/sql/sqlAdapter.mjs +279 -0
  123. package/dist/database/sql/sqlSchema.cjs +115 -0
  124. package/dist/database/sql/sqlSchema.d.cts +8 -0
  125. package/dist/database/sql/sqlSchema.d.mts +8 -0
  126. package/dist/database/sql/sqlSchema.mjs +111 -0
  127. package/dist/db/builtInDatabase.cjs +104 -0
  128. package/dist/db/builtInDatabase.d.cts +38 -0
  129. package/dist/db/builtInDatabase.d.mts +38 -0
  130. package/dist/db/builtInDatabase.mjs +97 -0
  131. package/dist/db/createBundleDiff.cjs +4 -4
  132. package/dist/db/createBundleDiff.d.cts +3 -2
  133. package/dist/db/createBundleDiff.d.mts +3 -2
  134. package/dist/db/createBundleDiff.mjs +5 -5
  135. package/dist/db/engineDrizzleSchema.cjs +54 -0
  136. package/dist/db/engineDrizzleSchema.mjs +54 -0
  137. package/dist/db/engineMigrator.cjs +53 -0
  138. package/dist/db/engineMigrator.mjs +53 -0
  139. package/dist/db/enginePrismaSchema.cjs +85 -0
  140. package/dist/db/enginePrismaSchema.d.cts +5 -0
  141. package/dist/db/enginePrismaSchema.d.mts +5 -0
  142. package/dist/db/enginePrismaSchema.mjs +84 -0
  143. package/dist/db/engineSql.cjs +26 -0
  144. package/dist/db/engineSql.d.cts +17 -0
  145. package/dist/db/engineSql.d.mts +17 -0
  146. package/dist/db/engineSql.mjs +25 -0
  147. package/dist/db/engineSqlMigrator.cjs +66 -0
  148. package/dist/db/engineSqlMigrator.mjs +66 -0
  149. package/dist/db/fixedMigratorShared.cjs +0 -11
  150. package/dist/db/fixedMigratorShared.mjs +1 -8
  151. package/dist/db/index.cjs +23 -8
  152. package/dist/db/index.d.cts +10 -3
  153. package/dist/db/index.d.mts +10 -3
  154. package/dist/db/index.mjs +16 -8
  155. package/dist/db/releaseCatalog.cjs +20 -43
  156. package/dist/db/releaseCatalog.d.cts +2 -2
  157. package/dist/db/releaseCatalog.d.mts +2 -2
  158. package/dist/db/releaseCatalog.mjs +20 -44
  159. package/dist/db/schemaSettings.cjs +63 -0
  160. package/dist/db/schemaSettings.d.cts +12 -0
  161. package/dist/db/schemaSettings.d.mts +12 -0
  162. package/dist/db/schemaSettings.mjs +62 -0
  163. package/dist/db/settingsMigrator.cjs +92 -0
  164. package/dist/db/settingsMigrator.mjs +89 -0
  165. package/dist/db/types.cjs +1 -12
  166. package/dist/db/types.d.cts +26 -66
  167. package/dist/db/types.d.mts +26 -66
  168. package/dist/db/types.mjs +2 -11
  169. package/dist/db/updateArtifacts.cjs +38 -67
  170. package/dist/db/updateArtifacts.mjs +40 -69
  171. package/dist/handler.cjs +72 -43
  172. package/dist/handler.d.cts +3 -5
  173. package/dist/handler.d.mts +3 -5
  174. package/dist/handler.mjs +73 -43
  175. package/dist/handlerAdminRoutes.cjs +375 -0
  176. package/dist/handlerAdminRoutes.mjs +373 -0
  177. package/dist/handlerParameters.cjs +6 -11
  178. package/dist/handlerParameters.mjs +6 -10
  179. package/dist/handlerReleaseCatalogRoutes.cjs +11 -13
  180. package/dist/handlerReleaseCatalogRoutes.mjs +11 -13
  181. package/dist/handlerTypes.d.cts +2 -55
  182. package/dist/handlerTypes.d.mts +2 -55
  183. package/dist/handlerVersionRoutes.cjs +20 -4
  184. package/dist/handlerVersionRoutes.mjs +20 -4
  185. package/dist/index.cjs +4 -7
  186. package/dist/index.d.cts +8 -7
  187. package/dist/index.d.mts +8 -7
  188. package/dist/index.mjs +4 -4
  189. package/dist/insights/domain.d.cts +12 -0
  190. package/dist/insights/domain.d.mts +12 -0
  191. package/dist/insights/errors.cjs +34 -0
  192. package/dist/insights/errors.mjs +34 -1
  193. package/dist/insights/eventInput.cjs +14 -19
  194. package/dist/insights/eventInput.mjs +15 -20
  195. package/dist/insights/provider.cjs +47 -23
  196. package/dist/insights/provider.mjs +47 -24
  197. package/dist/insights/routes.cjs +79 -14
  198. package/dist/insights/routes.mjs +77 -14
  199. package/dist/node.d.cts +1 -1
  200. package/dist/node.d.mts +1 -1
  201. package/dist/package.cjs +1 -1
  202. package/dist/package.mjs +1 -1
  203. package/dist/plugins/api-keys/index.cjs +50 -0
  204. package/dist/plugins/api-keys/index.d.cts +85 -0
  205. package/dist/plugins/api-keys/index.d.mts +85 -0
  206. package/dist/plugins/api-keys/index.mjs +47 -0
  207. package/dist/plugins/api-keys/model.cjs +58 -0
  208. package/dist/plugins/api-keys/model.d.cts +8 -0
  209. package/dist/plugins/api-keys/model.d.mts +8 -0
  210. package/dist/plugins/api-keys/model.mjs +58 -0
  211. package/dist/plugins/api-keys/schema.cjs +38 -0
  212. package/dist/plugins/api-keys/schema.d.cts +44 -0
  213. package/dist/plugins/api-keys/schema.d.mts +44 -0
  214. package/dist/plugins/api-keys/schema.mjs +39 -0
  215. package/dist/plugins/builtIn.cjs +7 -0
  216. package/dist/plugins/builtIn.mjs +6 -0
  217. package/dist/plugins/definePlugin.cjs +5 -0
  218. package/dist/plugins/definePlugin.d.cts +73 -0
  219. package/dist/plugins/definePlugin.d.mts +73 -0
  220. package/dist/plugins/definePlugin.mjs +5 -0
  221. package/dist/plugins/index.cjs +17 -0
  222. package/dist/plugins/index.d.cts +9 -0
  223. package/dist/plugins/index.d.mts +9 -0
  224. package/dist/plugins/index.mjs +7 -0
  225. package/dist/plugins/insights/index.cjs +48 -0
  226. package/dist/plugins/insights/index.d.cts +295 -0
  227. package/dist/plugins/insights/index.d.mts +295 -0
  228. package/dist/plugins/insights/index.mjs +44 -0
  229. package/dist/plugins/insights/model.cjs +17 -0
  230. package/dist/plugins/insights/model.d.cts +10 -0
  231. package/dist/plugins/insights/model.d.mts +10 -0
  232. package/dist/plugins/insights/model.mjs +17 -0
  233. package/dist/plugins/insights/reads.cjs +471 -0
  234. package/dist/plugins/insights/reads.mjs +466 -0
  235. package/dist/plugins/insights/recordEvent.cjs +135 -0
  236. package/dist/plugins/insights/recordEvent.d.cts +13 -0
  237. package/dist/plugins/insights/recordEvent.d.mts +13 -0
  238. package/dist/plugins/insights/recordEvent.mjs +132 -0
  239. package/dist/plugins/insights/schema.cjs +347 -0
  240. package/dist/plugins/insights/schema.d.cts +258 -0
  241. package/dist/plugins/insights/schema.d.mts +258 -0
  242. package/dist/plugins/insights/schema.mjs +344 -0
  243. package/dist/types/index.d.cts +2 -28
  244. package/dist/types/index.d.mts +2 -28
  245. package/package.json +28 -5
  246. package/src/adapters/drizzle.conformance.integration.spec.ts +34 -0
  247. package/src/adapters/drizzle.readBudgets.integration.spec.ts +41 -0
  248. package/src/adapters/drizzle.spec.ts +270 -399
  249. package/src/adapters/drizzle.ts +48 -140
  250. package/src/adapters/drizzleExecutor.ts +166 -0
  251. package/src/adapters/kysely.conformance.integration.spec.ts +36 -0
  252. package/src/adapters/kysely.readBudgets.integration.spec.ts +42 -0
  253. package/src/adapters/kysely.spec.ts +204 -171
  254. package/src/adapters/kysely.ts +32 -93
  255. package/src/adapters/kyselyExecutor.ts +53 -0
  256. package/src/adapters/mongodb.integration.spec.ts +143 -446
  257. package/src/adapters/mongodb.readBudgets.integration.spec.ts +61 -0
  258. package/src/adapters/mongodb.ts +36 -123
  259. package/src/adapters/mongodbAdapter.ts +293 -0
  260. package/src/adapters/prisma.conformance.integration.spec.ts +36 -0
  261. package/src/adapters/prisma.integration.spec.ts +138 -0
  262. package/src/adapters/prisma.readBudgets.integration.spec.ts +40 -0
  263. package/src/adapters/prisma.spec.ts +216 -433
  264. package/src/adapters/prisma.ts +60 -524
  265. package/src/adapters/prismaExecutor.ts +107 -0
  266. package/src/adapters/prismaTestClients.ts +175 -0
  267. package/src/adapters/sqlProviders.ts +14 -0
  268. package/src/apiKeys.integration.spec.ts +19 -119
  269. package/src/apiKeys.spec.ts +39 -35
  270. package/src/apiKeys.ts +2 -8
  271. package/src/assembly/assemblePlugins.ts +269 -0
  272. package/src/assembly/assembly.spec.ts +325 -0
  273. package/src/assembly/assembly.types.spec.ts +155 -0
  274. package/src/assembly/builtInRoutes.spec.ts +213 -0
  275. package/src/assembly/databasePlugins.spec.ts +71 -0
  276. package/src/assembly/databasePlugins.ts +96 -0
  277. package/src/core/api.ts +139 -0
  278. package/src/core/baseCandidates.spec.ts +378 -0
  279. package/src/core/baseCandidates.ts +136 -0
  280. package/src/core/index.ts +44 -0
  281. package/src/core/operations.spec.ts +415 -0
  282. package/src/core/operations.ts +551 -0
  283. package/src/core/reads.spec.ts +300 -0
  284. package/src/core/reads.ts +417 -0
  285. package/src/core/releases.spec.ts +308 -0
  286. package/src/core/releases.ts +345 -0
  287. package/src/core/schema.ts +173 -0
  288. package/src/core/writes.ts +160 -0
  289. package/src/createHotUpdaterCore.ts +191 -181
  290. package/src/database/cursor.ts +65 -0
  291. package/src/database/database.ts +335 -0
  292. package/src/database/database.types.spec.ts +135 -0
  293. package/src/database/definitions.ts +72 -0
  294. package/src/database/engine.ts +62 -0
  295. package/src/database/engineAggregates.spec.ts +539 -0
  296. package/src/database/engineAggregates.ts +193 -0
  297. package/src/database/engineReads.spec.ts +219 -0
  298. package/src/database/engineReads.ts +302 -0
  299. package/src/database/engineTransaction.spec.ts +710 -0
  300. package/src/database/engineTransaction.ts +588 -0
  301. package/src/database/errors.ts +30 -0
  302. package/src/database/fence.spec.ts +223 -0
  303. package/src/database/fence.ts +171 -0
  304. package/src/database/index.ts +154 -0
  305. package/src/database/kv/kvAdapter.conformance.integration.spec.ts +17 -0
  306. package/src/database/kv/kvAdapter.readBudgets.integration.spec.ts +17 -0
  307. package/src/database/kv/kvAdapter.spec.ts +468 -0
  308. package/src/database/kv/kvAdapter.ts +450 -0
  309. package/src/database/kv/kvTestStore.ts +91 -0
  310. package/src/database/memory.readBudgets.integration.spec.ts +13 -0
  311. package/src/database/resolveSchema.spec.ts +230 -0
  312. package/src/database/resolveSchema.ts +372 -0
  313. package/src/database/schema.ts +169 -0
  314. package/src/database/schema.types.spec.ts +94 -0
  315. package/src/database/sql/docker-compose.yml +36 -0
  316. package/src/database/sql/sqlAdapter.integration.spec.ts +148 -0
  317. package/src/database/sql/sqlAdapter.readBudgets.integration.spec.ts +109 -0
  318. package/src/database/sql/sqlAdapter.spec.ts +255 -0
  319. package/src/database/sql/sqlAdapter.ts +532 -0
  320. package/src/database/sql/sqlSchema.ts +205 -0
  321. package/src/database/sql/sqlTestExecutors.ts +183 -0
  322. package/src/databaseTestSuite.spec.ts +39 -0
  323. package/src/db/builtInDatabase.ts +149 -0
  324. package/src/db/bundleRows.spec.ts +3 -3
  325. package/src/db/createBundleDiff.spec.ts +43 -29
  326. package/src/db/createBundleDiff.ts +13 -7
  327. package/src/db/engineDrizzleSchema.ts +72 -0
  328. package/src/db/engineMigrator.ts +105 -0
  329. package/src/db/enginePrismaSchema.ts +147 -0
  330. package/src/db/engineSql.spec.ts +129 -0
  331. package/src/db/engineSql.ts +48 -0
  332. package/src/db/engineSqlMigrator.ts +116 -0
  333. package/src/db/fixedMigratorShared.ts +1 -20
  334. package/src/db/index.spec.ts +116 -829
  335. package/src/db/index.ts +43 -14
  336. package/src/db/pluginTables.spec.ts +218 -0
  337. package/src/db/releaseCatalog.ts +48 -90
  338. package/src/db/schemaSettings.ts +104 -0
  339. package/src/db/settingsMigrator.spec.ts +65 -0
  340. package/src/db/settingsMigrator.ts +152 -0
  341. package/src/db/types.ts +25 -171
  342. package/src/db/updateArtifacts.spec.ts +170 -294
  343. package/src/db/updateArtifacts.ts +74 -142
  344. package/src/db/updateCheck.bench.ts +47 -0
  345. package/src/handler-standalone.integration.spec.ts +204 -410
  346. package/src/handler.spec.ts +134 -51
  347. package/src/handler.testFixtures.ts +14 -19
  348. package/src/handler.ts +163 -75
  349. package/src/handlerAdminRoutes.spec.ts +183 -0
  350. package/src/handlerAdminRoutes.ts +536 -0
  351. package/src/handlerAuth.integration.spec.ts +3 -3
  352. package/src/handlerManagement.spec.ts +136 -196
  353. package/src/handlerReleaseCatalogRoutes.ts +15 -17
  354. package/src/handlerTypes.ts +3 -80
  355. package/src/handlerVersionRoutes.ts +20 -7
  356. package/src/index.ts +5 -12
  357. package/src/insights/domain.ts +12 -0
  358. package/src/insights/errors.spec.ts +48 -0
  359. package/src/insights/errors.ts +51 -0
  360. package/src/insights/eventInput.ts +27 -24
  361. package/src/insights/insights.integration.spec.ts +228 -78
  362. package/src/insights/provider.spec.ts +203 -25
  363. package/src/insights/provider.ts +88 -32
  364. package/src/insights/routes.ts +95 -20
  365. package/src/lintRules.spec.ts +76 -0
  366. package/src/plugins/api-keys/apiKeysPlugin.spec.ts +172 -0
  367. package/src/plugins/api-keys/index.ts +66 -0
  368. package/src/plugins/api-keys/model.ts +69 -0
  369. package/src/plugins/api-keys/schema.ts +22 -0
  370. package/src/plugins/builtIn.ts +5 -0
  371. package/src/plugins/definePlugin.ts +100 -0
  372. package/src/plugins/index.ts +55 -0
  373. package/src/plugins/insights/index.ts +86 -0
  374. package/src/plugins/insights/insightsRollout.integration.spec.ts +187 -0
  375. package/src/plugins/insights/model.spec.ts +66 -0
  376. package/src/plugins/insights/model.ts +19 -0
  377. package/src/plugins/insights/reads.spec.ts +725 -0
  378. package/src/plugins/insights/reads.ts +707 -0
  379. package/src/plugins/insights/recordEvent.spec.ts +443 -0
  380. package/src/plugins/insights/recordEvent.ts +238 -0
  381. package/src/plugins/insights/schema.ts +229 -0
  382. package/src/plugins/pluginTestHarness.spec.ts +56 -0
  383. package/src/readBudgets.testFixtures.ts +15 -0
  384. package/src/releaseCatalogRoutes.integration.spec.ts +47 -92
  385. package/src/runtime.spec.ts +91 -77
  386. package/src/runtime.testFixtures.ts +28 -44
  387. package/src/runtimeBundles.integration.spec.ts +112 -0
  388. package/src/testUtilsMutation.integration.spec.ts +215 -0
  389. package/src/testUtilsPackage.integration.spec.ts +176 -0
  390. package/src/types/index.ts +0 -32
  391. package/dist/adapters/databaseConstraintErrors.cjs +0 -22
  392. package/dist/adapters/databaseConstraintErrors.mjs +0 -21
  393. package/dist/adapters/databasePluginUtils.cjs +0 -130
  394. package/dist/adapters/databasePluginUtils.mjs +0 -118
  395. package/dist/adapters/drizzleCrud.cjs +0 -340
  396. package/dist/adapters/drizzleCrud.mjs +0 -337
  397. package/dist/adapters/drizzleLazyDB.cjs +0 -103
  398. package/dist/adapters/drizzleLazyDB.mjs +0 -103
  399. package/dist/adapters/drizzleQuery.cjs +0 -69
  400. package/dist/adapters/drizzleQuery.mjs +0 -69
  401. package/dist/adapters/kyselyCrud.cjs +0 -293
  402. package/dist/adapters/kyselyCrud.mjs +0 -292
  403. package/dist/adapters/kyselyQuery.cjs +0 -56
  404. package/dist/adapters/kyselyQuery.mjs +0 -56
  405. package/dist/adapters/mongodbCollections.cjs +0 -38
  406. package/dist/adapters/mongodbCollections.mjs +0 -32
  407. package/dist/adapters/mongodbQuery.cjs +0 -90
  408. package/dist/adapters/mongodbQuery.mjs +0 -83
  409. package/dist/adapters/mongodbReads.cjs +0 -206
  410. package/dist/adapters/mongodbReads.mjs +0 -206
  411. package/dist/adapters/mongodbWrites.cjs +0 -133
  412. package/dist/adapters/mongodbWrites.mjs +0 -133
  413. package/dist/adapters/prismaInsights.cjs +0 -99
  414. package/dist/adapters/prismaInsights.mjs +0 -97
  415. package/dist/adapters/prismaQuery.cjs +0 -57
  416. package/dist/adapters/prismaQuery.mjs +0 -56
  417. package/dist/adapters/prismaRows.cjs +0 -197
  418. package/dist/adapters/prismaRows.mjs +0 -188
  419. package/dist/db/databasePluginCore.cjs +0 -137
  420. package/dist/db/databasePluginCore.mjs +0 -137
  421. package/dist/db/fixedMigrator.cjs +0 -79
  422. package/dist/db/fixedMigrator.mjs +0 -78
  423. package/dist/db/fixedMigratorMongo.cjs +0 -321
  424. package/dist/db/fixedMigratorMongo.mjs +0 -321
  425. package/dist/db/mongoMigrationExecution.cjs +0 -11
  426. package/dist/db/mongoMigrationExecution.mjs +0 -11
  427. package/dist/db/schema/insightsCollation.cjs +0 -14
  428. package/dist/db/schema/insightsCollation.mjs +0 -14
  429. package/dist/db/schema/mongodb.cjs +0 -25
  430. package/dist/db/schema/mongodb.mjs +0 -25
  431. package/dist/db/schema/registry.cjs +0 -21
  432. package/dist/db/schema/registry.mjs +0 -17
  433. package/dist/db/schema/sql.cjs +0 -105
  434. package/dist/db/schema/sql.mjs +0 -97
  435. package/dist/db/schema/sqlOperations.cjs +0 -27
  436. package/dist/db/schema/sqlOperations.mjs +0 -26
  437. package/dist/db/schemaGenerators.cjs +0 -276
  438. package/dist/db/schemaGenerators.mjs +0 -274
  439. package/dist/db/schemaReadiness.cjs +0 -26
  440. package/dist/db/schemaReadiness.d.cts +0 -9
  441. package/dist/db/schemaReadiness.d.mts +0 -9
  442. package/dist/db/schemaReadiness.mjs +0 -25
  443. package/dist/db/sqlMigrationExecution.cjs +0 -67
  444. package/dist/db/sqlMigrationExecution.mjs +0 -67
  445. package/dist/handlerBundleRoutes.cjs +0 -155
  446. package/dist/handlerBundleRoutes.mjs +0 -155
  447. package/dist/handlerReleaseManagementRoutes.cjs +0 -124
  448. package/dist/handlerReleaseManagementRoutes.mjs +0 -124
  449. package/dist/schema/dsl.cjs +0 -103
  450. package/dist/schema/dsl.mjs +0 -87
  451. package/dist/schema/index.cjs +0 -20
  452. package/dist/schema/index.mjs +0 -7
  453. package/dist/schema/settings.cjs +0 -9
  454. package/dist/schema/settings.mjs +0 -9
  455. package/dist/schema/types.cjs +0 -8
  456. package/dist/schema/types.mjs +0 -6
  457. package/dist/schema/v1_0_0.cjs +0 -393
  458. package/dist/schema/v1_0_0.mjs +0 -385
  459. package/src/adapters/databaseConstraintErrors.ts +0 -25
  460. package/src/adapters/databasePluginTestDatabase.ts +0 -116
  461. package/src/adapters/databasePluginUtils.spec.ts +0 -29
  462. package/src/adapters/databasePluginUtils.ts +0 -238
  463. package/src/adapters/drizzleCrud.ts +0 -610
  464. package/src/adapters/drizzleLazyDB.ts +0 -284
  465. package/src/adapters/drizzleQuery.ts +0 -164
  466. package/src/adapters/kyselyCrud.ts +0 -696
  467. package/src/adapters/kyselyInsights.spec.ts +0 -168
  468. package/src/adapters/kyselyQuery.ts +0 -128
  469. package/src/adapters/mongodb.spec.ts +0 -230
  470. package/src/adapters/mongodbCollections.ts +0 -78
  471. package/src/adapters/mongodbQuery.ts +0 -245
  472. package/src/adapters/mongodbReads.ts +0 -387
  473. package/src/adapters/mongodbRows.spec.ts +0 -64
  474. package/src/adapters/mongodbRows.ts +0 -118
  475. package/src/adapters/mongodbTestClient.ts +0 -443
  476. package/src/adapters/mongodbTestFilter.ts +0 -170
  477. package/src/adapters/mongodbWrites.ts +0 -261
  478. package/src/adapters/prismaInsights.ts +0 -190
  479. package/src/adapters/prismaQuery.ts +0 -129
  480. package/src/adapters/prismaRows.spec.ts +0 -98
  481. package/src/adapters/prismaRows.ts +0 -308
  482. package/src/adapters/prismaTestClient.ts +0 -478
  483. package/src/calculatePagination.ts +0 -34
  484. package/src/db/databasePluginCore.spec.ts +0 -62
  485. package/src/db/databasePluginCore.testFixtures.ts +0 -76
  486. package/src/db/databasePluginCore.ts +0 -185
  487. package/src/db/databasePluginUpdateCheck.bench.ts +0 -117
  488. package/src/db/fixedMigrator.spec.ts +0 -294
  489. package/src/db/fixedMigrator.ts +0 -147
  490. package/src/db/fixedMigratorMongo.spec.ts +0 -253
  491. package/src/db/fixedMigratorMongo.ts +0 -425
  492. package/src/db/hotUpdaterSchema.ts +0 -5
  493. package/src/db/mongoMigrationExecution.ts +0 -23
  494. package/src/db/schema/definitions.ts +0 -1
  495. package/src/db/schema/insightsCollation.ts +0 -21
  496. package/src/db/schema/mongodb.ts +0 -40
  497. package/src/db/schema/registry.ts +0 -55
  498. package/src/db/schema/sql.ts +0 -244
  499. package/src/db/schema/sqlOperations.ts +0 -63
  500. package/src/db/schema/types.ts +0 -1
  501. package/src/db/schemaGenerators.ts +0 -495
  502. package/src/db/schemaReadiness.ts +0 -34
  503. package/src/db/sqlMigrationExecution.spec.ts +0 -65
  504. package/src/db/sqlMigrationExecution.ts +0 -108
  505. package/src/db/types.spec.ts +0 -63
  506. package/src/handlerBundleRoutes.ts +0 -259
  507. package/src/handlerReleaseManagementRoutes.ts +0 -213
  508. package/src/schema/dsl-all-versions.spec.ts +0 -35
  509. package/src/schema/dsl.ts +0 -187
  510. package/src/schema/index.ts +0 -10
  511. package/src/schema/settings.ts +0 -15
  512. package/src/schema/types.ts +0 -79
  513. package/src/schema/v1_0_0.spec.ts +0 -220
  514. package/src/schema/v1_0_0.ts +0 -511
@@ -0,0 +1,61 @@
1
+ import path from "node:path";
2
+
3
+ import { setupReadBudgetTestSuite } from "@hot-updater/test-utils";
4
+ import {
5
+ assertDockerComposeAvailable,
6
+ findOpenPort,
7
+ } from "@hot-updater/test-utils/node";
8
+ import { execa } from "execa";
9
+ import { MongoClient } from "mongodb";
10
+ import { afterAll, beforeAll } from "vitest";
11
+
12
+ import { readBudgetServer } from "../readBudgets.testFixtures";
13
+ import { createMongoAdapter } from "./mongodbAdapter";
14
+
15
+ assertDockerComposeAvailable(
16
+ "MongoDB read-budget tests need Docker Compose and a running Docker daemon.",
17
+ );
18
+
19
+ const composeFile = path.resolve(
20
+ import.meta.dirname,
21
+ "../../../../examples-server/hono-mongodb/docker-compose.yml",
22
+ );
23
+ let environment: Record<string, string> | undefined;
24
+ const compose = (args: readonly string[]) =>
25
+ execa("docker", ["compose", "-f", composeFile, ...args], {
26
+ env: environment,
27
+ });
28
+
29
+ let client: MongoClient;
30
+
31
+ beforeAll(async () => {
32
+ const port = await findOpenPort();
33
+ environment = {
34
+ COMPOSE_PROJECT_NAME: `hot-updater-mongo-budgets-${process.pid}`,
35
+ HOT_UPDATER_E2E_MONGODB_PORT: String(port),
36
+ };
37
+ await compose(["up", "-d", "--wait"]);
38
+ client = new MongoClient(
39
+ `mongodb://127.0.0.1:${port}/budgets?replicaSet=rs0&directConnection=true`,
40
+ );
41
+ await client.connect();
42
+ }, 180_000);
43
+
44
+ afterAll(async () => {
45
+ await client?.close();
46
+ if (environment) await compose(["down", "-v", "--remove-orphans"]);
47
+ }, 60_000);
48
+
49
+ /**
50
+ * `mongoAdapter`'s composition without its schema fence: the MongoDB adapter
51
+ * on the replica set, reading in batches as small as the suite's pages.
52
+ */
53
+ setupReadBudgetTestSuite({
54
+ name: "mongodb (replica set)",
55
+ server: readBudgetServer,
56
+ createAdapter: async ({ tables, nativePageSize }) => {
57
+ const adapter = createMongoAdapter({ client, batchSize: nativePageSize });
58
+ await adapter.migrations!.apply(tables);
59
+ return { adapter };
60
+ },
61
+ });
@@ -1,132 +1,45 @@
1
- import { createDatabasePlugin } from "@hot-updater/plugin-core";
2
- import {
3
- createDatabasePluginAdapter,
4
- type DatabasePluginImplementation,
5
- type TransactionDatabasePluginImplementation,
6
- } from "@hot-updater/plugin-core/internal";
7
- import {
8
- MongoServerError,
9
- type ClientSession,
10
- type MongoClient,
11
- } from "mongodb";
1
+ import type { MongoClient } from "mongodb";
12
2
 
13
- import { createMongoMigrator } from "../db/fixedMigrator";
14
- import type { DatabaseAdapterWithCapabilities } from "../db/types";
15
- import { createMongoCollections } from "./mongodbCollections";
16
- import { createMongoReads } from "./mongodbReads";
17
- import { createMongoWrites } from "./mongodbWrites";
3
+ import { SETTINGS_TABLE } from "../database/fence";
4
+ import { builtInTarget, createEngineDatabase } from "../db/builtInDatabase";
5
+ import { createEngineMigrator } from "../db/engineMigrator";
6
+ import type { ToolingDatabase } from "../db/types";
7
+ import { createMongoAdapter } from "./mongodbAdapter";
18
8
 
9
+ export { MongoTransactionUnsupportedError } from "./mongodbAdapter";
10
+
11
+ /** Every write runs in a transaction, which needs a replica set or a sharded cluster. */
19
12
  export interface MongoDBConfig {
20
13
  readonly client: MongoClient;
21
- /** Enables atomic catalog commits. Insights always requires MongoDB 5+ on a replica set or sharded cluster. */
22
- readonly transactions?: boolean;
23
14
  }
24
15
 
25
- const createMongoImplementation = (
26
- client: MongoClient,
27
- session?: ClientSession,
28
- ): DatabasePluginImplementation => {
29
- const collections = createMongoCollections(client);
30
- return {
31
- recordInsights: async ({ event }) => {
32
- const record = () =>
33
- client.withSession((insightsSession) =>
34
- insightsSession.withTransaction(async () => {
35
- const insights = createMongoCollections(client);
36
- const options = {
37
- session: insightsSession,
38
- collation: { locale: "simple" },
39
- };
40
- const accepted = await insights.bundleEvents.updateOne(
41
- { id: event.id },
42
- { $setOnInsert: event },
43
- { ...options, upsert: true },
44
- );
45
- if (accepted.upsertedCount === 0) return;
46
- const current = await insights.bundleEventHeads.findOne(
47
- { install_id: event.install_id },
48
- options,
49
- );
50
- if (
51
- current !== null &&
52
- (event.received_at_ms < current.received_at_ms ||
53
- (event.received_at_ms === current.received_at_ms &&
54
- event.id <= current.id))
55
- )
56
- return;
57
- await insights.bundleEventHeads.updateOne(
58
- { install_id: event.install_id },
59
- {
60
- $set: {
61
- install_id: event.install_id,
62
- id: event.id,
63
- received_at_ms: event.received_at_ms,
64
- user_id: event.user_id,
65
- platform: event.platform,
66
- channel: event.channel,
67
- type: event.type,
68
- from_bundle_id: event.from_bundle_id,
69
- to_bundle_id: event.to_bundle_id,
70
- },
71
- },
72
- { ...options, upsert: true },
73
- );
74
- }),
75
- );
76
- try {
77
- await record();
78
- } catch (error) {
79
- if (!(error instanceof MongoServerError) || error.code !== 11000)
80
- throw error;
81
- await record();
82
- }
83
- },
84
- ...createMongoWrites(collections, session),
85
- ...createMongoReads(collections, session),
86
- };
16
+ /** Settings rows by their `key` field: the engine's rows and a v0 database's alike. */
17
+ const readSettings = (client: MongoClient) => async () => {
18
+ const rows = await client
19
+ .db()
20
+ .collection(SETTINGS_TABLE.name)
21
+ .find({ key: { $type: "string" } })
22
+ .toArray();
23
+ return new Map(rows.map((row) => [String(row.key), row.value]));
87
24
  };
88
25
 
89
- const createTransactionalMongoImplementation = (
90
- client: MongoClient,
91
- ): DatabasePluginImplementation => ({
92
- ...createMongoImplementation(client),
93
- deleteChannel: (input) =>
94
- client.withSession((session) =>
95
- session.withTransaction(() =>
96
- createMongoImplementation(client, session).deleteChannel(input),
97
- ),
98
- ),
99
- transaction: <TResult>(
100
- callback: (
101
- transaction: TransactionDatabasePluginImplementation,
102
- ) => Promise<TResult>,
103
- ): Promise<TResult> =>
104
- client.withSession((session) =>
105
- session.withTransaction(() =>
106
- callback(createMongoImplementation(client, session)),
107
- ),
108
- ),
109
- });
110
-
111
- export const mongoAdapter = (
112
- config: MongoDBConfig,
113
- ): DatabaseAdapterWithCapabilities => {
114
- const adapter = createDatabasePluginAdapter(
115
- "mongodb",
116
- config.transactions === true
117
- ? createTransactionalMongoImplementation(config.client)
118
- : createMongoImplementation(config.client),
119
- );
120
- return Object.assign(
121
- createDatabasePlugin({
122
- name: "mongodb",
123
- models: adapter.models,
124
- commit: adapter.commit,
125
- }),
126
- {
127
- adapterName: "mongodb",
128
- provider: "mongodb" as const,
129
- createMigrator: () => createMongoMigrator(config.client),
130
- },
131
- );
26
+ /**
27
+ * Hot Updater's database on MongoDB: the storage engine's MongoDB adapter,
28
+ * fenced by the schema settings. `db migrate` creates the collections and
29
+ * indexes, then writes the settings.
30
+ */
31
+ export const mongoAdapter = (config: MongoDBConfig): ToolingDatabase => {
32
+ const adapter = createMongoAdapter({ client: config.client });
33
+ return {
34
+ ...createEngineDatabase({ name: "mongodb", adapter }),
35
+ provider: "mongodb",
36
+ createMigrator: ({ schema, settings } = builtInTarget) =>
37
+ createEngineMigrator({
38
+ adapterName: "mongodb",
39
+ adapter,
40
+ schema,
41
+ settings,
42
+ readSettings: readSettings(config.client),
43
+ }),
44
+ };
132
45
  };
@@ -0,0 +1,293 @@
1
+ import {
2
+ type DatabaseAdapter,
3
+ type DatabaseKey,
4
+ type DatabaseKeyValue,
5
+ DATABASE_VERSION_COLUMN as V,
6
+ findPhysicalColumn,
7
+ findPhysicalIndex,
8
+ indexOrderColumns,
9
+ normalizeStoredRow,
10
+ type PhysicalIndex,
11
+ type PhysicalTable,
12
+ type QueryBound,
13
+ rowKey,
14
+ type StoredRow,
15
+ type WriteOp,
16
+ } from "@hot-updater/plugin-core/internal";
17
+ import {
18
+ type ClientSession,
19
+ type Document,
20
+ type Filter,
21
+ type IndexDescription,
22
+ MongoError,
23
+ type MongoClient,
24
+ } from "mongodb";
25
+
26
+ export interface MongoAdapterOptions {
27
+ readonly client: MongoClient;
28
+ /** Prepended to every collection name. */
29
+ readonly tablePrefix?: string;
30
+ /** The most ops one write accepts (default 1,000). */
31
+ readonly maxOps?: number;
32
+ /** Test-only: documents per native page. */
33
+ readonly batchSize?: number;
34
+ }
35
+
36
+ export class MongoTransactionUnsupportedError extends Error {
37
+ readonly name = "MongoTransactionUnsupportedError";
38
+ constructor(cause: unknown) {
39
+ super(
40
+ "Hot Updater writes in MongoDB transactions, which need a replica set or a sharded cluster.",
41
+ { cause },
42
+ );
43
+ }
44
+ }
45
+
46
+ type StoredId = DatabaseKeyValue | Readonly<Record<string, DatabaseKeyValue>>;
47
+
48
+ /** A single key column is the `_id`; a composite key is a document in key-column order. */
49
+ const idOf = (table: PhysicalTable, key: DatabaseKey): StoredId =>
50
+ table.key.length === 1
51
+ ? key[0]!
52
+ : Object.fromEntries(table.key.map((column, at) => [column, key[at]]));
53
+
54
+ /** A filter on `_id` (never an ObjectId), and on the version when given. */
55
+ const byId = (
56
+ _id: StoredId | { readonly $in: readonly StoredId[] },
57
+ v?: number,
58
+ ): Filter<Document> =>
59
+ (v === undefined ? { _id } : { _id, [V]: v }) as unknown as Filter<Document>;
60
+
61
+ /** Null columns are left out, so unique indexes skip them as SQL's do. */
62
+ const toDocument = (table: PhysicalTable, row: StoredRow): Document => ({
63
+ _id: idOf(table, rowKey(table, row)),
64
+ ...Object.fromEntries(
65
+ table.columns.flatMap(({ name }) =>
66
+ row[name] === null || row[name] === undefined ? [] : [[name, row[name]]],
67
+ ),
68
+ ),
69
+ });
70
+
71
+ /** `columns op bound` over a tuple prefix, expanded into ORs. */
72
+ const compare = (
73
+ columns: readonly string[],
74
+ { values, inclusive }: QueryBound,
75
+ op: "$gt" | "$lt",
76
+ ): Document => {
77
+ const terms = values.map((value, position) => ({
78
+ ...Object.fromEntries(
79
+ columns.slice(0, position).map((column, at) => [column, values[at]]),
80
+ ),
81
+ [columns[position]!]: {
82
+ [position === values.length - 1 && inclusive ? `${op}e` : op]: value,
83
+ },
84
+ }));
85
+ return terms.length === 1 ? terms[0]! : { $or: terms };
86
+ };
87
+
88
+ const indexDescription = (
89
+ table: PhysicalTable,
90
+ index: PhysicalIndex,
91
+ ): IndexDescription => {
92
+ const columns = index.unique
93
+ ? index.eq
94
+ : [...index.eq, ...indexOrderColumns(table, index)];
95
+ const exists = columns
96
+ .filter((column) => findPhysicalColumn(table, column).nullable)
97
+ .map((column) => [column, { $exists: true }]);
98
+ return {
99
+ name: index.name,
100
+ key: Object.fromEntries(columns.map((column) => [column, 1])),
101
+ ...(index.unique && { unique: true }),
102
+ ...(index.unique &&
103
+ exists.length > 0 && {
104
+ partialFilterExpression: Object.fromEntries(exists),
105
+ }),
106
+ };
107
+ };
108
+
109
+ const mongoError = (error: unknown) =>
110
+ error instanceof MongoError ? error : undefined;
111
+
112
+ /**
113
+ * The storage engine's adapter over MongoDB: one collection per table, the
114
+ * key as `_id`, and indexes as declared, with multi-valued fields as multikey
115
+ * indexes. A write runs in one transaction. Guards are conditional updates,
116
+ * and `check` is a conditional `$inc`: a real write, so a concurrent
117
+ * transaction on the document conflicts.
118
+ */
119
+ export const createMongoAdapter = (
120
+ options: MongoAdapterOptions,
121
+ ): DatabaseAdapter => {
122
+ const { client, tablePrefix = "", maxOps = 1000 } = options;
123
+ const collection = (table: PhysicalTable) =>
124
+ client.db().collection(tablePrefix + table.name);
125
+ const normalize = (table: PhysicalTable, document: Document) =>
126
+ normalizeStoredRow(table, document, { jsonText: false });
127
+
128
+ /** Whether the op applied; a guard that no longer matches changes nothing. */
129
+ const apply = async (op: WriteOp, session: ClientSession) => {
130
+ const target = collection(op.table);
131
+ if (op.type === "insert") {
132
+ await target.insertOne(toDocument(op.table, op.row), { session });
133
+ return true;
134
+ }
135
+ const _id = idOf(op.table, op.key);
136
+ const update = async (filter: Filter<Document>, change: Document) =>
137
+ (await target.updateOne(filter, change, { session })).matchedCount === 1;
138
+ switch (op.type) {
139
+ case "patch": {
140
+ const $set: Document = { [V]: op.guard.v + 1 };
141
+ const $unset: Document = {};
142
+ for (const [name, value] of Object.entries(op.set)) {
143
+ if (value === null) $unset[name] = "";
144
+ else $set[name] = value;
145
+ }
146
+ return update(byId(_id, op.guard.v), { $set, $unset });
147
+ }
148
+ case "delete":
149
+ return (
150
+ (await target.deleteOne(byId(_id, op.guard.v), { session }))
151
+ .deletedCount === 1
152
+ );
153
+ case "check":
154
+ // Written, never read: a concurrent transaction on the document conflicts.
155
+ return update(byId(_id, op.guard.v), { $inc: { _checked: 1 } });
156
+ case "increment": {
157
+ if (op.init === undefined || op.guard !== undefined) {
158
+ return update(byId(_id, op.guard?.v), {
159
+ $inc: { ...op.by, [V]: 1 },
160
+ });
161
+ }
162
+ // Creates the row from `init` when it is missing, in one upsert.
163
+ const set: Document = {};
164
+ for (const { name } of op.table.columns) {
165
+ const start = op.init[name] ?? null;
166
+ const by = name === V ? 1 : op.by[name];
167
+ const stored = { $ifNull: [`$${name}`, { $literal: start ?? 0 }] };
168
+ if (by !== undefined) set[name] = { $add: [stored, by] };
169
+ else if (start !== null) set[name] = stored;
170
+ }
171
+ await target.updateOne(byId(_id), [{ $set: set }], {
172
+ upsert: true,
173
+ session,
174
+ });
175
+ return true;
176
+ }
177
+ }
178
+ };
179
+
180
+ return {
181
+ id: "mongodb",
182
+ fits: (ops) => ops.length <= maxOps,
183
+
184
+ async get(table, keys) {
185
+ if (keys.length === 0) return [];
186
+ const ids = keys.map((key) => idOf(table, key));
187
+ const documents = await collection(table)
188
+ .find(byId({ $in: ids }))
189
+ .toArray();
190
+ const found = new Map(
191
+ documents.map((document) => [JSON.stringify(document._id), document]),
192
+ );
193
+ return ids.map((id) => {
194
+ const document = found.get(JSON.stringify(id));
195
+ return document === undefined ? null : normalize(table, document);
196
+ });
197
+ },
198
+
199
+ async query(table, request) {
200
+ const index = findPhysicalIndex(table, request.index);
201
+ const columns = indexOrderColumns(table, index);
202
+ const bounds = [
203
+ ...(request.lower ? [compare(columns, request.lower, "$gt")] : []),
204
+ ...(request.upper ? [compare(columns, request.upper, "$lt")] : []),
205
+ ];
206
+ const direction = request.order === "asc" ? 1 : -1;
207
+ const documents = await collection(table)
208
+ .find(
209
+ {
210
+ ...Object.fromEntries(
211
+ index.eq.map((column, at) => [column, request.eq[at]]),
212
+ ),
213
+ ...(bounds.length > 0 && { $and: bounds }),
214
+ },
215
+ {
216
+ sort: Object.fromEntries(
217
+ columns.map((column) => [column, direction]),
218
+ ),
219
+ limit: request.limit,
220
+ ...(options.batchSize && { batchSize: options.batchSize }),
221
+ },
222
+ )
223
+ .toArray();
224
+ return documents.map((document) => normalize(table, document));
225
+ },
226
+
227
+ async write(ops) {
228
+ const session = client.startSession();
229
+ let position = 0;
230
+ try {
231
+ session.startTransaction({
232
+ readConcern: { level: "snapshot" },
233
+ writeConcern: { w: "majority" },
234
+ });
235
+ for (; position < ops.length; position += 1) {
236
+ if (!(await apply(ops[position]!, session))) {
237
+ await session.abortTransaction();
238
+ return { ok: false, failedOp: position };
239
+ }
240
+ }
241
+ // Committing again is safe when the outcome is unknown.
242
+ await session.commitTransaction().catch(async (error: unknown) => {
243
+ const unknown = mongoError(error)?.hasErrorLabel(
244
+ "UnknownTransactionCommitResult",
245
+ );
246
+ if (!unknown) throw error;
247
+ await session.commitTransaction();
248
+ });
249
+ return { ok: true };
250
+ } catch (error) {
251
+ if (session.inTransaction()) {
252
+ await session.abortTransaction().catch(() => undefined);
253
+ }
254
+ const failure = mongoError(error);
255
+ if (
256
+ failure?.hasErrorLabel("TransientTransactionError") ||
257
+ failure?.code === 112
258
+ ) {
259
+ return { ok: false, retry: true };
260
+ }
261
+ if (failure?.code === 11000 && position < ops.length) {
262
+ // Two upserts creating one key race; the loser runs again.
263
+ return ops[position]!.type === "increment"
264
+ ? { ok: false, retry: true }
265
+ : { ok: false, failedOp: position };
266
+ }
267
+ throw failure?.code === 20
268
+ ? new MongoTransactionUnsupportedError(error)
269
+ : error;
270
+ } finally {
271
+ await session.endSession();
272
+ }
273
+ },
274
+
275
+ migrations: {
276
+ async apply(tables) {
277
+ for (const table of tables) {
278
+ // An existing collection keeps its documents; its indexes are ensured.
279
+ await client
280
+ .db()
281
+ .createCollection(tablePrefix + table.name)
282
+ .catch((error: unknown) => {
283
+ if (mongoError(error)?.code !== 48) throw error;
284
+ });
285
+ if (table.indexes.length === 0) continue;
286
+ await collection(table).createIndexes(
287
+ table.indexes.map((index) => indexDescription(table, index)),
288
+ );
289
+ }
290
+ },
291
+ },
292
+ };
293
+ };
@@ -0,0 +1,36 @@
1
+ import { PGlite } from "@electric-sql/pglite";
2
+ import { setupDatabaseAdapterConformanceSuite } from "@hot-updater/test-utils";
3
+
4
+ import { SETTINGS_TABLE } from "../database/fence";
5
+ import { createTableStatements } from "../database/sql/sqlSchema";
6
+ import { builtInSettings } from "../db/builtInDatabase";
7
+ import { settingsStatements } from "../db/engineSql";
8
+ import { prismaAdapter } from "./prisma";
9
+ import { pglitePrisma } from "./prismaTestClients";
10
+
11
+ /**
12
+ * The adapter `prismaAdapter` returns, schema fence included, over Prisma's
13
+ * raw query API on a new PGlite per test. Prisma has no models for the
14
+ * conformance tables, so the SQL core's DDL creates them, beside the settings
15
+ * rows the fence checks. PostgreSQL has no cap on one write and no native
16
+ * pages.
17
+ */
18
+ setupDatabaseAdapterConformanceSuite({
19
+ name: "prisma (PGlite)",
20
+ createAdapter: async ({ tables }) => {
21
+ const client = new PGlite();
22
+ await client.exec(
23
+ [
24
+ ...createTableStatements("postgresql", [...tables, SETTINGS_TABLE]),
25
+ ...settingsStatements("postgresql", builtInSettings),
26
+ ].join(";\n"),
27
+ );
28
+ return {
29
+ adapter: prismaAdapter({
30
+ prisma: pglitePrisma(client),
31
+ provider: "postgresql",
32
+ }).adapter,
33
+ cleanup: () => client.close(),
34
+ };
35
+ },
36
+ });
@@ -0,0 +1,138 @@
1
+ import path from "node:path";
2
+ import { fileURLToPath } from "node:url";
3
+
4
+ import {
5
+ setupDatabaseTestSuite,
6
+ startHttpTestServer,
7
+ } from "@hot-updater/test-utils";
8
+ import { assertDockerComposeAvailable } from "@hot-updater/test-utils/node";
9
+ import { execa } from "execa";
10
+ import mysql from "mysql2/promise";
11
+ import { afterAll, beforeAll, describe, expect, it } from "vitest";
12
+
13
+ import { createDatabasePluginApis } from "../assembly/databasePlugins";
14
+ import { isMultiIndex, quoteSql } from "../database/sql/sqlSchema";
15
+ import { builtInSchema } from "../db/builtInDatabase";
16
+ import { createHotUpdater } from "../index";
17
+ import { createInsightsModel, insights } from "../plugins/insights";
18
+ import { prismaAdapter } from "./prisma";
19
+ import { mysqlPrisma, prismaPushSql } from "./prismaTestClients";
20
+
21
+ assertDockerComposeAvailable(
22
+ "Prisma's MySQL integration tests need Docker Compose and a running Docker daemon.",
23
+ );
24
+
25
+ const compose = [
26
+ "compose",
27
+ "-f",
28
+ path.join(
29
+ path.dirname(fileURLToPath(import.meta.url)),
30
+ "../database/sql/docker-compose.yml",
31
+ ),
32
+ "-p",
33
+ "hot-updater-sql-core",
34
+ ];
35
+ const server = "mysql://root:hot_updater@127.0.0.1:53306";
36
+ const database = `prisma_${process.pid}`;
37
+
38
+ const dataTables = builtInSchema.tables.flatMap((table) => [
39
+ table.name,
40
+ ...table.indexes
41
+ .filter((index) => isMultiIndex(table, index))
42
+ .map((index) => `${table.name}__${index.name}`),
43
+ ]);
44
+
45
+ let admin: mysql.Pool;
46
+ let pool: mysql.Pool;
47
+
48
+ /**
49
+ * MySQL has no Prisma example, so the tables come from Prisma's own DDL for
50
+ * the generated models, as `prisma db push` would run it, and the adapter
51
+ * runs over mysql2 through Prisma's raw query API.
52
+ */
53
+ beforeAll(async () => {
54
+ await execa("docker", [...compose, "up", "-d", "--wait", "mysql"]);
55
+ admin = mysql.createPool({ uri: server, multipleStatements: true });
56
+ for (let attempt = 0; ; attempt += 1) {
57
+ try {
58
+ await admin.query("SELECT 1");
59
+ break;
60
+ } catch (error) {
61
+ if (attempt > 60) throw error;
62
+ await new Promise((resolve) => setTimeout(resolve, 1000));
63
+ }
64
+ }
65
+ await admin.query(
66
+ `DROP DATABASE IF EXISTS ${database}; CREATE DATABASE ${database}`,
67
+ );
68
+ await admin.query(`USE ${database}; ${await prismaPushSql("mysql")}`);
69
+ pool = mysql.createPool({
70
+ uri: `${server}/${database}`,
71
+ connectionLimit: 16,
72
+ });
73
+ const migrator = prismaAdapter({
74
+ prisma: mysqlPrisma(pool),
75
+ provider: "mysql",
76
+ }).createMigrator!();
77
+ await (await migrator.migrateToLatest()).execute();
78
+ }, 180_000);
79
+
80
+ afterAll(async () => {
81
+ await pool?.end();
82
+ await admin?.query(`DROP DATABASE IF EXISTS ${database}`);
83
+ await admin?.end();
84
+ await execa("docker", [...compose, "down", "-v"]);
85
+ }, 60_000);
86
+
87
+ setupDatabaseTestSuite({
88
+ createHttpClient: (options) =>
89
+ startHttpTestServer(
90
+ createHotUpdater({
91
+ ...options,
92
+ plugins: [insights()],
93
+ clientAccess: "public",
94
+ }).handlers,
95
+ ),
96
+ createInsightsModel: (database) =>
97
+ createInsightsModel(
98
+ createDatabasePluginApis(database, [insights()]).insights,
99
+ ),
100
+ name: "prismaAdapter (MySQL, Prisma's tables)",
101
+ migrate: () => undefined,
102
+ createDatabase: () =>
103
+ prismaAdapter({ prisma: mysqlPrisma(pool), provider: "mysql" }),
104
+ reset: async () => {
105
+ for (const table of dataTables) {
106
+ await pool.query(`DELETE FROM ${quoteSql("mysql", table)}`);
107
+ }
108
+ },
109
+ dispose: () => undefined,
110
+ });
111
+
112
+ describe("prismaAdapter on Prisma's MySQL tables", () => {
113
+ it("keeps ASCII keys binary and sets binary UTF-8 collations after Prisma", async () => {
114
+ const [columns] = await pool.query(
115
+ "SELECT TABLE_NAME AS name, COLUMN_NAME AS col, DATA_TYPE AS type, COLLATION_NAME AS collation FROM information_schema.COLUMNS WHERE TABLE_SCHEMA = DATABASE() AND ((TABLE_NAME = 'releases' AND COLUMN_NAME IN ('scope_key', 'channel_id')) OR (TABLE_NAME = 'channels' AND COLUMN_NAME = 'name')) ORDER BY TABLE_NAME, COLUMN_NAME",
116
+ );
117
+ expect(columns).toEqual([
118
+ {
119
+ name: "channels",
120
+ col: "name",
121
+ type: "varchar",
122
+ collation: "utf8mb4_0900_bin",
123
+ },
124
+ {
125
+ name: "releases",
126
+ col: "channel_id",
127
+ type: "varbinary",
128
+ collation: null,
129
+ },
130
+ {
131
+ name: "releases",
132
+ col: "scope_key",
133
+ type: "varbinary",
134
+ collation: null,
135
+ },
136
+ ]);
137
+ });
138
+ });