@hot-updater/server 1.0.0-rc.1 → 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 (542) hide show
  1. package/dist/_virtual/_rolldown/runtime.cjs +1 -1
  2. package/dist/adapters/drizzle.cjs +35 -69
  3. package/dist/adapters/drizzle.d.cts +13 -6
  4. package/dist/adapters/drizzle.d.mts +13 -6
  5. package/dist/adapters/drizzle.mjs +34 -69
  6. package/dist/adapters/drizzleExecutor.cjs +114 -0
  7. package/dist/adapters/drizzleExecutor.d.cts +9 -0
  8. package/dist/adapters/drizzleExecutor.d.mts +9 -0
  9. package/dist/adapters/drizzleExecutor.mjs +112 -0
  10. package/dist/adapters/kysely.cjs +25 -31
  11. package/dist/adapters/kysely.d.cts +10 -7
  12. package/dist/adapters/kysely.d.mts +10 -7
  13. package/dist/adapters/kysely.mjs +25 -31
  14. package/dist/adapters/kyselyExecutor.cjs +32 -0
  15. package/dist/adapters/kyselyExecutor.d.cts +12 -0
  16. package/dist/adapters/kyselyExecutor.d.mts +12 -0
  17. package/dist/adapters/kyselyExecutor.mjs +32 -0
  18. package/dist/adapters/mongodb.cjs +28 -27
  19. package/dist/adapters/mongodb.d.cts +10 -5
  20. package/dist/adapters/mongodb.d.mts +10 -5
  21. package/dist/adapters/mongodb.mjs +28 -27
  22. package/dist/adapters/mongodbAdapter.cjs +174 -0
  23. package/dist/adapters/mongodbAdapter.d.cts +9 -0
  24. package/dist/adapters/mongodbAdapter.d.mts +9 -0
  25. package/dist/adapters/mongodbAdapter.mjs +173 -0
  26. package/dist/adapters/prisma.cjs +38 -220
  27. package/dist/adapters/prisma.d.cts +12 -8
  28. package/dist/adapters/prisma.d.mts +12 -8
  29. package/dist/adapters/prisma.mjs +38 -219
  30. package/dist/adapters/prismaExecutor.cjs +64 -0
  31. package/dist/adapters/prismaExecutor.mjs +64 -0
  32. package/dist/adapters/sqlProviders.cjs +9 -0
  33. package/dist/adapters/sqlProviders.mjs +9 -0
  34. package/dist/apiKeys.cjs +8 -8
  35. package/dist/apiKeys.d.cts +1 -24
  36. package/dist/apiKeys.d.mts +1 -24
  37. package/dist/apiKeys.mjs +5 -9
  38. package/dist/assembly/assemblePlugins.cjs +147 -0
  39. package/dist/assembly/assemblePlugins.d.cts +12 -0
  40. package/dist/assembly/assemblePlugins.d.mts +12 -0
  41. package/dist/assembly/assemblePlugins.mjs +146 -0
  42. package/dist/assembly/databasePlugins.cjs +23 -0
  43. package/dist/assembly/databasePlugins.d.cts +43 -0
  44. package/dist/assembly/databasePlugins.d.mts +43 -0
  45. package/dist/assembly/databasePlugins.mjs +22 -0
  46. package/dist/core/api.cjs +91 -0
  47. package/dist/core/api.d.cts +65 -0
  48. package/dist/core/api.d.mts +65 -0
  49. package/dist/core/api.mjs +87 -0
  50. package/dist/core/baseCandidates.cjs +71 -0
  51. package/dist/core/baseCandidates.d.cts +17 -0
  52. package/dist/core/baseCandidates.d.mts +17 -0
  53. package/dist/core/baseCandidates.mjs +69 -0
  54. package/dist/core/operations.cjs +350 -0
  55. package/dist/core/operations.mjs +350 -0
  56. package/dist/core/reads.cjs +273 -0
  57. package/dist/core/reads.d.cts +48 -0
  58. package/dist/core/reads.d.mts +48 -0
  59. package/dist/core/reads.mjs +267 -0
  60. package/dist/core/releases.cjs +193 -0
  61. package/dist/core/releases.mjs +190 -0
  62. package/dist/core/schema.cjs +279 -0
  63. package/dist/core/schema.d.cts +307 -0
  64. package/dist/core/schema.d.mts +307 -0
  65. package/dist/core/schema.mjs +277 -0
  66. package/dist/core/writes.cjs +96 -0
  67. package/dist/core/writes.mjs +91 -0
  68. package/dist/createHotUpdaterCore.cjs +61 -63
  69. package/dist/createHotUpdaterCore.d.cts +53 -45
  70. package/dist/createHotUpdaterCore.d.mts +53 -45
  71. package/dist/createHotUpdaterCore.mjs +61 -63
  72. package/dist/database/cursor.cjs +44 -0
  73. package/dist/database/cursor.d.cts +7 -0
  74. package/dist/database/cursor.d.mts +7 -0
  75. package/dist/database/cursor.mjs +40 -0
  76. package/dist/database/database.cjs +44 -0
  77. package/dist/database/database.d.cts +123 -0
  78. package/dist/database/database.d.mts +123 -0
  79. package/dist/database/database.mjs +44 -0
  80. package/dist/database/definitions.d.cts +68 -0
  81. package/dist/database/definitions.d.mts +68 -0
  82. package/dist/database/engine.cjs +37 -0
  83. package/dist/database/engine.d.cts +40 -0
  84. package/dist/database/engine.d.mts +40 -0
  85. package/dist/database/engine.mjs +37 -0
  86. package/dist/database/engineAggregates.cjs +115 -0
  87. package/dist/database/engineAggregates.mjs +112 -0
  88. package/dist/database/engineReads.cjs +180 -0
  89. package/dist/database/engineReads.d.cts +35 -0
  90. package/dist/database/engineReads.d.mts +35 -0
  91. package/dist/database/engineReads.mjs +179 -0
  92. package/dist/database/engineTransaction.cjs +403 -0
  93. package/dist/database/engineTransaction.d.cts +26 -0
  94. package/dist/database/engineTransaction.d.mts +26 -0
  95. package/dist/database/engineTransaction.mjs +402 -0
  96. package/dist/database/errors.cjs +27 -0
  97. package/dist/database/errors.d.cts +21 -0
  98. package/dist/database/errors.d.mts +21 -0
  99. package/dist/database/errors.mjs +24 -0
  100. package/dist/database/fence.cjs +124 -0
  101. package/dist/database/fence.d.cts +42 -0
  102. package/dist/database/fence.d.mts +42 -0
  103. package/dist/database/fence.mjs +116 -0
  104. package/dist/database/index.cjs +127 -0
  105. package/dist/database/index.d.cts +17 -0
  106. package/dist/database/index.d.mts +17 -0
  107. package/dist/database/index.mjs +15 -0
  108. package/dist/database/kv/kvAdapter.cjs +273 -0
  109. package/dist/database/kv/kvAdapter.d.cts +101 -0
  110. package/dist/database/kv/kvAdapter.d.mts +101 -0
  111. package/dist/database/kv/kvAdapter.mjs +272 -0
  112. package/dist/database/resolveSchema.cjs +196 -0
  113. package/dist/database/resolveSchema.d.cts +42 -0
  114. package/dist/database/resolveSchema.d.mts +42 -0
  115. package/dist/database/resolveSchema.mjs +193 -0
  116. package/dist/database/schema.cjs +21 -0
  117. package/dist/database/schema.d.cts +61 -0
  118. package/dist/database/schema.d.mts +61 -0
  119. package/dist/database/schema.mjs +20 -0
  120. package/dist/database/sql/sqlAdapter.cjs +282 -0
  121. package/dist/database/sql/sqlAdapter.d.cts +46 -0
  122. package/dist/database/sql/sqlAdapter.d.mts +46 -0
  123. package/dist/database/sql/sqlAdapter.mjs +279 -0
  124. package/dist/database/sql/sqlSchema.cjs +115 -0
  125. package/dist/database/sql/sqlSchema.d.cts +8 -0
  126. package/dist/database/sql/sqlSchema.d.mts +8 -0
  127. package/dist/database/sql/sqlSchema.mjs +111 -0
  128. package/dist/db/builtInDatabase.cjs +104 -0
  129. package/dist/db/builtInDatabase.d.cts +38 -0
  130. package/dist/db/builtInDatabase.d.mts +38 -0
  131. package/dist/db/builtInDatabase.mjs +97 -0
  132. package/dist/db/createBundleDiff.cjs +6 -6
  133. package/dist/db/createBundleDiff.d.cts +4 -7
  134. package/dist/db/createBundleDiff.d.mts +4 -7
  135. package/dist/db/createBundleDiff.mjs +5 -5
  136. package/dist/db/engineDrizzleSchema.cjs +54 -0
  137. package/dist/db/engineDrizzleSchema.mjs +54 -0
  138. package/dist/db/engineMigrator.cjs +53 -0
  139. package/dist/db/engineMigrator.mjs +53 -0
  140. package/dist/db/enginePrismaSchema.cjs +85 -0
  141. package/dist/db/enginePrismaSchema.d.cts +5 -0
  142. package/dist/db/enginePrismaSchema.d.mts +5 -0
  143. package/dist/db/enginePrismaSchema.mjs +84 -0
  144. package/dist/db/engineSql.cjs +26 -0
  145. package/dist/db/engineSql.d.cts +17 -0
  146. package/dist/db/engineSql.d.mts +17 -0
  147. package/dist/db/engineSql.mjs +25 -0
  148. package/dist/db/engineSqlMigrator.cjs +66 -0
  149. package/dist/db/engineSqlMigrator.mjs +66 -0
  150. package/dist/db/fixedMigratorShared.cjs +0 -11
  151. package/dist/db/fixedMigratorShared.mjs +1 -8
  152. package/dist/db/index.cjs +23 -8
  153. package/dist/db/index.d.cts +10 -4
  154. package/dist/db/index.d.mts +10 -4
  155. package/dist/db/index.mjs +16 -8
  156. package/dist/db/releaseCatalog.cjs +20 -44
  157. package/dist/db/releaseCatalog.d.cts +2 -3
  158. package/dist/db/releaseCatalog.d.mts +2 -3
  159. package/dist/db/releaseCatalog.mjs +20 -44
  160. package/dist/db/schemaSettings.cjs +63 -0
  161. package/dist/db/schemaSettings.d.cts +12 -0
  162. package/dist/db/schemaSettings.d.mts +12 -0
  163. package/dist/db/schemaSettings.mjs +62 -0
  164. package/dist/db/settingsMigrator.cjs +92 -0
  165. package/dist/db/settingsMigrator.mjs +89 -0
  166. package/dist/db/types.cjs +3 -12
  167. package/dist/db/types.d.cts +26 -69
  168. package/dist/db/types.d.mts +26 -69
  169. package/dist/db/types.mjs +2 -11
  170. package/dist/db/updateArtifacts.cjs +38 -68
  171. package/dist/db/updateArtifacts.mjs +40 -69
  172. package/dist/handler.cjs +72 -43
  173. package/dist/handler.d.cts +3 -6
  174. package/dist/handler.d.mts +3 -6
  175. package/dist/handler.mjs +73 -43
  176. package/dist/handlerAdminRoutes.cjs +375 -0
  177. package/dist/handlerAdminRoutes.mjs +373 -0
  178. package/dist/handlerParameters.cjs +6 -11
  179. package/dist/handlerParameters.mjs +6 -10
  180. package/dist/handlerReleaseCatalogRoutes.cjs +11 -14
  181. package/dist/handlerReleaseCatalogRoutes.mjs +11 -13
  182. package/dist/handlerTypes.d.cts +2 -56
  183. package/dist/handlerTypes.d.mts +2 -56
  184. package/dist/handlerVersionRoutes.cjs +20 -4
  185. package/dist/handlerVersionRoutes.d.cts +1 -0
  186. package/dist/handlerVersionRoutes.d.mts +1 -0
  187. package/dist/handlerVersionRoutes.mjs +20 -4
  188. package/dist/index.cjs +4 -7
  189. package/dist/index.d.cts +10 -9
  190. package/dist/index.d.mts +10 -9
  191. package/dist/index.mjs +4 -4
  192. package/dist/insights/domain.d.cts +53 -70
  193. package/dist/insights/domain.d.mts +53 -70
  194. package/dist/insights/errors.cjs +35 -8
  195. package/dist/insights/errors.mjs +35 -8
  196. package/dist/insights/eventInput.cjs +64 -24
  197. package/dist/insights/eventInput.mjs +63 -25
  198. package/dist/insights/provider.cjs +356 -0
  199. package/dist/insights/provider.d.cts +6 -0
  200. package/dist/insights/provider.d.mts +6 -0
  201. package/dist/insights/provider.mjs +355 -0
  202. package/dist/insights/queryInput.cjs +78 -43
  203. package/dist/insights/queryInput.mjs +76 -40
  204. package/dist/insights/routes.cjs +94 -34
  205. package/dist/insights/routes.mjs +93 -35
  206. package/dist/insights/types.d.cts +27 -12
  207. package/dist/insights/types.d.mts +27 -12
  208. package/dist/node.d.cts +1 -2
  209. package/dist/node.d.mts +1 -2
  210. package/dist/package.cjs +1 -1
  211. package/dist/package.mjs +1 -1
  212. package/dist/plugins/api-keys/index.cjs +50 -0
  213. package/dist/plugins/api-keys/index.d.cts +85 -0
  214. package/dist/plugins/api-keys/index.d.mts +85 -0
  215. package/dist/plugins/api-keys/index.mjs +47 -0
  216. package/dist/plugins/api-keys/model.cjs +58 -0
  217. package/dist/plugins/api-keys/model.d.cts +8 -0
  218. package/dist/plugins/api-keys/model.d.mts +8 -0
  219. package/dist/plugins/api-keys/model.mjs +58 -0
  220. package/dist/plugins/api-keys/schema.cjs +38 -0
  221. package/dist/plugins/api-keys/schema.d.cts +44 -0
  222. package/dist/plugins/api-keys/schema.d.mts +44 -0
  223. package/dist/plugins/api-keys/schema.mjs +39 -0
  224. package/dist/plugins/builtIn.cjs +7 -0
  225. package/dist/plugins/builtIn.mjs +6 -0
  226. package/dist/plugins/definePlugin.cjs +5 -0
  227. package/dist/plugins/definePlugin.d.cts +73 -0
  228. package/dist/plugins/definePlugin.d.mts +73 -0
  229. package/dist/plugins/definePlugin.mjs +5 -0
  230. package/dist/plugins/index.cjs +17 -0
  231. package/dist/plugins/index.d.cts +9 -0
  232. package/dist/plugins/index.d.mts +9 -0
  233. package/dist/plugins/index.mjs +7 -0
  234. package/dist/plugins/insights/index.cjs +48 -0
  235. package/dist/plugins/insights/index.d.cts +295 -0
  236. package/dist/plugins/insights/index.d.mts +295 -0
  237. package/dist/plugins/insights/index.mjs +44 -0
  238. package/dist/plugins/insights/model.cjs +17 -0
  239. package/dist/plugins/insights/model.d.cts +10 -0
  240. package/dist/plugins/insights/model.d.mts +10 -0
  241. package/dist/plugins/insights/model.mjs +17 -0
  242. package/dist/plugins/insights/reads.cjs +471 -0
  243. package/dist/plugins/insights/reads.mjs +466 -0
  244. package/dist/plugins/insights/recordEvent.cjs +135 -0
  245. package/dist/plugins/insights/recordEvent.d.cts +13 -0
  246. package/dist/plugins/insights/recordEvent.d.mts +13 -0
  247. package/dist/plugins/insights/recordEvent.mjs +132 -0
  248. package/dist/plugins/insights/schema.cjs +347 -0
  249. package/dist/plugins/insights/schema.d.cts +258 -0
  250. package/dist/plugins/insights/schema.d.mts +258 -0
  251. package/dist/plugins/insights/schema.mjs +344 -0
  252. package/dist/storageAccess.cjs +0 -1
  253. package/dist/types/index.d.cts +2 -29
  254. package/dist/types/index.d.mts +2 -29
  255. package/package.json +30 -7
  256. package/src/adapters/drizzle.conformance.integration.spec.ts +34 -0
  257. package/src/adapters/drizzle.readBudgets.integration.spec.ts +41 -0
  258. package/src/adapters/drizzle.spec.ts +277 -208
  259. package/src/adapters/drizzle.ts +48 -128
  260. package/src/adapters/drizzleExecutor.ts +166 -0
  261. package/src/adapters/kysely.conformance.integration.spec.ts +36 -0
  262. package/src/adapters/kysely.readBudgets.integration.spec.ts +42 -0
  263. package/src/adapters/kysely.spec.ts +212 -117
  264. package/src/adapters/kysely.ts +32 -87
  265. package/src/adapters/kyselyExecutor.ts +53 -0
  266. package/src/adapters/mongodb.integration.spec.ts +180 -0
  267. package/src/adapters/mongodb.readBudgets.integration.spec.ts +61 -0
  268. package/src/adapters/mongodb.ts +36 -65
  269. package/src/adapters/mongodbAdapter.ts +293 -0
  270. package/src/adapters/prisma.conformance.integration.spec.ts +36 -0
  271. package/src/adapters/prisma.integration.spec.ts +138 -0
  272. package/src/adapters/prisma.readBudgets.integration.spec.ts +40 -0
  273. package/src/adapters/prisma.spec.ts +226 -173
  274. package/src/adapters/prisma.ts +60 -451
  275. package/src/adapters/prismaExecutor.ts +107 -0
  276. package/src/adapters/prismaTestClients.ts +175 -0
  277. package/src/adapters/sqlProviders.ts +14 -0
  278. package/src/apiKeys.integration.spec.ts +19 -119
  279. package/src/apiKeys.spec.ts +39 -35
  280. package/src/apiKeys.ts +2 -8
  281. package/src/assembly/assemblePlugins.ts +269 -0
  282. package/src/assembly/assembly.spec.ts +325 -0
  283. package/src/assembly/assembly.types.spec.ts +155 -0
  284. package/src/assembly/builtInRoutes.spec.ts +213 -0
  285. package/src/assembly/databasePlugins.spec.ts +71 -0
  286. package/src/assembly/databasePlugins.ts +96 -0
  287. package/src/core/api.ts +139 -0
  288. package/src/core/baseCandidates.spec.ts +378 -0
  289. package/src/core/baseCandidates.ts +136 -0
  290. package/src/core/index.ts +44 -0
  291. package/src/core/operations.spec.ts +415 -0
  292. package/src/core/operations.ts +551 -0
  293. package/src/core/reads.spec.ts +300 -0
  294. package/src/core/reads.ts +417 -0
  295. package/src/core/releases.spec.ts +308 -0
  296. package/src/core/releases.ts +345 -0
  297. package/src/core/schema.ts +173 -0
  298. package/src/core/writes.ts +160 -0
  299. package/src/createHotUpdaterCore.ts +191 -167
  300. package/src/database/cursor.ts +65 -0
  301. package/src/database/database.ts +335 -0
  302. package/src/database/database.types.spec.ts +135 -0
  303. package/src/database/definitions.ts +72 -0
  304. package/src/database/engine.ts +62 -0
  305. package/src/database/engineAggregates.spec.ts +539 -0
  306. package/src/database/engineAggregates.ts +193 -0
  307. package/src/database/engineReads.spec.ts +219 -0
  308. package/src/database/engineReads.ts +302 -0
  309. package/src/database/engineTransaction.spec.ts +710 -0
  310. package/src/database/engineTransaction.ts +588 -0
  311. package/src/database/errors.ts +30 -0
  312. package/src/database/fence.spec.ts +223 -0
  313. package/src/database/fence.ts +171 -0
  314. package/src/database/index.ts +154 -0
  315. package/src/database/kv/kvAdapter.conformance.integration.spec.ts +17 -0
  316. package/src/database/kv/kvAdapter.readBudgets.integration.spec.ts +17 -0
  317. package/src/database/kv/kvAdapter.spec.ts +468 -0
  318. package/src/database/kv/kvAdapter.ts +450 -0
  319. package/src/database/kv/kvTestStore.ts +91 -0
  320. package/src/database/memory.readBudgets.integration.spec.ts +13 -0
  321. package/src/database/resolveSchema.spec.ts +230 -0
  322. package/src/database/resolveSchema.ts +372 -0
  323. package/src/database/schema.ts +169 -0
  324. package/src/database/schema.types.spec.ts +94 -0
  325. package/src/database/sql/docker-compose.yml +36 -0
  326. package/src/database/sql/sqlAdapter.integration.spec.ts +148 -0
  327. package/src/database/sql/sqlAdapter.readBudgets.integration.spec.ts +109 -0
  328. package/src/database/sql/sqlAdapter.spec.ts +255 -0
  329. package/src/database/sql/sqlAdapter.ts +532 -0
  330. package/src/database/sql/sqlSchema.ts +205 -0
  331. package/src/database/sql/sqlTestExecutors.ts +183 -0
  332. package/src/databaseTestSuite.spec.ts +39 -0
  333. package/src/db/builtInDatabase.ts +149 -0
  334. package/src/db/bundleRows.spec.ts +3 -3
  335. package/src/db/createBundleDiff.spec.ts +43 -29
  336. package/src/db/createBundleDiff.ts +13 -7
  337. package/src/db/engineDrizzleSchema.ts +72 -0
  338. package/src/db/engineMigrator.ts +105 -0
  339. package/src/db/enginePrismaSchema.ts +147 -0
  340. package/src/db/engineSql.spec.ts +129 -0
  341. package/src/db/engineSql.ts +48 -0
  342. package/src/db/engineSqlMigrator.ts +116 -0
  343. package/src/db/fixedMigratorShared.ts +1 -20
  344. package/src/db/index.spec.ts +116 -824
  345. package/src/db/index.ts +43 -14
  346. package/src/db/pluginTables.spec.ts +218 -0
  347. package/src/db/releaseCatalog.ts +48 -90
  348. package/src/db/schemaSettings.ts +104 -0
  349. package/src/db/settingsMigrator.spec.ts +65 -0
  350. package/src/db/settingsMigrator.ts +152 -0
  351. package/src/db/types.ts +25 -165
  352. package/src/db/updateArtifacts.spec.ts +170 -294
  353. package/src/db/updateArtifacts.ts +74 -142
  354. package/src/db/updateCheck.bench.ts +47 -0
  355. package/src/handler-standalone.integration.spec.ts +204 -412
  356. package/src/handler.spec.ts +134 -51
  357. package/src/handler.testFixtures.ts +14 -19
  358. package/src/handler.ts +163 -75
  359. package/src/handlerAdminRoutes.spec.ts +183 -0
  360. package/src/handlerAdminRoutes.ts +536 -0
  361. package/src/handlerAuth.integration.spec.ts +3 -3
  362. package/src/handlerManagement.spec.ts +136 -196
  363. package/src/handlerReleaseCatalogRoutes.ts +15 -17
  364. package/src/handlerTypes.ts +3 -80
  365. package/src/handlerVersionRoutes.ts +20 -7
  366. package/src/index.ts +7 -14
  367. package/src/insights/domain.ts +56 -77
  368. package/src/insights/errors.spec.ts +48 -0
  369. package/src/insights/errors.ts +50 -6
  370. package/src/insights/eventInput.ts +80 -27
  371. package/src/insights/insights.integration.spec.ts +525 -44
  372. package/src/insights/provider.spec.ts +574 -0
  373. package/src/insights/provider.ts +667 -0
  374. package/src/insights/queryInput.ts +113 -73
  375. package/src/insights/routes.ts +125 -69
  376. package/src/insights/types.ts +47 -36
  377. package/src/lintRules.spec.ts +76 -0
  378. package/src/plugins/api-keys/apiKeysPlugin.spec.ts +172 -0
  379. package/src/plugins/api-keys/index.ts +66 -0
  380. package/src/plugins/api-keys/model.ts +69 -0
  381. package/src/plugins/api-keys/schema.ts +22 -0
  382. package/src/plugins/builtIn.ts +5 -0
  383. package/src/plugins/definePlugin.ts +100 -0
  384. package/src/plugins/index.ts +55 -0
  385. package/src/plugins/insights/index.ts +86 -0
  386. package/src/plugins/insights/insightsRollout.integration.spec.ts +187 -0
  387. package/src/plugins/insights/model.spec.ts +66 -0
  388. package/src/plugins/insights/model.ts +19 -0
  389. package/src/plugins/insights/reads.spec.ts +725 -0
  390. package/src/plugins/insights/reads.ts +707 -0
  391. package/src/plugins/insights/recordEvent.spec.ts +443 -0
  392. package/src/plugins/insights/recordEvent.ts +238 -0
  393. package/src/plugins/insights/schema.ts +229 -0
  394. package/src/plugins/pluginTestHarness.spec.ts +56 -0
  395. package/src/readBudgets.testFixtures.ts +15 -0
  396. package/src/releaseCatalogRoutes.integration.spec.ts +47 -92
  397. package/src/runtime.spec.ts +91 -77
  398. package/src/runtime.testFixtures.ts +28 -44
  399. package/src/runtimeBundles.integration.spec.ts +112 -0
  400. package/src/testUtilsMutation.integration.spec.ts +215 -0
  401. package/src/testUtilsPackage.integration.spec.ts +176 -0
  402. package/src/types/index.ts +0 -32
  403. package/dist/adapters/databaseConstraintErrors.cjs +0 -23
  404. package/dist/adapters/databaseConstraintErrors.mjs +0 -21
  405. package/dist/adapters/databasePluginUtils.cjs +0 -117
  406. package/dist/adapters/databasePluginUtils.mjs +0 -106
  407. package/dist/adapters/drizzleCrud.cjs +0 -250
  408. package/dist/adapters/drizzleCrud.mjs +0 -249
  409. package/dist/adapters/drizzleLazyDB.cjs +0 -101
  410. package/dist/adapters/drizzleLazyDB.mjs +0 -101
  411. package/dist/adapters/drizzleQuery.cjs +0 -68
  412. package/dist/adapters/drizzleQuery.mjs +0 -67
  413. package/dist/adapters/kyselyCrud.cjs +0 -254
  414. package/dist/adapters/kyselyCrud.mjs +0 -253
  415. package/dist/adapters/kyselyQuery.cjs +0 -56
  416. package/dist/adapters/kyselyQuery.mjs +0 -55
  417. package/dist/adapters/mongodbCollections.cjs +0 -36
  418. package/dist/adapters/mongodbCollections.mjs +0 -30
  419. package/dist/adapters/mongodbQuery.cjs +0 -77
  420. package/dist/adapters/mongodbQuery.mjs +0 -70
  421. package/dist/adapters/mongodbReads.cjs +0 -148
  422. package/dist/adapters/mongodbReads.mjs +0 -147
  423. package/dist/adapters/mongodbWrites.cjs +0 -134
  424. package/dist/adapters/mongodbWrites.mjs +0 -133
  425. package/dist/adapters/prismaQuery.cjs +0 -58
  426. package/dist/adapters/prismaQuery.mjs +0 -56
  427. package/dist/adapters/prismaRows.cjs +0 -198
  428. package/dist/adapters/prismaRows.mjs +0 -188
  429. package/dist/db/databasePluginCore.cjs +0 -138
  430. package/dist/db/databasePluginCore.mjs +0 -137
  431. package/dist/db/fixedMigrator.cjs +0 -79
  432. package/dist/db/fixedMigrator.mjs +0 -78
  433. package/dist/db/fixedMigratorMongo.cjs +0 -319
  434. package/dist/db/fixedMigratorMongo.mjs +0 -319
  435. package/dist/db/mongoMigrationExecution.cjs +0 -11
  436. package/dist/db/mongoMigrationExecution.mjs +0 -11
  437. package/dist/db/schema/mongodb.cjs +0 -25
  438. package/dist/db/schema/mongodb.mjs +0 -25
  439. package/dist/db/schema/registry.cjs +0 -21
  440. package/dist/db/schema/registry.mjs +0 -17
  441. package/dist/db/schema/sql.cjs +0 -101
  442. package/dist/db/schema/sql.mjs +0 -97
  443. package/dist/db/schema/sqlOperations.cjs +0 -27
  444. package/dist/db/schema/sqlOperations.mjs +0 -26
  445. package/dist/db/schemaGenerators.cjs +0 -256
  446. package/dist/db/schemaGenerators.mjs +0 -254
  447. package/dist/db/schemaReadiness.cjs +0 -24
  448. package/dist/db/schemaReadiness.d.cts +0 -8
  449. package/dist/db/schemaReadiness.d.mts +0 -8
  450. package/dist/db/schemaReadiness.mjs +0 -23
  451. package/dist/db/sqlMigrationExecution.cjs +0 -67
  452. package/dist/db/sqlMigrationExecution.mjs +0 -66
  453. package/dist/handlerBundleRoutes.cjs +0 -155
  454. package/dist/handlerBundleRoutes.mjs +0 -155
  455. package/dist/handlerReleaseManagementRoutes.cjs +0 -125
  456. package/dist/handlerReleaseManagementRoutes.mjs +0 -124
  457. package/dist/insights/bounded/activeOverview.cjs +0 -87
  458. package/dist/insights/bounded/activeOverview.mjs +0 -85
  459. package/dist/insights/bounded/installationSearch.cjs +0 -42
  460. package/dist/insights/bounded/installationSearch.mjs +0 -42
  461. package/dist/insights/bounded/persistence.cjs +0 -39
  462. package/dist/insights/bounded/persistence.mjs +0 -38
  463. package/dist/insights/bounded/provider.cjs +0 -170
  464. package/dist/insights/bounded/provider.d.cts +0 -7
  465. package/dist/insights/bounded/provider.d.mts +0 -7
  466. package/dist/insights/bounded/provider.mjs +0 -170
  467. package/dist/insights/bounded/scan.cjs +0 -144
  468. package/dist/insights/bounded/scan.mjs +0 -138
  469. package/dist/insights/persistence.d.cts +0 -6
  470. package/dist/insights/persistence.d.mts +0 -6
  471. package/dist/schema/dsl.cjs +0 -103
  472. package/dist/schema/dsl.mjs +0 -87
  473. package/dist/schema/index.cjs +0 -6
  474. package/dist/schema/index.mjs +0 -7
  475. package/dist/schema/settings.cjs +0 -9
  476. package/dist/schema/settings.mjs +0 -9
  477. package/dist/schema/types.cjs +0 -8
  478. package/dist/schema/types.mjs +0 -6
  479. package/dist/schema/v1_0_0.cjs +0 -364
  480. package/dist/schema/v1_0_0.mjs +0 -357
  481. package/src/adapters/databaseConstraintErrors.ts +0 -25
  482. package/src/adapters/databasePluginTestDatabase.ts +0 -106
  483. package/src/adapters/databasePluginUtils.spec.ts +0 -29
  484. package/src/adapters/databasePluginUtils.ts +0 -214
  485. package/src/adapters/drizzleCrud.ts +0 -419
  486. package/src/adapters/drizzleLazyDB.ts +0 -257
  487. package/src/adapters/drizzleQuery.ts +0 -164
  488. package/src/adapters/kyselyCrud.ts +0 -588
  489. package/src/adapters/kyselyQuery.ts +0 -128
  490. package/src/adapters/mongodb.spec.ts +0 -141
  491. package/src/adapters/mongodbCollections.ts +0 -62
  492. package/src/adapters/mongodbQuery.ts +0 -226
  493. package/src/adapters/mongodbReads.ts +0 -311
  494. package/src/adapters/mongodbRows.spec.ts +0 -64
  495. package/src/adapters/mongodbRows.ts +0 -118
  496. package/src/adapters/mongodbTestClient.ts +0 -342
  497. package/src/adapters/mongodbTestFilter.ts +0 -166
  498. package/src/adapters/mongodbWrites.ts +0 -260
  499. package/src/adapters/prismaQuery.ts +0 -129
  500. package/src/adapters/prismaRows.spec.ts +0 -98
  501. package/src/adapters/prismaRows.ts +0 -301
  502. package/src/adapters/prismaTestClient.ts +0 -396
  503. package/src/calculatePagination.ts +0 -34
  504. package/src/db/databasePluginCore.spec.ts +0 -62
  505. package/src/db/databasePluginCore.testFixtures.ts +0 -76
  506. package/src/db/databasePluginCore.ts +0 -185
  507. package/src/db/databasePluginUpdateCheck.bench.ts +0 -107
  508. package/src/db/fixedMigrator.spec.ts +0 -231
  509. package/src/db/fixedMigrator.ts +0 -147
  510. package/src/db/fixedMigratorMongo.spec.ts +0 -192
  511. package/src/db/fixedMigratorMongo.ts +0 -425
  512. package/src/db/hotUpdaterSchema.ts +0 -5
  513. package/src/db/mongoMigrationExecution.ts +0 -23
  514. package/src/db/schema/definitions.ts +0 -1
  515. package/src/db/schema/mongodb.ts +0 -40
  516. package/src/db/schema/registry.ts +0 -55
  517. package/src/db/schema/sql.ts +0 -241
  518. package/src/db/schema/sqlOperations.ts +0 -63
  519. package/src/db/schema/types.ts +0 -1
  520. package/src/db/schemaGenerators.ts +0 -466
  521. package/src/db/schemaReadiness.ts +0 -34
  522. package/src/db/sqlMigrationExecution.spec.ts +0 -65
  523. package/src/db/sqlMigrationExecution.ts +0 -108
  524. package/src/db/types.spec.ts +0 -55
  525. package/src/handlerBundleRoutes.ts +0 -259
  526. package/src/handlerReleaseManagementRoutes.ts +0 -213
  527. package/src/insights/bounded/activeOverview.spec.ts +0 -189
  528. package/src/insights/bounded/activeOverview.ts +0 -148
  529. package/src/insights/bounded/installationSearch.spec.ts +0 -130
  530. package/src/insights/bounded/installationSearch.ts +0 -69
  531. package/src/insights/bounded/persistence.ts +0 -43
  532. package/src/insights/bounded/provider.spec.ts +0 -219
  533. package/src/insights/bounded/provider.ts +0 -229
  534. package/src/insights/bounded/scan.ts +0 -235
  535. package/src/insights/persistence.ts +0 -10
  536. package/src/schema/dsl-all-versions.spec.ts +0 -35
  537. package/src/schema/dsl.ts +0 -187
  538. package/src/schema/index.ts +0 -10
  539. package/src/schema/settings.ts +0 -15
  540. package/src/schema/types.ts +0 -79
  541. package/src/schema/v1_0_0.spec.ts +0 -146
  542. package/src/schema/v1_0_0.ts +0 -465
