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

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 (519) 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 -10
  152. package/dist/db/index.d.cts +10 -4
  153. package/dist/db/index.d.mts +10 -4
  154. package/dist/db/index.mjs +16 -9
  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/diff.cjs +3 -0
  172. package/dist/diff.d.cts +2 -0
  173. package/dist/diff.d.mts +2 -0
  174. package/dist/diff.mjs +2 -0
  175. package/dist/handler.cjs +72 -43
  176. package/dist/handler.d.cts +3 -5
  177. package/dist/handler.d.mts +3 -5
  178. package/dist/handler.mjs +73 -43
  179. package/dist/handlerAdminRoutes.cjs +375 -0
  180. package/dist/handlerAdminRoutes.mjs +373 -0
  181. package/dist/handlerParameters.cjs +6 -11
  182. package/dist/handlerParameters.mjs +6 -10
  183. package/dist/handlerReleaseCatalogRoutes.cjs +11 -13
  184. package/dist/handlerReleaseCatalogRoutes.mjs +11 -13
  185. package/dist/handlerTypes.d.cts +2 -55
  186. package/dist/handlerTypes.d.mts +2 -55
  187. package/dist/handlerVersionRoutes.cjs +20 -4
  188. package/dist/handlerVersionRoutes.mjs +20 -4
  189. package/dist/index.cjs +4 -7
  190. package/dist/index.d.cts +8 -7
  191. package/dist/index.d.mts +8 -7
  192. package/dist/index.mjs +4 -4
  193. package/dist/insights/domain.d.cts +12 -0
  194. package/dist/insights/domain.d.mts +12 -0
  195. package/dist/insights/errors.cjs +34 -0
  196. package/dist/insights/errors.mjs +34 -1
  197. package/dist/insights/eventInput.cjs +14 -19
  198. package/dist/insights/eventInput.mjs +15 -20
  199. package/dist/insights/provider.cjs +47 -23
  200. package/dist/insights/provider.mjs +47 -24
  201. package/dist/insights/routes.cjs +79 -14
  202. package/dist/insights/routes.mjs +77 -14
  203. package/dist/node.d.cts +1 -1
  204. package/dist/node.d.mts +1 -1
  205. package/dist/package.cjs +1 -1
  206. package/dist/package.mjs +1 -1
  207. package/dist/plugins/api-keys/index.cjs +50 -0
  208. package/dist/plugins/api-keys/index.d.cts +85 -0
  209. package/dist/plugins/api-keys/index.d.mts +85 -0
  210. package/dist/plugins/api-keys/index.mjs +47 -0
  211. package/dist/plugins/api-keys/model.cjs +58 -0
  212. package/dist/plugins/api-keys/model.d.cts +8 -0
  213. package/dist/plugins/api-keys/model.d.mts +8 -0
  214. package/dist/plugins/api-keys/model.mjs +58 -0
  215. package/dist/plugins/api-keys/schema.cjs +38 -0
  216. package/dist/plugins/api-keys/schema.d.cts +44 -0
  217. package/dist/plugins/api-keys/schema.d.mts +44 -0
  218. package/dist/plugins/api-keys/schema.mjs +39 -0
  219. package/dist/plugins/builtIn.cjs +7 -0
  220. package/dist/plugins/builtIn.mjs +6 -0
  221. package/dist/plugins/definePlugin.cjs +5 -0
  222. package/dist/plugins/definePlugin.d.cts +73 -0
  223. package/dist/plugins/definePlugin.d.mts +73 -0
  224. package/dist/plugins/definePlugin.mjs +5 -0
  225. package/dist/plugins/index.cjs +17 -0
  226. package/dist/plugins/index.d.cts +9 -0
  227. package/dist/plugins/index.d.mts +9 -0
  228. package/dist/plugins/index.mjs +7 -0
  229. package/dist/plugins/insights/index.cjs +48 -0
  230. package/dist/plugins/insights/index.d.cts +295 -0
  231. package/dist/plugins/insights/index.d.mts +295 -0
  232. package/dist/plugins/insights/index.mjs +44 -0
  233. package/dist/plugins/insights/model.cjs +17 -0
  234. package/dist/plugins/insights/model.d.cts +10 -0
  235. package/dist/plugins/insights/model.d.mts +10 -0
  236. package/dist/plugins/insights/model.mjs +17 -0
  237. package/dist/plugins/insights/reads.cjs +471 -0
  238. package/dist/plugins/insights/reads.mjs +466 -0
  239. package/dist/plugins/insights/recordEvent.cjs +135 -0
  240. package/dist/plugins/insights/recordEvent.d.cts +13 -0
  241. package/dist/plugins/insights/recordEvent.d.mts +13 -0
  242. package/dist/plugins/insights/recordEvent.mjs +132 -0
  243. package/dist/plugins/insights/schema.cjs +347 -0
  244. package/dist/plugins/insights/schema.d.cts +258 -0
  245. package/dist/plugins/insights/schema.d.mts +258 -0
  246. package/dist/plugins/insights/schema.mjs +344 -0
  247. package/dist/types/index.d.cts +2 -28
  248. package/dist/types/index.d.mts +2 -28
  249. package/package.json +32 -5
  250. package/src/adapters/drizzle.conformance.integration.spec.ts +34 -0
  251. package/src/adapters/drizzle.readBudgets.integration.spec.ts +41 -0
  252. package/src/adapters/drizzle.spec.ts +270 -399
  253. package/src/adapters/drizzle.ts +48 -140
  254. package/src/adapters/drizzleExecutor.ts +166 -0
  255. package/src/adapters/kysely.conformance.integration.spec.ts +36 -0
  256. package/src/adapters/kysely.readBudgets.integration.spec.ts +42 -0
  257. package/src/adapters/kysely.spec.ts +204 -171
  258. package/src/adapters/kysely.ts +32 -93
  259. package/src/adapters/kyselyExecutor.ts +53 -0
  260. package/src/adapters/mongodb.integration.spec.ts +143 -446
  261. package/src/adapters/mongodb.readBudgets.integration.spec.ts +61 -0
  262. package/src/adapters/mongodb.ts +36 -123
  263. package/src/adapters/mongodbAdapter.ts +293 -0
  264. package/src/adapters/prisma.conformance.integration.spec.ts +36 -0
  265. package/src/adapters/prisma.integration.spec.ts +138 -0
  266. package/src/adapters/prisma.readBudgets.integration.spec.ts +40 -0
  267. package/src/adapters/prisma.spec.ts +216 -433
  268. package/src/adapters/prisma.ts +60 -524
  269. package/src/adapters/prismaExecutor.ts +107 -0
  270. package/src/adapters/prismaTestClients.ts +175 -0
  271. package/src/adapters/sqlProviders.ts +14 -0
  272. package/src/apiKeys.integration.spec.ts +19 -119
  273. package/src/apiKeys.spec.ts +39 -35
  274. package/src/apiKeys.ts +2 -8
  275. package/src/assembly/assemblePlugins.ts +269 -0
  276. package/src/assembly/assembly.spec.ts +325 -0
  277. package/src/assembly/assembly.types.spec.ts +155 -0
  278. package/src/assembly/builtInRoutes.spec.ts +213 -0
  279. package/src/assembly/databasePlugins.spec.ts +71 -0
  280. package/src/assembly/databasePlugins.ts +96 -0
  281. package/src/core/api.ts +139 -0
  282. package/src/core/baseCandidates.spec.ts +378 -0
  283. package/src/core/baseCandidates.ts +136 -0
  284. package/src/core/index.ts +44 -0
  285. package/src/core/operations.spec.ts +415 -0
  286. package/src/core/operations.ts +551 -0
  287. package/src/core/reads.spec.ts +300 -0
  288. package/src/core/reads.ts +417 -0
  289. package/src/core/releases.spec.ts +308 -0
  290. package/src/core/releases.ts +345 -0
  291. package/src/core/schema.ts +173 -0
  292. package/src/core/writes.ts +160 -0
  293. package/src/createHotUpdaterCore.ts +191 -181
  294. package/src/database/cursor.ts +65 -0
  295. package/src/database/database.ts +335 -0
  296. package/src/database/database.types.spec.ts +135 -0
  297. package/src/database/definitions.ts +72 -0
  298. package/src/database/engine.ts +62 -0
  299. package/src/database/engineAggregates.spec.ts +539 -0
  300. package/src/database/engineAggregates.ts +193 -0
  301. package/src/database/engineReads.spec.ts +219 -0
  302. package/src/database/engineReads.ts +302 -0
  303. package/src/database/engineTransaction.spec.ts +710 -0
  304. package/src/database/engineTransaction.ts +588 -0
  305. package/src/database/errors.ts +30 -0
  306. package/src/database/fence.spec.ts +223 -0
  307. package/src/database/fence.ts +171 -0
  308. package/src/database/index.ts +154 -0
  309. package/src/database/kv/kvAdapter.conformance.integration.spec.ts +17 -0
  310. package/src/database/kv/kvAdapter.readBudgets.integration.spec.ts +17 -0
  311. package/src/database/kv/kvAdapter.spec.ts +468 -0
  312. package/src/database/kv/kvAdapter.ts +450 -0
  313. package/src/database/kv/kvTestStore.ts +91 -0
  314. package/src/database/memory.readBudgets.integration.spec.ts +13 -0
  315. package/src/database/resolveSchema.spec.ts +230 -0
  316. package/src/database/resolveSchema.ts +372 -0
  317. package/src/database/schema.ts +169 -0
  318. package/src/database/schema.types.spec.ts +94 -0
  319. package/src/database/sql/docker-compose.yml +36 -0
  320. package/src/database/sql/sqlAdapter.integration.spec.ts +148 -0
  321. package/src/database/sql/sqlAdapter.readBudgets.integration.spec.ts +109 -0
  322. package/src/database/sql/sqlAdapter.spec.ts +255 -0
  323. package/src/database/sql/sqlAdapter.ts +532 -0
  324. package/src/database/sql/sqlSchema.ts +205 -0
  325. package/src/database/sql/sqlTestExecutors.ts +183 -0
  326. package/src/databaseTestSuite.spec.ts +39 -0
  327. package/src/db/builtInDatabase.ts +149 -0
  328. package/src/db/bundleRows.spec.ts +3 -3
  329. package/src/db/createBundleDiff.spec.ts +43 -29
  330. package/src/db/createBundleDiff.ts +13 -7
  331. package/src/db/engineDrizzleSchema.ts +72 -0
  332. package/src/db/engineMigrator.ts +105 -0
  333. package/src/db/enginePrismaSchema.ts +147 -0
  334. package/src/db/engineSql.spec.ts +129 -0
  335. package/src/db/engineSql.ts +48 -0
  336. package/src/db/engineSqlMigrator.ts +116 -0
  337. package/src/db/fixedMigratorShared.ts +1 -20
  338. package/src/db/index.spec.ts +116 -829
  339. package/src/db/index.ts +43 -15
  340. package/src/db/pluginTables.spec.ts +218 -0
  341. package/src/db/releaseCatalog.ts +48 -90
  342. package/src/db/schemaSettings.ts +104 -0
  343. package/src/db/settingsMigrator.spec.ts +65 -0
  344. package/src/db/settingsMigrator.ts +152 -0
  345. package/src/db/types.ts +25 -171
  346. package/src/db/updateArtifacts.spec.ts +170 -294
  347. package/src/db/updateArtifacts.ts +74 -142
  348. package/src/db/updateCheck.bench.ts +47 -0
  349. package/src/diff.ts +6 -0
  350. package/src/handler-standalone.integration.spec.ts +204 -410
  351. package/src/handler.spec.ts +134 -51
  352. package/src/handler.testFixtures.ts +14 -19
  353. package/src/handler.ts +163 -75
  354. package/src/handlerAdminRoutes.spec.ts +183 -0
  355. package/src/handlerAdminRoutes.ts +536 -0
  356. package/src/handlerAuth.integration.spec.ts +3 -3
  357. package/src/handlerManagement.spec.ts +136 -196
  358. package/src/handlerReleaseCatalogRoutes.ts +15 -17
  359. package/src/handlerTypes.ts +3 -80
  360. package/src/handlerVersionRoutes.ts +20 -7
  361. package/src/index.ts +5 -12
  362. package/src/insights/domain.ts +12 -0
  363. package/src/insights/errors.spec.ts +48 -0
  364. package/src/insights/errors.ts +51 -0
  365. package/src/insights/eventInput.ts +27 -24
  366. package/src/insights/insights.integration.spec.ts +228 -78
  367. package/src/insights/provider.spec.ts +203 -25
  368. package/src/insights/provider.ts +88 -32
  369. package/src/insights/routes.ts +95 -20
  370. package/src/lintRules.spec.ts +76 -0
  371. package/src/plugins/api-keys/apiKeysPlugin.spec.ts +172 -0
  372. package/src/plugins/api-keys/index.ts +66 -0
  373. package/src/plugins/api-keys/model.ts +69 -0
  374. package/src/plugins/api-keys/schema.ts +22 -0
  375. package/src/plugins/builtIn.ts +5 -0
  376. package/src/plugins/definePlugin.ts +100 -0
  377. package/src/plugins/index.ts +55 -0
  378. package/src/plugins/insights/index.ts +86 -0
  379. package/src/plugins/insights/insightsRollout.integration.spec.ts +187 -0
  380. package/src/plugins/insights/model.spec.ts +66 -0
  381. package/src/plugins/insights/model.ts +19 -0
  382. package/src/plugins/insights/reads.spec.ts +725 -0
  383. package/src/plugins/insights/reads.ts +707 -0
  384. package/src/plugins/insights/recordEvent.spec.ts +443 -0
  385. package/src/plugins/insights/recordEvent.ts +238 -0
  386. package/src/plugins/insights/schema.ts +229 -0
  387. package/src/plugins/pluginTestHarness.spec.ts +56 -0
  388. package/src/readBudgets.testFixtures.ts +15 -0
  389. package/src/releaseCatalogRoutes.integration.spec.ts +47 -92
  390. package/src/runtime.spec.ts +91 -77
  391. package/src/runtime.testFixtures.ts +28 -44
  392. package/src/runtimeBundles.integration.spec.ts +112 -0
  393. package/src/testUtilsMutation.integration.spec.ts +215 -0
  394. package/src/testUtilsPackage.integration.spec.ts +176 -0
  395. package/src/types/index.ts +0 -32
  396. package/dist/adapters/databaseConstraintErrors.cjs +0 -22
  397. package/dist/adapters/databaseConstraintErrors.mjs +0 -21
  398. package/dist/adapters/databasePluginUtils.cjs +0 -130
  399. package/dist/adapters/databasePluginUtils.mjs +0 -118
  400. package/dist/adapters/drizzleCrud.cjs +0 -340
  401. package/dist/adapters/drizzleCrud.mjs +0 -337
  402. package/dist/adapters/drizzleLazyDB.cjs +0 -103
  403. package/dist/adapters/drizzleLazyDB.mjs +0 -103
  404. package/dist/adapters/drizzleQuery.cjs +0 -69
  405. package/dist/adapters/drizzleQuery.mjs +0 -69
  406. package/dist/adapters/kyselyCrud.cjs +0 -293
  407. package/dist/adapters/kyselyCrud.mjs +0 -292
  408. package/dist/adapters/kyselyQuery.cjs +0 -56
  409. package/dist/adapters/kyselyQuery.mjs +0 -56
  410. package/dist/adapters/mongodbCollections.cjs +0 -38
  411. package/dist/adapters/mongodbCollections.mjs +0 -32
  412. package/dist/adapters/mongodbQuery.cjs +0 -90
  413. package/dist/adapters/mongodbQuery.mjs +0 -83
  414. package/dist/adapters/mongodbReads.cjs +0 -206
  415. package/dist/adapters/mongodbReads.mjs +0 -206
  416. package/dist/adapters/mongodbWrites.cjs +0 -133
  417. package/dist/adapters/mongodbWrites.mjs +0 -133
  418. package/dist/adapters/prismaInsights.cjs +0 -99
  419. package/dist/adapters/prismaInsights.mjs +0 -97
  420. package/dist/adapters/prismaQuery.cjs +0 -57
  421. package/dist/adapters/prismaQuery.mjs +0 -56
  422. package/dist/adapters/prismaRows.cjs +0 -197
  423. package/dist/adapters/prismaRows.mjs +0 -188
  424. package/dist/db/databasePluginCore.cjs +0 -137
  425. package/dist/db/databasePluginCore.mjs +0 -137
  426. package/dist/db/fixedMigrator.cjs +0 -79
  427. package/dist/db/fixedMigrator.mjs +0 -78
  428. package/dist/db/fixedMigratorMongo.cjs +0 -321
  429. package/dist/db/fixedMigratorMongo.mjs +0 -321
  430. package/dist/db/mongoMigrationExecution.cjs +0 -11
  431. package/dist/db/mongoMigrationExecution.mjs +0 -11
  432. package/dist/db/schema/insightsCollation.cjs +0 -14
  433. package/dist/db/schema/insightsCollation.mjs +0 -14
  434. package/dist/db/schema/mongodb.cjs +0 -25
  435. package/dist/db/schema/mongodb.mjs +0 -25
  436. package/dist/db/schema/registry.cjs +0 -21
  437. package/dist/db/schema/registry.mjs +0 -17
  438. package/dist/db/schema/sql.cjs +0 -105
  439. package/dist/db/schema/sql.mjs +0 -97
  440. package/dist/db/schema/sqlOperations.cjs +0 -27
  441. package/dist/db/schema/sqlOperations.mjs +0 -26
  442. package/dist/db/schemaGenerators.cjs +0 -276
  443. package/dist/db/schemaGenerators.mjs +0 -274
  444. package/dist/db/schemaReadiness.cjs +0 -26
  445. package/dist/db/schemaReadiness.d.cts +0 -9
  446. package/dist/db/schemaReadiness.d.mts +0 -9
  447. package/dist/db/schemaReadiness.mjs +0 -25
  448. package/dist/db/sqlMigrationExecution.cjs +0 -67
  449. package/dist/db/sqlMigrationExecution.mjs +0 -67
  450. package/dist/handlerBundleRoutes.cjs +0 -155
  451. package/dist/handlerBundleRoutes.mjs +0 -155
  452. package/dist/handlerReleaseManagementRoutes.cjs +0 -124
  453. package/dist/handlerReleaseManagementRoutes.mjs +0 -124
  454. package/dist/schema/dsl.cjs +0 -103
  455. package/dist/schema/dsl.mjs +0 -87
  456. package/dist/schema/index.cjs +0 -20
  457. package/dist/schema/index.mjs +0 -7
  458. package/dist/schema/settings.cjs +0 -9
  459. package/dist/schema/settings.mjs +0 -9
  460. package/dist/schema/types.cjs +0 -8
  461. package/dist/schema/types.mjs +0 -6
  462. package/dist/schema/v1_0_0.cjs +0 -393
  463. package/dist/schema/v1_0_0.mjs +0 -385
  464. package/src/adapters/databaseConstraintErrors.ts +0 -25
  465. package/src/adapters/databasePluginTestDatabase.ts +0 -116
  466. package/src/adapters/databasePluginUtils.spec.ts +0 -29
  467. package/src/adapters/databasePluginUtils.ts +0 -238
  468. package/src/adapters/drizzleCrud.ts +0 -610
  469. package/src/adapters/drizzleLazyDB.ts +0 -284
  470. package/src/adapters/drizzleQuery.ts +0 -164
  471. package/src/adapters/kyselyCrud.ts +0 -696
  472. package/src/adapters/kyselyInsights.spec.ts +0 -168
  473. package/src/adapters/kyselyQuery.ts +0 -128
  474. package/src/adapters/mongodb.spec.ts +0 -230
  475. package/src/adapters/mongodbCollections.ts +0 -78
  476. package/src/adapters/mongodbQuery.ts +0 -245
  477. package/src/adapters/mongodbReads.ts +0 -387
  478. package/src/adapters/mongodbRows.spec.ts +0 -64
  479. package/src/adapters/mongodbRows.ts +0 -118
  480. package/src/adapters/mongodbTestClient.ts +0 -443
  481. package/src/adapters/mongodbTestFilter.ts +0 -170
  482. package/src/adapters/mongodbWrites.ts +0 -261
  483. package/src/adapters/prismaInsights.ts +0 -190
  484. package/src/adapters/prismaQuery.ts +0 -129
  485. package/src/adapters/prismaRows.spec.ts +0 -98
  486. package/src/adapters/prismaRows.ts +0 -308
  487. package/src/adapters/prismaTestClient.ts +0 -478
  488. package/src/calculatePagination.ts +0 -34
  489. package/src/db/databasePluginCore.spec.ts +0 -62
  490. package/src/db/databasePluginCore.testFixtures.ts +0 -76
  491. package/src/db/databasePluginCore.ts +0 -185
  492. package/src/db/databasePluginUpdateCheck.bench.ts +0 -117
  493. package/src/db/fixedMigrator.spec.ts +0 -294
  494. package/src/db/fixedMigrator.ts +0 -147
  495. package/src/db/fixedMigratorMongo.spec.ts +0 -253
  496. package/src/db/fixedMigratorMongo.ts +0 -425
  497. package/src/db/hotUpdaterSchema.ts +0 -5
  498. package/src/db/mongoMigrationExecution.ts +0 -23
  499. package/src/db/schema/definitions.ts +0 -1
  500. package/src/db/schema/insightsCollation.ts +0 -21
  501. package/src/db/schema/mongodb.ts +0 -40
  502. package/src/db/schema/registry.ts +0 -55
  503. package/src/db/schema/sql.ts +0 -244
  504. package/src/db/schema/sqlOperations.ts +0 -63
  505. package/src/db/schema/types.ts +0 -1
  506. package/src/db/schemaGenerators.ts +0 -495
  507. package/src/db/schemaReadiness.ts +0 -34
  508. package/src/db/sqlMigrationExecution.spec.ts +0 -65
  509. package/src/db/sqlMigrationExecution.ts +0 -108
  510. package/src/db/types.spec.ts +0 -63
  511. package/src/handlerBundleRoutes.ts +0 -259
  512. package/src/handlerReleaseManagementRoutes.ts +0 -213
  513. package/src/schema/dsl-all-versions.spec.ts +0 -35
  514. package/src/schema/dsl.ts +0 -187
  515. package/src/schema/index.ts +0 -10
  516. package/src/schema/settings.ts +0 -15
  517. package/src/schema/types.ts +0 -79
  518. package/src/schema/v1_0_0.spec.ts +0 -220
  519. 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
+ });