@@ -2,17 +2,18 @@ import { brotliCompressSync } from "node:zlib";
2
2
 
3
3
  import type {
4
4
  Bundle,
5
- DatabasePlugin,
5
+ EngineDatabase,
6
6
  StoragePlugin,
7
7
  StoragePluginWith,
8
8
  } from "@hot-updater/plugin-core";
9
9
  import {
10
- createDatabaseClient,
11
10
  createStoragePlugin as createCoreStoragePlugin,
11
+ rowToBundle,
12
12
  } from "@hot-updater/plugin-core";
13
+ import { createMemoryAdapter } from "@hot-updater/plugin-core/internal";
13
14
  import { afterEach, describe, expect, it, vi } from "vitest";
14
15
 
15
- import { createInMemoryDatabasePlugin } from "../../../test-utils/test/inMemoryDatabasePlugin";
16
+ import { createDatabaseCoreApi } from "../core/api";
16
17
 
17
18
  vi.mock("@hot-updater/bsdiff", () => ({
18
19
  hdiff: vi.fn(async () => new Uint8Array([1, 2, 3, 4])),
@@ -21,25 +22,44 @@ vi.mock("@hot-updater/bsdiff", () => ({
21
22
  import { createBundleDiff } from "./createBundleDiff";
22
23
 
23
24
  const createBundle = (id: string, overrides: Partial<Bundle> = {}): Bundle => ({
24
- archiveByteSize: 1_024,
25
- fileHash: `${id}-file-hash`,
26
25
  gitCommitHash: null,
27
26
  id,
28
27
  assetBaseStorageUri: "s3://test-bucket/releases/assets",
29
28
  manifestStorageUri: `s3://test-bucket/releases/bundles/${id}/manifest.json`,
30
29
  metadata: {},
31
30
  platform: "ios",
32
- storageUri: `s3://test-bucket/releases/bundles/${id}/bundle.zip`,
31
+ manifestFileHash: `${id}-manifest-hash`,
33
32
  ...overrides,
34
33
  });
35
34
 
36
- const createDatabasePlugin = async (
35
+ /** An in-memory database holding `bundles`, each deployed disabled. */
36
+ const createDatabase = async (
37
37
  bundles: readonly Bundle[],
38
- ): Promise<DatabasePlugin> => {
39
- const plugin = createInMemoryDatabasePlugin();
40
- const client = createDatabaseClient(plugin);
41
- for (const bundle of bundles) await client.insertBundle(bundle);
42
- return plugin;
38
+ ): Promise<EngineDatabase> => {
39
+ const database = { name: "memory", adapter: createMemoryAdapter() };
40
+ const core = createDatabaseCoreApi(database);
41
+ for (const bundle of bundles) {
42
+ await core.deploy([
43
+ {
44
+ bundle,
45
+ release: {
46
+ channel: "production",
47
+ enabled: false,
48
+ fingerprintHash: null,
49
+ message: null,
50
+ shouldForceUpdate: false,
51
+ targetAppVersion: "*",
52
+ },
53
+ },
54
+ ]);
55
+ }
56
+ return database;
57
+ };
58
+
59
+ /** A stored bundle with its patches, as deploys write it. */
60
+ const storedBundle = async (database: EngineDatabase, id: string) => {
61
+ const detail = await createDatabaseCoreApi(database).getBundle(id);
62
+ return detail === null ? null : rowToBundle(detail.bundle, detail.patches);
43
63
  };
44
64
 
45
65
  const createStoragePlugin = (
@@ -78,9 +98,7 @@ describe("createBundleDiff", () => {
78
98
  const targetBundle = createBundle("00000000-0000-0000-0000-000000000002");
79
99
  const baseDownloadFileHash = "a".repeat(64);
80
100
  const targetDownloadFileHash = "b".repeat(64);
81
- const plugin = await createDatabasePlugin([baseBundle, targetBundle]);
82
- const databasePlugin: DatabasePlugin = plugin;
83
- const commit = vi.spyOn(databasePlugin, "commit");
101
+ const database = await createDatabase([baseBundle, targetBundle]);
84
102
  const upload = vi.fn<NonNullable<StoragePlugin["put"]>>(
85
103
  async ({ key, body, contentLength }) => {
86
104
  const bytes = new Uint8Array(await new Response(body).arrayBuffer());
@@ -152,13 +170,15 @@ describe("createBundleDiff", () => {
152
170
  bundleId: targetBundle.id,
153
171
  },
154
172
  {
155
- databasePlugin,
173
+ database,
156
174
  storagePlugin: createStoragePlugin(upload),
157
175
  },
158
176
  );
159
177
 
160
178
  expect(upload).toHaveBeenCalledOnce();
161
- expect(commit).toHaveBeenCalledOnce();
179
+ await expect(
180
+ storedBundle(database, targetBundle.id),
181
+ ).resolves.toMatchObject({ patches: updatedBundle.patches });
162
182
  const [patch] = updatedBundle.patches ?? [];
163
183
  expect(patch?.baseBundleId).toBe(baseBundle.id);
164
184
  expect(patch?.baseFileHash).toBe("hash-old");
@@ -184,10 +204,7 @@ describe("createBundleDiff", () => {
184
204
  it("rejects ambiguous Hermes bundle assets in manifests", async () => {
185
205
  const baseBundle = createBundle("00000000-0000-0000-0000-000000000001");
186
206
  const targetBundle = createBundle("00000000-0000-0000-0000-000000000002");
187
- const databasePlugin = await createDatabasePlugin([
188
- baseBundle,
189
- targetBundle,
190
- ]);
207
+ const database = await createDatabase([baseBundle, targetBundle]);
191
208
  const upload = vi.fn<NonNullable<StoragePlugin["put"]>>(
192
209
  async ({ key }) => ({
193
210
  storageUri: `s3://test-bucket/${key}`,
@@ -243,7 +260,7 @@ describe("createBundleDiff", () => {
243
260
  bundleId: targetBundle.id,
244
261
  },
245
262
  {
246
- databasePlugin,
263
+ database,
247
264
  storagePlugin: createStoragePlugin(upload),
248
265
  },
249
266
  ),
@@ -265,10 +282,7 @@ describe("createBundleDiff", () => {
265
282
  manifestStorageUri:
266
283
  "https://storage.example.com/releases/target/manifest.json",
267
284
  });
268
- const databasePlugin = await createDatabasePlugin([
269
- baseBundle,
270
- targetBundle,
271
- ]);
285
+ const database = await createDatabase([baseBundle, targetBundle]);
272
286
  const responses = new Map<string, string | Uint8Array>([
273
287
  [
274
288
  baseBundle.manifestStorageUri!,
@@ -312,7 +326,7 @@ describe("createBundleDiff", () => {
312
326
  await createBundleDiff(
313
327
  { baseBundleId: baseBundle.id, bundleId: targetBundle.id },
314
328
  {
315
- databasePlugin,
329
+ database,
316
330
  storagePlugin: createStoragePlugin(upload, {
317
331
  get,
318
332
  protocol: "https",
@@ -350,7 +364,7 @@ describe("createBundleDiff", () => {
350
364
  },
351
365
  ],
352
366
  });
353
- const databasePlugin = await createDatabasePlugin([
367
+ const database = await createDatabase([
354
368
  primaryBaseBundle,
355
369
  secondaryBaseBundle,
356
370
  targetBundle,
@@ -419,7 +433,7 @@ describe("createBundleDiff", () => {
419
433
  bundleId: targetBundle.id,
420
434
  },
421
435
  {
422
- databasePlugin,
436
+ database,
423
437
  storagePlugin: createStoragePlugin(upload),
424
438
  },
425
439
  {
@@ -12,16 +12,18 @@ import {
12
12
  } from "@hot-updater/core";
13
13
  import type {
14
14
  Bundle,
15
- BundleRepository,
15
+ ConfiguredDatabase,
16
16
  StoragePluginWith,
17
17
  } from "@hot-updater/plugin-core";
18
18
  import {
19
19
  createBundleStorageKey,
20
- createDatabaseClient,
21
20
  getManifestAssetDownloadPath,
22
21
  resolveManifestAssetStorageUri,
22
+ rowToBundle,
23
23
  } from "@hot-updater/plugin-core";
24
24
 
25
+ import { createDatabaseCoreApi } from "../core/api";
26
+
25
27
  type BundleManifest = {
26
28
  bundleId: string;
27
29
  assets: Record<
@@ -41,7 +43,8 @@ export interface CreateBundleDiffInput {
41
43
  }
42
44
 
43
45
  export interface CreateBundleDiffDependencies {
44
- databasePlugin: BundleRepository;
46
+ /** The config's database: a provider's, or `standaloneRepository`. */
47
+ database: ConfiguredDatabase;
45
48
  storagePlugin: StoragePluginWith<"get" | "put" | "delete"> | null;
46
49
  }
47
50
 
@@ -239,7 +242,7 @@ export async function createBundleDiff(
239
242
  deps: CreateBundleDiffDependencies,
240
243
  options: CreateBundleDiffOptions = {},
241
244
  ) {
242
- const database = createDatabaseClient(deps.databasePlugin);
245
+ const core = createDatabaseCoreApi(deps.database);
243
246
 
244
247
  if (!deps.storagePlugin) {
245
248
  throw new Error("Storage plugin is not configured");
@@ -249,8 +252,11 @@ export async function createBundleDiff(
249
252
  throw new Error("Base bundle must be different from the target bundle");
250
253
  }
251
254
 
252
- const baseBundle = await database.getBundleById(baseBundleId);
253
- const targetBundle = await database.getBundleById(bundleId);
255
+ const [baseBundle, targetBundle] = (
256
+ await Promise.all([core.getBundle(baseBundleId), core.getBundle(bundleId)])
257
+ ).map((detail) =>
258
+ detail === null ? null : rowToBundle(detail.bundle, detail.patches),
259
+ );
254
260
 
255
261
  if (!baseBundle || !targetBundle) {
256
262
  throw new Error("Bundle not found");
@@ -347,7 +353,7 @@ export async function createBundleDiff(
347
353
  ...targetBundle,
348
354
  patches,
349
355
  };
350
- await database.updateBundleById(targetBundle.id, updatedBundle);
356
+ await core.updateBundle(targetBundle.id, { patches });
351
357
 
352
358
  if (
353
359
  previousPatch?.patchStorageUri &&
@@ -0,0 +1,72 @@
1
+ import { SETTINGS_TABLE } from "../database/fence";
2
+ import type { ResolvedSchema } from "../database/resolveSchema";
3
+ import {
4
+ sqlTableShapes,
5
+ type SqlDialect,
6
+ type SqlTableShape,
7
+ } from "../database/sql/sqlSchema";
8
+
9
+ const drizzle = {
10
+ postgresql: { module: "drizzle-orm/pg-core", table: "pgTable" },
11
+ mysql: { module: "drizzle-orm/mysql-core", table: "mysqlTable" },
12
+ sqlite: { module: "drizzle-orm/sqlite-core", table: "sqliteTable" },
13
+ } as const;
14
+
15
+ const literal = (value: string) => JSON.stringify(value);
16
+
17
+ /**
18
+ * The Drizzle schema `drizzle-kit` applies for the engine's tables: every
19
+ * column typed exactly as the engine's DDL, keys, indexes, index tables, and
20
+ * the settings table. The engine keeps references itself, so there are no
21
+ * foreign keys. `hot-updater db migrate` then writes only the settings rows.
22
+ */
23
+ export const generateDrizzleEngineSchema = (
24
+ dialect: SqlDialect,
25
+ schema: ResolvedSchema,
26
+ ): string => {
27
+ const { module, table: tableFunction } = drizzle[dialect];
28
+ const tables = [...schema.tables, SETTINGS_TABLE];
29
+ const blocks: string[] = [];
30
+ const emit = (shape: SqlTableShape) => {
31
+ const columns = shape.columns.map(
32
+ (column) =>
33
+ ` ${literal(column.name)}: column(${literal(column.type)})(${literal(column.name)})${column.notNull ? ".notNull()" : ""}${column.default === undefined ? "" : `.default(${column.default})`},`,
34
+ );
35
+ const at = (name: string) => `table[${literal(name)}]`;
36
+ const extras = [
37
+ `primaryKey({ columns: [${shape.key.map(at).join(", ")}] })`,
38
+ ...shape.indexes.flatMap((index) =>
39
+ index.kind === "index"
40
+ ? [
41
+ `${index.unique ? "uniqueIndex" : "index"}(${literal(index.name)}).on(${index.columns.map(at).join(", ")})`,
42
+ ]
43
+ : [],
44
+ ),
45
+ ];
46
+ blocks.push(
47
+ `export const ${shape.name} = ${tableFunction}(${literal(shape.name)}, {\n${columns.join("\n")}\n}, (table) => [\n${extras.map((extra) => ` ${extra},`).join("\n")}\n]);`,
48
+ );
49
+ for (const index of shape.indexes) {
50
+ if (index.kind === "table") emit(index.table);
51
+ }
52
+ };
53
+ for (const shape of sqlTableShapes(dialect, tables)) emit(shape);
54
+ const used = ["customType", "index", "primaryKey", "uniqueIndex"]
55
+ .filter((name) =>
56
+ name === "customType"
57
+ ? true
58
+ : blocks.some((block) => block.includes(`${name}(`)),
59
+ )
60
+ .concat(tableFunction)
61
+ .sort();
62
+ return [
63
+ "// Generated by `hot-updater db generate` from Hot Updater's schema. Do not edit.",
64
+ `import { ${used.join(", ")} } from ${literal(module)};`,
65
+ "",
66
+ "/** A column typed exactly as Hot Updater's SQL schema declares it. */",
67
+ "const column = (type: string) =>",
68
+ " customType<{ data: unknown; driverData: unknown }>({ dataType: () => type });",
69
+ "",
70
+ ...blocks.flatMap((block) => [block, ""]),
71
+ ].join("\n");
72
+ };
@@ -0,0 +1,105 @@
1
+ import type { DatabaseAdapter } from "@hot-updater/plugin-core/internal";
2
+
3
+ import { HOT_UPDATER_SCHEMA_VERSION } from "../core/schema";
4
+ import type { SchemaSettings } from "../database/fence";
5
+ import type { ResolvedSchema } from "../database/resolveSchema";
6
+ import {
7
+ assertSupportedMigrationMode,
8
+ getEmptyMigrationResult,
9
+ } from "./fixedMigratorShared";
10
+ import { migrateSchema } from "./schemaSettings";
11
+ import {
12
+ refusePreEngineDatabase,
13
+ storedSchemaVersion,
14
+ } from "./settingsMigrator";
15
+ import type { MigrateOptions, MigrationResult, Migrator } from "./types";
16
+
17
+ export interface EngineMigratorOptions {
18
+ readonly adapterName: string;
19
+ /** An adapter whose `migrations` create its tables and indexes. */
20
+ readonly adapter: DatabaseAdapter;
21
+ readonly schema: ResolvedSchema;
22
+ readonly settings: SchemaSettings;
23
+ /** Every settings row by key and value, whatever the layout, so an older database is recognized. */
24
+ readonly readSettings: () => Promise<ReadonlyMap<string, unknown>>;
25
+ }
26
+
27
+ /**
28
+ * `hot-updater db migrate` for a store whose adapter creates its own tables
29
+ * (MongoDB and the key-value stores): the tables and indexes, then the
30
+ * settings rows, applied when a setting is missing or different, and refused
31
+ * on a database from before the engine.
32
+ */
33
+ export const createEngineMigrator = (
34
+ options: EngineMigratorOptions,
35
+ ): Migrator => {
36
+ const getVersion = async () =>
37
+ storedSchemaVersion(await options.readSettings());
38
+
39
+ const makeResult = async (
40
+ migrate: MigrateOptions = {},
41
+ ): Promise<MigrationResult> => {
42
+ assertSupportedMigrationMode(migrate);
43
+ const stored = await options.readSettings();
44
+ refusePreEngineDatabase(options.adapterName, stored);
45
+ if (
46
+ Object.entries(options.settings).every(
47
+ ([key, value]) => stored.get(key) === value,
48
+ )
49
+ ) {
50
+ return getEmptyMigrationResult();
51
+ }
52
+ return {
53
+ operations: [
54
+ ...options.schema.tables.map((table) => ({
55
+ type: "create-table" as const,
56
+ value: {
57
+ ormName: table.name,
58
+ columns: Object.fromEntries(
59
+ table.columns.map((column) => [
60
+ column.name,
61
+ { ormName: column.name, type: column.type },
62
+ ]),
63
+ ),
64
+ },
65
+ })),
66
+ ...(migrate.updateSettings === false
67
+ ? []
68
+ : [
69
+ {
70
+ type: "custom" as const,
71
+ description: `Write the schema settings: ${Object.keys(options.settings).join(", ")}`,
72
+ },
73
+ ]),
74
+ ],
75
+ execute: () =>
76
+ migrateSchema(
77
+ options.adapter,
78
+ options.adapterName,
79
+ options.schema.tables,
80
+ options.settings,
81
+ ),
82
+ };
83
+ };
84
+
85
+ return {
86
+ getVersion,
87
+ getNameVariants: async () => undefined,
88
+ next: async () =>
89
+ (await getVersion()) === HOT_UPDATER_SCHEMA_VERSION
90
+ ? undefined
91
+ : { version: HOT_UPDATER_SCHEMA_VERSION },
92
+ previous: async () => undefined,
93
+ up: makeResult,
94
+ down: async () => {
95
+ throw new Error("No previous schema to migrate to.");
96
+ },
97
+ migrateTo: async (version, migrate) => {
98
+ if (version !== HOT_UPDATER_SCHEMA_VERSION) {
99
+ throw new Error(`Invalid version ${version}`);
100
+ }
101
+ return makeResult(migrate);
102
+ },
103
+ migrateToLatest: makeResult,
104
+ };
105
+ };
@@ -0,0 +1,147 @@
1
+ import { SETTINGS_TABLE } from "../database/fence";
2
+ import type { ResolvedSchema } from "../database/resolveSchema";
3
+ import {
4
+ quoteSql,
5
+ sqlTableShapes,
6
+ type SqlColumnShape,
7
+ type SqlTableShape,
8
+ } from "../database/sql/sqlSchema";
9
+
10
+ export type PrismaProvider = "postgresql" | "mysql" | "sqlite";
11
+
12
+ interface PrismaColumn {
13
+ readonly scalar: string;
14
+ /** The native type attribute, such as `@db.VarChar(64)`. */
15
+ readonly native?: string;
16
+ /** Whether `db migrate` sets the column's collation, which Prisma cannot declare. */
17
+ readonly collate?: true;
18
+ }
19
+
20
+ const SCALARS: Readonly<Record<string, string>> = {
21
+ TEXT: "String",
22
+ INTEGER: "BigInt",
23
+ REAL: "Float",
24
+ bigint: "BigInt",
25
+ "double precision": "Float",
26
+ double: "Float",
27
+ boolean: "Boolean",
28
+ jsonb: "Json",
29
+ json: "Json",
30
+ };
31
+
32
+ /**
33
+ * A column's Prisma type from the DDL type the shared SQL schema gives it.
34
+ * MySQL's ASCII keys become `VarBinary`: the same bytes and order as
35
+ * `ascii_bin`, within InnoDB's key limit without a character set.
36
+ */
37
+ const prismaColumn = (
38
+ provider: PrismaProvider,
39
+ { type }: SqlColumnShape,
40
+ ): PrismaColumn => {
41
+ const length = /^varchar\((\d+)\)/u.exec(type)?.[1];
42
+ if (provider === "mysql" && type.includes("CHARACTER SET")) {
43
+ if (type.includes("CHARACTER SET ascii") && length) {
44
+ return { scalar: "Bytes", native: `@db.VarBinary(${length})` };
45
+ }
46
+ return {
47
+ scalar: "String",
48
+ native: length ? `@db.VarChar(${length})` : "@db.LongText",
49
+ collate: true,
50
+ };
51
+ }
52
+ if (provider === "postgresql" && type.includes("COLLATE")) {
53
+ return {
54
+ scalar: "String",
55
+ ...(length ? { native: `@db.VarChar(${length})` } : {}),
56
+ collate: true,
57
+ };
58
+ }
59
+ return { scalar: SCALARS[type] ?? "String" };
60
+ };
61
+
62
+ /** Prisma fields start with a letter: `_v` becomes `hu_v`, mapped back to `_v`. */
63
+ const fieldName = (column: string) =>
64
+ column.startsWith("_") ? `hu${column}` : column;
65
+
66
+ const list = (columns: readonly string[]) =>
67
+ `[${columns.map(fieldName).join(", ")}]`;
68
+
69
+ const flatten = (shapes: readonly SqlTableShape[]): SqlTableShape[] =>
70
+ shapes.flatMap((shape) => [
71
+ shape,
72
+ ...flatten(
73
+ shape.indexes.flatMap((index) =>
74
+ index.kind === "table" ? [index.table] : [],
75
+ ),
76
+ ),
77
+ ]);
78
+
79
+ const shapesOf = (provider: PrismaProvider, schema: ResolvedSchema) =>
80
+ flatten(sqlTableShapes(provider, [...schema.tables, SETTINGS_TABLE]));
81
+
82
+ const renderField = (provider: PrismaProvider, column: SqlColumnShape) => {
83
+ const { scalar, native } = prismaColumn(provider, column);
84
+ const name = fieldName(column.name);
85
+ return [
86
+ `${name} ${scalar}${column.notNull ? "" : "?"}`,
87
+ ...(native === undefined ? [] : [native]),
88
+ ...(column.default === undefined ? [] : [`@default(${column.default})`]),
89
+ ...(name === column.name ? [] : [`@map(${JSON.stringify(column.name)})`]),
90
+ ].join(" ");
91
+ };
92
+
93
+ /**
94
+ * Hot Updater's tables as Prisma models, for `prisma db push` or
95
+ * `prisma migrate`: keys, indexes, index tables, and the settings table.
96
+ * The engine keeps references itself, so the models have no relations.
97
+ */
98
+ export const generatePrismaEngineSchema = (
99
+ provider: PrismaProvider,
100
+ schema: ResolvedSchema,
101
+ ): string =>
102
+ shapesOf(provider, schema)
103
+ .map((shape) => {
104
+ const lines = [
105
+ ...shape.columns.map((column) => renderField(provider, column)),
106
+ `@@id(${list(shape.key)})`,
107
+ ...shape.indexes.flatMap((index) =>
108
+ index.kind === "index"
109
+ ? [
110
+ `@@${index.unique ? "unique" : "index"}(${list(index.columns)}, map: ${JSON.stringify(index.name)})`,
111
+ ]
112
+ : [],
113
+ ),
114
+ ];
115
+ return `model ${shape.name} {\n${lines.map((line) => ` ${line}`).join("\n")}\n}`;
116
+ })
117
+ .join("\n\n");
118
+
119
+ /**
120
+ * The collations Prisma cannot declare, which `hot-updater db migrate` sets
121
+ * after Prisma created the tables: `COLLATE "C"` on PostgreSQL and binary
122
+ * UTF-8 on MySQL, so strings compare by their bytes as the engine expects.
123
+ * The settings table is only read by key, and the migrator has already read
124
+ * it: altering it would invalidate PostgreSQL's cached plan for that read.
125
+ */
126
+ export const prismaCollationStatements = (
127
+ provider: PrismaProvider,
128
+ schema: ResolvedSchema,
129
+ ): string[] => {
130
+ if (provider !== "postgresql" && provider !== "mysql") return [];
131
+ const quote = (name: string) => quoteSql(provider, name);
132
+ const tables = shapesOf(provider, schema).filter(
133
+ (shape) => shape.name !== SETTINGS_TABLE.name,
134
+ );
135
+ return tables.flatMap((shape) => {
136
+ const changes = shape.columns
137
+ .filter((column) => prismaColumn(provider, column).collate)
138
+ .map((column) =>
139
+ provider === "postgresql"
140
+ ? `ALTER COLUMN ${quote(column.name)} TYPE ${column.type}`
141
+ : `MODIFY ${quote(column.name)} ${column.type}${column.notNull ? " NOT NULL" : " NULL"}`,
142
+ );
143
+ return changes.length === 0
144
+ ? []
145
+ : [`ALTER TABLE ${quote(shape.name)} ${changes.join(", ")}`];
146
+ });
147
+ };
@@ -0,0 +1,129 @@
1
+ import { DatabaseSync } from "node:sqlite";
2
+
3
+ import { PGlite } from "@electric-sql/pglite";
4
+ import { afterAll, describe, expect, it } from "vitest";
5
+
6
+ import { createBundleFixture } from "../../../test-utils/src/databaseTestFixtures";
7
+ import { createInProcessCoreApi } from "../core/api";
8
+ import { createSqlAdapter } from "../database/sql/sqlAdapter";
9
+ import {
10
+ createTableStatements,
11
+ sqlTableShapes,
12
+ type SqlTableShape,
13
+ } from "../database/sql/sqlSchema";
14
+ import {
15
+ pgliteExecutor,
16
+ sqliteExecutor,
17
+ } from "../database/sql/sqlTestExecutors";
18
+ import {
19
+ builtInSchema,
20
+ builtInSettings,
21
+ createEngineDatabase,
22
+ } from "./builtInDatabase";
23
+ import { generateEngineSql } from "./engineSql";
24
+
25
+ const sql = (dialect: "postgresql" | "mysql" | "sqlite") =>
26
+ generateEngineSql(dialect, builtInSchema, builtInSettings);
27
+
28
+ describe("the shared SQL schema", () => {
29
+ it("defaults engine columns, has no foreign keys, and writes the settings last", () => {
30
+ const postgres = sql("postgresql");
31
+ expect(
32
+ postgres.find((statement) => statement.includes('"bundles" (')),
33
+ ).toContain(
34
+ '"_refs_releases_bundle_id" bigint NOT NULL DEFAULT 0, "_v" bigint NOT NULL DEFAULT 0',
35
+ );
36
+ for (const dialect of ["postgresql", "mysql", "sqlite"] as const) {
37
+ expect(
38
+ sql(dialect).some(
39
+ (statement) =>
40
+ statement.includes("FOREIGN KEY") ||
41
+ statement.startsWith("ALTER TABLE"),
42
+ ),
43
+ ).toBe(false);
44
+ }
45
+ expect(
46
+ postgres
47
+ .slice(-4)
48
+ .every((statement) =>
49
+ statement.startsWith('INSERT INTO "private_hot_updater_settings"'),
50
+ ),
51
+ ).toBe(true);
52
+ expect(sql("mysql").at(-1)).toContain("ON DUPLICATE KEY UPDATE");
53
+ });
54
+
55
+ it("describes each table as its DDL creates it, for ORM schema generators", () => {
56
+ const tables = builtInSchema.tables;
57
+ const names = (shapes: readonly SqlTableShape[]): string[] =>
58
+ shapes.flatMap((shape) => [
59
+ shape.name,
60
+ ...names(
61
+ shape.indexes.flatMap((index) =>
62
+ index.kind === "table" ? [index.table] : [],
63
+ ),
64
+ ),
65
+ ]);
66
+ const created = createTableStatements("postgresql", tables).flatMap(
67
+ (statement) =>
68
+ statement.match(/^CREATE TABLE IF NOT EXISTS "(\w+)"/u)?.[1] ?? [],
69
+ );
70
+ const shapes = sqlTableShapes("postgresql", tables);
71
+ expect(names(shapes)).toEqual(created);
72
+ expect(created.some((name) => name.includes("__"))).toBe(true);
73
+ expect(
74
+ shapes
75
+ .find((shape) => shape.name === "bundles")
76
+ ?.columns.find((column) => column.name === "_v"),
77
+ ).toEqual({ name: "_v", type: "bigint", notNull: true, default: 0 });
78
+ });
79
+
80
+ const pglite = new PGlite();
81
+ afterAll(() => pglite.close());
82
+
83
+ it("runs twice on PostgreSQL and passes the fence; the engine keeps references", async () => {
84
+ for (let run = 0; run < 2; run += 1) {
85
+ await pglite.exec(sql("postgresql").join(";\n"));
86
+ }
87
+ const core = createInProcessCoreApi(
88
+ createEngineDatabase({
89
+ name: "pglite",
90
+ adapter: createSqlAdapter({ executor: pgliteExecutor(pglite) }),
91
+ }).adapter,
92
+ );
93
+ const bundle = createBundleFixture("1");
94
+ await core.deploy([
95
+ {
96
+ bundle,
97
+ release: {
98
+ channel: "production",
99
+ enabled: true,
100
+ fingerprintHash: null,
101
+ message: null,
102
+ shouldForceUpdate: false,
103
+ targetAppVersion: "1.0.0",
104
+ },
105
+ },
106
+ ]);
107
+
108
+ await expect(core.deleteBundles([bundle.id])).rejects.toThrow(
109
+ "still referenced",
110
+ );
111
+ const { rows } = await pglite.query<{ count: number }>(
112
+ "SELECT count(*)::int AS count FROM information_schema.table_constraints WHERE constraint_type = 'FOREIGN KEY'",
113
+ );
114
+ expect(rows[0]!.count).toBe(0);
115
+ });
116
+
117
+ it("runs on SQLite and passes the fence", async () => {
118
+ const db = new DatabaseSync(":memory:");
119
+ for (const statement of sql("sqlite")) db.exec(statement);
120
+ const core = createInProcessCoreApi(
121
+ createEngineDatabase({
122
+ name: "sqlite",
123
+ adapter: createSqlAdapter({ executor: sqliteExecutor(db) }),
124
+ }).adapter,
125
+ );
126
+ await expect(core.listChannels()).resolves.toEqual([]);
127
+ db.close();
128
+ });
129
+ });