@hot-updater/server 1.0.0-rc.18 → 1.0.0-rc.21

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 (485) hide show
  1. package/LICENSE +12 -14
  2. package/dist/adapters/drizzle.cjs +6 -8
  3. package/dist/adapters/drizzle.d.cts +2 -2
  4. package/dist/adapters/drizzle.d.mts +2 -2
  5. package/dist/adapters/drizzle.mjs +1 -3
  6. package/dist/adapters/drizzleExecutor.d.cts +1 -1
  7. package/dist/adapters/drizzleExecutor.d.mts +1 -1
  8. package/dist/adapters/kysely.cjs +4 -6
  9. package/dist/adapters/kysely.d.cts +3 -3
  10. package/dist/adapters/kysely.d.mts +3 -3
  11. package/dist/adapters/kysely.mjs +1 -3
  12. package/dist/adapters/kyselyExecutor.d.cts +1 -2
  13. package/dist/adapters/kyselyExecutor.d.mts +1 -2
  14. package/dist/adapters/mongodb.cjs +10 -21
  15. package/dist/adapters/mongodb.d.cts +1 -1
  16. package/dist/adapters/mongodb.d.mts +1 -1
  17. package/dist/adapters/mongodb.mjs +9 -20
  18. package/dist/adapters/mongodbAdapter.cjs +11 -11
  19. package/dist/adapters/mongodbAdapter.d.cts +1 -1
  20. package/dist/adapters/mongodbAdapter.d.mts +1 -1
  21. package/dist/adapters/mongodbAdapter.mjs +1 -1
  22. package/dist/adapters/prisma.cjs +7 -9
  23. package/dist/adapters/prisma.d.cts +1 -1
  24. package/dist/adapters/prisma.d.mts +1 -1
  25. package/dist/adapters/prisma.mjs +1 -3
  26. package/dist/adapters/prismaExecutor.cjs +2 -3
  27. package/dist/adapters/prismaExecutor.mjs +1 -2
  28. package/dist/adapters/sqlProviders.cjs +7 -2
  29. package/dist/adapters/sqlProviders.mjs +6 -1
  30. package/dist/assembly/assemblePlugins.cjs +26 -48
  31. package/dist/assembly/assemblePlugins.d.cts +2 -5
  32. package/dist/assembly/assemblePlugins.d.mts +2 -5
  33. package/dist/assembly/assemblePlugins.mjs +19 -45
  34. package/dist/assembly/clientPlugins.cjs +6 -4
  35. package/dist/assembly/clientPlugins.mjs +2 -0
  36. package/dist/assembly/configError.d.cts +1 -6
  37. package/dist/assembly/configError.d.mts +1 -6
  38. package/dist/assembly/configError.mjs +1 -6
  39. package/dist/core/api.cjs +0 -40
  40. package/dist/core/api.d.cts +5 -16
  41. package/dist/core/api.d.mts +5 -16
  42. package/dist/core/api.mjs +1 -37
  43. package/dist/core/baseCandidates.cjs +0 -43
  44. package/dist/core/baseCandidates.mjs +2 -43
  45. package/dist/core/operations.cjs +13 -12
  46. package/dist/core/operations.mjs +6 -5
  47. package/dist/core/reads.cjs +4 -4
  48. package/dist/core/reads.d.cts +2 -41
  49. package/dist/core/reads.d.mts +2 -41
  50. package/dist/core/reads.mjs +3 -3
  51. package/dist/core/releases.cjs +6 -6
  52. package/dist/core/releases.mjs +1 -1
  53. package/dist/core/writes.cjs +2 -2
  54. package/dist/core/writes.mjs +1 -1
  55. package/dist/createHotUpdaterCore.cjs +39 -39
  56. package/dist/createHotUpdaterCore.d.cts +61 -8
  57. package/dist/createHotUpdaterCore.d.mts +61 -8
  58. package/dist/createHotUpdaterCore.mjs +35 -32
  59. package/dist/db/engineDrizzleSchema.cjs +3 -4
  60. package/dist/db/engineDrizzleSchema.mjs +1 -2
  61. package/dist/db/enginePrismaSchema.cjs +4 -5
  62. package/dist/db/enginePrismaSchema.d.cts +1 -1
  63. package/dist/db/enginePrismaSchema.d.mts +1 -1
  64. package/dist/db/enginePrismaSchema.mjs +1 -2
  65. package/dist/db/releaseCatalog.cjs +6 -6
  66. package/dist/db/releaseCatalog.mjs +1 -1
  67. package/dist/db/updateArtifacts.cjs +6 -6
  68. package/dist/db/updateArtifacts.mjs +1 -1
  69. package/dist/handler.cjs +3 -4
  70. package/dist/handler.mjs +1 -1
  71. package/dist/handlerAdminRoutes.cjs +1 -2
  72. package/dist/handlerAdminRoutes.mjs +1 -2
  73. package/dist/handlerVersionRoutes.cjs +2 -2
  74. package/dist/handlerVersionRoutes.mjs +2 -2
  75. package/dist/index.cjs +9 -2
  76. package/dist/index.d.cts +4 -3
  77. package/dist/index.d.mts +4 -3
  78. package/dist/index.mjs +2 -1
  79. package/dist/node.cjs +3 -6
  80. package/dist/node.d.cts +3 -3
  81. package/dist/node.d.mts +3 -3
  82. package/dist/node.mjs +4 -4
  83. package/dist/package.cjs +1 -1
  84. package/dist/package.mjs +1 -1
  85. package/dist/plugins/api-keys/index.cjs +8 -52
  86. package/dist/plugins/api-keys/index.d.cts +1 -84
  87. package/dist/plugins/api-keys/index.d.mts +1 -84
  88. package/dist/plugins/api-keys/index.mjs +2 -49
  89. package/dist/plugins/definePlugin.d.cts +2 -200
  90. package/dist/plugins/definePlugin.d.mts +2 -200
  91. package/dist/plugins/insights/index.cjs +7 -126
  92. package/dist/plugins/insights/index.d.cts +1 -398
  93. package/dist/plugins/insights/index.d.mts +1 -398
  94. package/dist/plugins/insights/index.mjs +2 -121
  95. package/dist/plugins/official.cjs +30 -0
  96. package/dist/plugins/official.mjs +29 -0
  97. package/dist/storageAccess.cjs +13 -10
  98. package/dist/storageAccess.mjs +13 -10
  99. package/dist/types/index.d.cts +1 -1
  100. package/dist/types/index.d.mts +1 -1
  101. package/package.json +15 -37
  102. package/dist/_virtual/_rolldown/runtime.cjs +0 -23
  103. package/dist/assembly/clientPlugins.d.cts +0 -16
  104. package/dist/assembly/clientPlugins.d.mts +0 -16
  105. package/dist/assembly/configError.cjs +0 -7
  106. package/dist/assembly/databasePlugins.cjs +0 -27
  107. package/dist/assembly/databasePlugins.d.cts +0 -43
  108. package/dist/assembly/databasePlugins.d.mts +0 -43
  109. package/dist/assembly/databasePlugins.mjs +0 -26
  110. package/dist/assembly/pluginCli.cjs +0 -125
  111. package/dist/assembly/pluginCli.d.cts +0 -59
  112. package/dist/assembly/pluginCli.d.mts +0 -59
  113. package/dist/assembly/pluginCli.mjs +0 -121
  114. package/dist/core/baseCandidates.d.cts +0 -17
  115. package/dist/core/baseCandidates.d.mts +0 -17
  116. package/dist/core/schema.cjs +0 -279
  117. package/dist/core/schema.d.cts +0 -307
  118. package/dist/core/schema.d.mts +0 -307
  119. package/dist/core/schema.mjs +0 -277
  120. package/dist/database/aggregateBatching.cjs +0 -626
  121. package/dist/database/aggregateBatching.d.cts +0 -10
  122. package/dist/database/aggregateBatching.d.mts +0 -10
  123. package/dist/database/aggregateBatching.mjs +0 -625
  124. package/dist/database/busy.cjs +0 -36
  125. package/dist/database/busy.d.cts +0 -12
  126. package/dist/database/busy.d.mts +0 -12
  127. package/dist/database/busy.mjs +0 -36
  128. package/dist/database/cursor.cjs +0 -44
  129. package/dist/database/cursor.d.cts +0 -7
  130. package/dist/database/cursor.d.mts +0 -7
  131. package/dist/database/cursor.mjs +0 -40
  132. package/dist/database/database.cjs +0 -63
  133. package/dist/database/database.d.cts +0 -136
  134. package/dist/database/database.d.mts +0 -136
  135. package/dist/database/database.mjs +0 -63
  136. package/dist/database/definitions.d.cts +0 -78
  137. package/dist/database/definitions.d.mts +0 -78
  138. package/dist/database/engine.cjs +0 -37
  139. package/dist/database/engine.d.cts +0 -41
  140. package/dist/database/engine.d.mts +0 -41
  141. package/dist/database/engine.mjs +0 -37
  142. package/dist/database/engineAggregates.cjs +0 -118
  143. package/dist/database/engineAggregates.mjs +0 -115
  144. package/dist/database/engineReads.cjs +0 -182
  145. package/dist/database/engineReads.d.cts +0 -35
  146. package/dist/database/engineReads.d.mts +0 -35
  147. package/dist/database/engineReads.mjs +0 -181
  148. package/dist/database/engineTransaction.cjs +0 -399
  149. package/dist/database/engineTransaction.d.cts +0 -26
  150. package/dist/database/engineTransaction.d.mts +0 -26
  151. package/dist/database/engineTransaction.mjs +0 -398
  152. package/dist/database/errors.cjs +0 -27
  153. package/dist/database/errors.d.cts +0 -21
  154. package/dist/database/errors.d.mts +0 -21
  155. package/dist/database/errors.mjs +0 -24
  156. package/dist/database/fence.cjs +0 -125
  157. package/dist/database/fence.d.cts +0 -42
  158. package/dist/database/fence.d.mts +0 -42
  159. package/dist/database/fence.mjs +0 -117
  160. package/dist/database/index.cjs +0 -136
  161. package/dist/database/index.d.cts +0 -18
  162. package/dist/database/index.d.mts +0 -18
  163. package/dist/database/index.mjs +0 -16
  164. package/dist/database/kv/kvAdapter.cjs +0 -285
  165. package/dist/database/kv/kvAdapter.d.cts +0 -109
  166. package/dist/database/kv/kvAdapter.d.mts +0 -109
  167. package/dist/database/kv/kvAdapter.mjs +0 -284
  168. package/dist/database/resolveSchema.cjs +0 -199
  169. package/dist/database/resolveSchema.d.cts +0 -42
  170. package/dist/database/resolveSchema.d.mts +0 -42
  171. package/dist/database/resolveSchema.mjs +0 -196
  172. package/dist/database/retention.cjs +0 -92
  173. package/dist/database/retention.mjs +0 -90
  174. package/dist/database/schema.cjs +0 -24
  175. package/dist/database/schema.d.cts +0 -90
  176. package/dist/database/schema.d.mts +0 -90
  177. package/dist/database/schema.mjs +0 -23
  178. package/dist/database/sql/sqlAdapter.cjs +0 -290
  179. package/dist/database/sql/sqlAdapter.d.cts +0 -46
  180. package/dist/database/sql/sqlAdapter.d.mts +0 -46
  181. package/dist/database/sql/sqlAdapter.mjs +0 -287
  182. package/dist/database/sql/sqlSchema.cjs +0 -171
  183. package/dist/database/sql/sqlSchema.d.cts +0 -8
  184. package/dist/database/sql/sqlSchema.d.mts +0 -8
  185. package/dist/database/sql/sqlSchema.mjs +0 -165
  186. package/dist/db/coreDatabase.cjs +0 -85
  187. package/dist/db/coreDatabase.d.cts +0 -57
  188. package/dist/db/coreDatabase.d.mts +0 -57
  189. package/dist/db/coreDatabase.mjs +0 -78
  190. package/dist/db/createBundleDiff.cjs +0 -144
  191. package/dist/db/createBundleDiff.d.cts +0 -17
  192. package/dist/db/createBundleDiff.d.mts +0 -17
  193. package/dist/db/createBundleDiff.mjs +0 -141
  194. package/dist/db/engineMigrator.cjs +0 -53
  195. package/dist/db/engineMigrator.mjs +0 -53
  196. package/dist/db/engineSql.cjs +0 -26
  197. package/dist/db/engineSql.d.cts +0 -17
  198. package/dist/db/engineSql.d.mts +0 -17
  199. package/dist/db/engineSql.mjs +0 -25
  200. package/dist/db/engineSqlMigrator.cjs +0 -66
  201. package/dist/db/engineSqlMigrator.mjs +0 -66
  202. package/dist/db/fixedMigratorShared.cjs +0 -12
  203. package/dist/db/fixedMigratorShared.mjs +0 -11
  204. package/dist/db/index.cjs +0 -50
  205. package/dist/db/index.d.cts +0 -23
  206. package/dist/db/index.d.mts +0 -23
  207. package/dist/db/index.mjs +0 -33
  208. package/dist/db/releaseCatalog.d.cts +0 -16
  209. package/dist/db/releaseCatalog.d.mts +0 -16
  210. package/dist/db/schemaSettings.cjs +0 -63
  211. package/dist/db/schemaSettings.d.cts +0 -12
  212. package/dist/db/schemaSettings.d.mts +0 -12
  213. package/dist/db/schemaSettings.mjs +0 -62
  214. package/dist/db/settingsMigrator.cjs +0 -92
  215. package/dist/db/settingsMigrator.mjs +0 -89
  216. package/dist/db/types.cjs +0 -11
  217. package/dist/db/types.d.cts +0 -78
  218. package/dist/db/types.d.mts +0 -78
  219. package/dist/db/types.mjs +0 -10
  220. package/dist/diff.cjs +0 -3
  221. package/dist/diff.d.cts +0 -2
  222. package/dist/diff.d.mts +0 -2
  223. package/dist/diff.mjs +0 -2
  224. package/dist/plugins/api-keys/apiKeys.cjs +0 -139
  225. package/dist/plugins/api-keys/apiKeys.d.cts +0 -27
  226. package/dist/plugins/api-keys/apiKeys.d.mts +0 -27
  227. package/dist/plugins/api-keys/apiKeys.mjs +0 -129
  228. package/dist/plugins/api-keys/cli.cjs +0 -115
  229. package/dist/plugins/api-keys/cli.mjs +0 -114
  230. package/dist/plugins/api-keys/model.cjs +0 -58
  231. package/dist/plugins/api-keys/model.d.cts +0 -26
  232. package/dist/plugins/api-keys/model.d.mts +0 -26
  233. package/dist/plugins/api-keys/model.mjs +0 -58
  234. package/dist/plugins/api-keys/schema.cjs +0 -38
  235. package/dist/plugins/api-keys/schema.d.cts +0 -44
  236. package/dist/plugins/api-keys/schema.d.mts +0 -44
  237. package/dist/plugins/api-keys/schema.mjs +0 -39
  238. package/dist/plugins/definePlugin.cjs +0 -5
  239. package/dist/plugins/definePlugin.mjs +0 -5
  240. package/dist/plugins/index.cjs +0 -38
  241. package/dist/plugins/index.d.cts +0 -12
  242. package/dist/plugins/index.d.mts +0 -12
  243. package/dist/plugins/index.mjs +0 -9
  244. package/dist/plugins/insights/contract.cjs +0 -193
  245. package/dist/plugins/insights/contract.mjs +0 -189
  246. package/dist/plugins/insights/domain.d.cts +0 -149
  247. package/dist/plugins/insights/domain.d.mts +0 -149
  248. package/dist/plugins/insights/errors.cjs +0 -15
  249. package/dist/plugins/insights/errors.mjs +0 -14
  250. package/dist/plugins/insights/eventInput.cjs +0 -284
  251. package/dist/plugins/insights/eventInput.mjs +0 -282
  252. package/dist/plugins/insights/eventRow.cjs +0 -49
  253. package/dist/plugins/insights/eventRow.d.cts +0 -64
  254. package/dist/plugins/insights/eventRow.d.mts +0 -64
  255. package/dist/plugins/insights/eventRow.mjs +0 -47
  256. package/dist/plugins/insights/model.cjs +0 -17
  257. package/dist/plugins/insights/model.d.cts +0 -10
  258. package/dist/plugins/insights/model.d.mts +0 -10
  259. package/dist/plugins/insights/model.mjs +0 -17
  260. package/dist/plugins/insights/modelTypes.d.cts +0 -176
  261. package/dist/plugins/insights/modelTypes.d.mts +0 -176
  262. package/dist/plugins/insights/overview.cjs +0 -109
  263. package/dist/plugins/insights/overview.d.cts +0 -15
  264. package/dist/plugins/insights/overview.d.mts +0 -15
  265. package/dist/plugins/insights/overview.mjs +0 -107
  266. package/dist/plugins/insights/provider.cjs +0 -375
  267. package/dist/plugins/insights/provider.d.cts +0 -6
  268. package/dist/plugins/insights/provider.d.mts +0 -6
  269. package/dist/plugins/insights/provider.mjs +0 -374
  270. package/dist/plugins/insights/queryInput.cjs +0 -93
  271. package/dist/plugins/insights/queryInput.mjs +0 -91
  272. package/dist/plugins/insights/reads.cjs +0 -681
  273. package/dist/plugins/insights/reads.d.cts +0 -61
  274. package/dist/plugins/insights/reads.d.mts +0 -61
  275. package/dist/plugins/insights/reads.mjs +0 -674
  276. package/dist/plugins/insights/recordEvent.cjs +0 -319
  277. package/dist/plugins/insights/recordEvent.d.cts +0 -18
  278. package/dist/plugins/insights/recordEvent.d.mts +0 -18
  279. package/dist/plugins/insights/recordEvent.mjs +0 -316
  280. package/dist/plugins/insights/routes.cjs +0 -96
  281. package/dist/plugins/insights/routes.mjs +0 -95
  282. package/dist/plugins/insights/schema.cjs +0 -489
  283. package/dist/plugins/insights/schema.d.cts +0 -698
  284. package/dist/plugins/insights/schema.d.mts +0 -698
  285. package/dist/plugins/insights/schema.mjs +0 -483
  286. package/dist/plugins/insights/testing/eventRow.d.mts +0 -64
  287. package/dist/plugins/insights/testing/expectInsightsIndex.mjs +0 -18
  288. package/dist/plugins/insights/testing/fixtures.d.mts +0 -8
  289. package/dist/plugins/insights/testing/fixtures.mjs +0 -25
  290. package/dist/plugins/insights/testing/index.d.mts +0 -24
  291. package/dist/plugins/insights/testing/index.mjs +0 -25
  292. package/dist/plugins/insights/testing/insightsModelTests.mjs +0 -714
  293. package/dist/plugins/insights/testing/modelTypes.d.mts +0 -176
  294. package/dist/plugins/insights/testing/setupInsightsHttpTestSuite.d.mts +0 -11
  295. package/dist/plugins/insights/testing/setupInsightsHttpTestSuite.mjs +0 -107
  296. package/dist/plugins/insights/testing/setupInsightsModelTestSuite.d.mts +0 -11
  297. package/dist/plugins/insights/testing/setupInsightsModelTestSuite.mjs +0 -31
  298. package/dist/plugins/insights/testing/types.d.mts +0 -26
  299. package/dist/plugins/insights/types.d.cts +0 -33
  300. package/dist/plugins/insights/types.d.mts +0 -33
  301. package/src/adapters/drizzle.conformance.integration.spec.ts +0 -34
  302. package/src/adapters/drizzle.readBudgets.integration.spec.ts +0 -43
  303. package/src/adapters/drizzle.spec.ts +0 -314
  304. package/src/adapters/drizzle.ts +0 -64
  305. package/src/adapters/drizzleExecutor.ts +0 -166
  306. package/src/adapters/kysely.conformance.integration.spec.ts +0 -36
  307. package/src/adapters/kysely.readBudgets.integration.spec.ts +0 -44
  308. package/src/adapters/kysely.spec.ts +0 -244
  309. package/src/adapters/kysely.ts +0 -46
  310. package/src/adapters/kyselyExecutor.ts +0 -53
  311. package/src/adapters/mongodb.integration.spec.ts +0 -271
  312. package/src/adapters/mongodb.readBudgets.integration.spec.ts +0 -61
  313. package/src/adapters/mongodb.ts +0 -45
  314. package/src/adapters/mongodbAdapter.ts +0 -307
  315. package/src/adapters/prisma.conformance.integration.spec.ts +0 -36
  316. package/src/adapters/prisma.integration.spec.ts +0 -146
  317. package/src/adapters/prisma.readBudgets.integration.spec.ts +0 -43
  318. package/src/adapters/prisma.spec.ts +0 -257
  319. package/src/adapters/prisma.ts +0 -74
  320. package/src/adapters/prismaExecutor.ts +0 -107
  321. package/src/adapters/prismaTestClients.ts +0 -182
  322. package/src/adapters/sqlProviders.ts +0 -14
  323. package/src/assembly/assemblePlugins.ts +0 -302
  324. package/src/assembly/assembly.spec.ts +0 -377
  325. package/src/assembly/assembly.types.spec.ts +0 -203
  326. package/src/assembly/clientPlugins.ts +0 -113
  327. package/src/assembly/configError.ts +0 -4
  328. package/src/assembly/databasePlugins.spec.ts +0 -71
  329. package/src/assembly/databasePlugins.ts +0 -102
  330. package/src/assembly/pluginCli.spec.ts +0 -254
  331. package/src/assembly/pluginCli.ts +0 -248
  332. package/src/assembly/pluginRoutes.spec.ts +0 -186
  333. package/src/core/api.ts +0 -139
  334. package/src/core/baseCandidates.spec.ts +0 -378
  335. package/src/core/baseCandidates.ts +0 -136
  336. package/src/core/index.ts +0 -44
  337. package/src/core/operations.spec.ts +0 -415
  338. package/src/core/operations.ts +0 -551
  339. package/src/core/reads.spec.ts +0 -300
  340. package/src/core/reads.ts +0 -417
  341. package/src/core/releases.spec.ts +0 -308
  342. package/src/core/releases.ts +0 -345
  343. package/src/core/schema.ts +0 -173
  344. package/src/core/writes.ts +0 -160
  345. package/src/createHotUpdaterCore.ts +0 -260
  346. package/src/database/aggregateBatching.spec.ts +0 -577
  347. package/src/database/aggregateBatching.ts +0 -803
  348. package/src/database/busy.spec.ts +0 -45
  349. package/src/database/busy.ts +0 -50
  350. package/src/database/cursor.ts +0 -65
  351. package/src/database/database.ts +0 -366
  352. package/src/database/database.types.spec.ts +0 -135
  353. package/src/database/definitions.ts +0 -76
  354. package/src/database/engine.ts +0 -62
  355. package/src/database/engineAggregates.spec.ts +0 -536
  356. package/src/database/engineAggregates.ts +0 -189
  357. package/src/database/engineReads.spec.ts +0 -219
  358. package/src/database/engineReads.ts +0 -304
  359. package/src/database/engineTransaction.spec.ts +0 -710
  360. package/src/database/engineTransaction.ts +0 -582
  361. package/src/database/errors.ts +0 -30
  362. package/src/database/fence.spec.ts +0 -223
  363. package/src/database/fence.ts +0 -175
  364. package/src/database/index.ts +0 -160
  365. package/src/database/kv/kvAdapter.batching.integration.spec.ts +0 -15
  366. package/src/database/kv/kvAdapter.conformance.integration.spec.ts +0 -19
  367. package/src/database/kv/kvAdapter.readBudgets.integration.spec.ts +0 -17
  368. package/src/database/kv/kvAdapter.spec.ts +0 -595
  369. package/src/database/kv/kvAdapter.ts +0 -479
  370. package/src/database/kv/kvTestStore.ts +0 -118
  371. package/src/database/memory.readBudgets.integration.spec.ts +0 -13
  372. package/src/database/resolveSchema.spec.ts +0 -230
  373. package/src/database/resolveSchema.ts +0 -375
  374. package/src/database/retention.spec.ts +0 -314
  375. package/src/database/retention.ts +0 -129
  376. package/src/database/schema.ts +0 -213
  377. package/src/database/schema.types.spec.ts +0 -94
  378. package/src/database/sql/docker-compose.yml +0 -36
  379. package/src/database/sql/sqlAdapter.integration.spec.ts +0 -145
  380. package/src/database/sql/sqlAdapter.readBudgets.integration.spec.ts +0 -123
  381. package/src/database/sql/sqlAdapter.spec.ts +0 -343
  382. package/src/database/sql/sqlAdapter.ts +0 -552
  383. package/src/database/sql/sqlSchema.ts +0 -286
  384. package/src/database/sql/sqlTestExecutors.ts +0 -183
  385. package/src/databaseTestSuite.spec.ts +0 -44
  386. package/src/db/bundleRows.spec.ts +0 -164
  387. package/src/db/bundleRows.ts +0 -10
  388. package/src/db/coreDatabase.ts +0 -153
  389. package/src/db/createBundleDiff.spec.ts +0 -464
  390. package/src/db/createBundleDiff.ts +0 -370
  391. package/src/db/engineDrizzleSchema.ts +0 -72
  392. package/src/db/engineMigrator.ts +0 -105
  393. package/src/db/enginePrismaSchema.ts +0 -147
  394. package/src/db/engineSql.spec.ts +0 -130
  395. package/src/db/engineSql.ts +0 -48
  396. package/src/db/engineSqlMigrator.ts +0 -116
  397. package/src/db/fixedMigratorShared.ts +0 -17
  398. package/src/db/index.spec.ts +0 -554
  399. package/src/db/index.ts +0 -93
  400. package/src/db/node-sqlite.d.ts +0 -25
  401. package/src/db/pluginTables.spec.ts +0 -248
  402. package/src/db/releaseCatalog.ts +0 -106
  403. package/src/db/schemaSettings.ts +0 -104
  404. package/src/db/settingsMigrator.spec.ts +0 -65
  405. package/src/db/settingsMigrator.ts +0 -152
  406. package/src/db/types.ts +0 -82
  407. package/src/db/updateArtifacts.spec.ts +0 -235
  408. package/src/db/updateArtifacts.ts +0 -473
  409. package/src/db/updateCheck.bench.ts +0 -47
  410. package/src/diff.ts +0 -6
  411. package/src/handler-standalone.integration.spec.ts +0 -321
  412. package/src/handler.spec.ts +0 -273
  413. package/src/handler.testFixtures.ts +0 -25
  414. package/src/handler.ts +0 -302
  415. package/src/handlerAdminRoutes.spec.ts +0 -183
  416. package/src/handlerAdminRoutes.ts +0 -536
  417. package/src/handlerAuth.integration.spec.ts +0 -33
  418. package/src/handlerErrors.ts +0 -7
  419. package/src/handlerManagement.spec.ts +0 -202
  420. package/src/handlerParameters.ts +0 -105
  421. package/src/handlerReleaseCatalogRoutes.ts +0 -176
  422. package/src/handlerTypes.ts +0 -19
  423. package/src/handlerVersionRoutes.ts +0 -25
  424. package/src/index.ts +0 -13
  425. package/src/internalRouter.ts +0 -104
  426. package/src/lintRules.spec.ts +0 -76
  427. package/src/node.spec.ts +0 -119
  428. package/src/node.ts +0 -111
  429. package/src/plugins/api-keys/apiKeys.integration.spec.ts +0 -92
  430. package/src/plugins/api-keys/apiKeys.spec.ts +0 -166
  431. package/src/plugins/api-keys/apiKeys.ts +0 -214
  432. package/src/plugins/api-keys/apiKeysPlugin.spec.ts +0 -168
  433. package/src/plugins/api-keys/cli.spec.ts +0 -187
  434. package/src/plugins/api-keys/cli.ts +0 -140
  435. package/src/plugins/api-keys/index.ts +0 -73
  436. package/src/plugins/api-keys/model.ts +0 -88
  437. package/src/plugins/api-keys/schema.ts +0 -22
  438. package/src/plugins/definePlugin.ts +0 -242
  439. package/src/plugins/index.ts +0 -73
  440. package/src/plugins/insights/contract.spec.ts +0 -285
  441. package/src/plugins/insights/contract.ts +0 -372
  442. package/src/plugins/insights/domain.ts +0 -176
  443. package/src/plugins/insights/errors.ts +0 -11
  444. package/src/plugins/insights/eventInput.ts +0 -381
  445. package/src/plugins/insights/eventRow.ts +0 -209
  446. package/src/plugins/insights/index.ts +0 -222
  447. package/src/plugins/insights/insights.integration.spec.ts +0 -921
  448. package/src/plugins/insights/insightsRollout.integration.spec.ts +0 -186
  449. package/src/plugins/insights/model.spec.ts +0 -64
  450. package/src/plugins/insights/model.ts +0 -18
  451. package/src/plugins/insights/modelTypes.ts +0 -197
  452. package/src/plugins/insights/overview.spec.ts +0 -64
  453. package/src/plugins/insights/overview.ts +0 -214
  454. package/src/plugins/insights/provider.spec.ts +0 -585
  455. package/src/plugins/insights/provider.ts +0 -704
  456. package/src/plugins/insights/queryInput.ts +0 -142
  457. package/src/plugins/insights/reads.spec.ts +0 -1013
  458. package/src/plugins/insights/reads.ts +0 -1037
  459. package/src/plugins/insights/recordEvent.spec.ts +0 -897
  460. package/src/plugins/insights/recordEvent.ts +0 -476
  461. package/src/plugins/insights/retention.spec.ts +0 -115
  462. package/src/plugins/insights/routes.ts +0 -149
  463. package/src/plugins/insights/schema.ts +0 -409
  464. package/src/plugins/insights/testing/expectInsightsIndex.spec.ts +0 -42
  465. package/src/plugins/insights/testing/expectInsightsIndex.ts +0 -20
  466. package/src/plugins/insights/testing/fixtures.ts +0 -30
  467. package/src/plugins/insights/testing/index.ts +0 -45
  468. package/src/plugins/insights/testing/insightsModelTests.ts +0 -860
  469. package/src/plugins/insights/testing/setupInsightsHttpTestSuite.ts +0 -152
  470. package/src/plugins/insights/testing/setupInsightsModelTestSuite.ts +0 -36
  471. package/src/plugins/insights/testing/types.ts +0 -30
  472. package/src/plugins/insights/types.ts +0 -55
  473. package/src/plugins/pluginTestHarness.spec.ts +0 -56
  474. package/src/readBudgets.testFixtures.ts +0 -15
  475. package/src/releaseCatalogRoutes.integration.spec.ts +0 -200
  476. package/src/retention.spec.ts +0 -73
  477. package/src/runtime.spec.ts +0 -207
  478. package/src/runtime.testFixtures.ts +0 -60
  479. package/src/runtimeBundles.integration.spec.ts +0 -112
  480. package/src/storageAccess.spec.ts +0 -152
  481. package/src/storageAccess.ts +0 -141
  482. package/src/testUtilsMutation.integration.spec.ts +0 -216
  483. package/src/testUtilsPackage.integration.spec.ts +0 -180
  484. package/src/types/index.ts +0 -2
  485. package/src/version.ts +0 -3
@@ -1,248 +0,0 @@
1
- import { PGlite } from "@electric-sql/pglite";
2
- import { createMemoryAdapter } from "@hot-updater/plugin-core/internal";
3
- import { Kysely } from "kysely";
4
- import { PGliteDialect } from "kysely-pglite-dialect";
5
- import { describe, expect, it, vi } from "vitest";
6
-
7
- import { drizzleAdapter } from "../adapters/drizzle";
8
- import { kyselyAdapter } from "../adapters/kysely";
9
- import { prismaAdapter } from "../adapters/prisma";
10
- import { createHotUpdater } from "../createHotUpdaterCore";
11
- import { HotUpdaterSchemaMigrationRequiredError } from "../database/fence";
12
- import { defineTable } from "../database/schema";
13
- import { createTableStatements } from "../database/sql/sqlAdapter";
14
- import { apiKeys } from "../plugins/api-keys";
15
- import {
16
- type AnyHotUpdaterPlugin,
17
- definePlugin,
18
- } from "../plugins/definePlugin";
19
- import { insights } from "../plugins/insights";
20
- import {
21
- coreTarget,
22
- createEngineDatabase,
23
- toolingTargetOf,
24
- } from "./coreDatabase";
25
- import { createMigrator, generateSchema } from "./index";
26
-
27
- const notes = definePlugin({
28
- id: "notes",
29
- schemaVersion: "2",
30
- schema: {
31
- notes: defineTable(
32
- {
33
- id: { type: "string" },
34
- author: { type: "string" },
35
- text: { type: "string" },
36
- },
37
- { key: ["id"], indexes: { byAuthor: { eq: ["author"], sort: ["id"] } } },
38
- ),
39
- },
40
- init: ({ db }) => ({
41
- api: {
42
- add: (id: string, author: string, text: string) =>
43
- db.transaction(async (tx) => {
44
- tx.create("notes", { id, author, text });
45
- }),
46
- read: (id: string) => db.findOne("notes", { id }),
47
- },
48
- }),
49
- });
50
-
51
- /** `hot-updater db migrate`: the migrator for the server's tables, run. */
52
- const migrate = async (hotUpdater: { readonly adapterName: string }) => {
53
- const result = await createMigrator(hotUpdater).migrateToLatest({
54
- mode: "from-schema",
55
- updateSettings: true,
56
- });
57
- await result.execute();
58
- return result;
59
- };
60
-
61
- const memoryDatabase = () =>
62
- createEngineDatabase({ name: "memory", adapter: createMemoryAdapter() });
63
-
64
- describe("plugin tables in db tooling", () => {
65
- it("adds each plugin's tables and settings row to core's, prefixed by its id unless it keeps its names", () => {
66
- expect(toolingTargetOf([])).toBe(coreTarget);
67
- const target = toolingTargetOf([insights(), notes]);
68
- const names = target.schema.tables.map(({ name }) => name);
69
- expect(names.slice(0, coreTarget.schema.tables.length)).toEqual(
70
- coreTarget.schema.tables.map(({ name }) => name),
71
- );
72
- expect(names).toContain("bundle_events");
73
- expect(names.at(-1)).toBe("notes_notes");
74
- expect(target.settings).toEqual({
75
- ...coreTarget.settings,
76
- "schema.insights": insights().schemaVersion,
77
- "schema.notes": "2",
78
- });
79
- });
80
-
81
- it("fits Hot Updater's own plugins' tables within MySQL's key limit", () => {
82
- expect(() =>
83
- createTableStatements(
84
- "mysql",
85
- toolingTargetOf([insights(), apiKeys()]).schema.tables,
86
- ),
87
- ).not.toThrow();
88
- });
89
-
90
- it("migrates an engine database's core and plugin tables with its adapter", async () => {
91
- const hotUpdater = createHotUpdater({
92
- database: memoryDatabase(),
93
- plugins: [notes],
94
- clientAccess: "public",
95
- });
96
- await expect(hotUpdater.api.notes.read("n1")).rejects.toBeInstanceOf(
97
- HotUpdaterSchemaMigrationRequiredError,
98
- );
99
-
100
- const result = await migrate(hotUpdater);
101
- expect(result.operations).toContainEqual(
102
- expect.objectContaining({
103
- type: "create-table",
104
- value: expect.objectContaining({ ormName: "notes_notes" }),
105
- }),
106
- );
107
- await hotUpdater.api.notes.add("n1", "ada", "hello");
108
- await expect(hotUpdater.api.notes.read("n1")).resolves.toEqual({
109
- id: "n1",
110
- author: "ada",
111
- text: "hello",
112
- });
113
- await expect(hotUpdater.core.listChannels()).resolves.toEqual([]);
114
- });
115
-
116
- it("answers 503 until the plugin's settings row exists, then serves it", async () => {
117
- const database = memoryDatabase();
118
- await migrate(createHotUpdater({ database, clientAccess: "public" }));
119
- const hotUpdater = createHotUpdater({
120
- database,
121
- plugins: [notes],
122
- clientAccess: "public",
123
- });
124
- await expect(hotUpdater.api.notes.read("n1")).rejects.toThrow(
125
- 'Hot Updater schema setting "schema.notes" for memory is missing; expected "2". Run `hot-updater db migrate`.',
126
- );
127
- await expect(hotUpdater.core.listChannels()).rejects.toBeInstanceOf(
128
- HotUpdaterSchemaMigrationRequiredError,
129
- );
130
- const channels = () =>
131
- hotUpdater.handlers.admin(new Request("http://localhost/channels"));
132
- const error = vi.spyOn(console, "error").mockImplementation(() => {});
133
- expect((await channels()).status).toBe(503);
134
- error.mockRestore();
135
-
136
- await migrate(hotUpdater);
137
- expect((await channels()).status).toBe(200);
138
- await expect(hotUpdater.api.notes.read("n1")).resolves.toBeNull();
139
- // The server without the plugin was already served.
140
- await expect(
141
- createHotUpdater({
142
- database,
143
- clientAccess: "public",
144
- }).core.listChannels(),
145
- ).resolves.toEqual([]);
146
- });
147
-
148
- it("writes a Kysely migration of the plugin's tables and settings row", async () => {
149
- const db = new PGlite();
150
- const kysely = new Kysely<object>({ dialect: new PGliteDialect(db) });
151
- try {
152
- const hotUpdater = createHotUpdater({
153
- database: kyselyAdapter({ db: kysely, provider: "postgresql" }),
154
- plugins: [notes],
155
- clientAccess: "public",
156
- });
157
- const result = await createMigrator(hotUpdater).migrateToLatest({
158
- mode: "from-schema",
159
- updateSettings: true,
160
- });
161
- const sql = result.getSQL?.() ?? "";
162
- expect(sql).toContain('CREATE TABLE IF NOT EXISTS "notes_notes"');
163
- expect(sql).toContain(
164
- 'CREATE INDEX IF NOT EXISTS "notes_notes_byAuthor" ON "notes_notes" ("author", "id")',
165
- );
166
- expect(sql).toContain("VALUES ('schema.notes', '2', 0)");
167
-
168
- await result.execute();
169
- await hotUpdater.api.notes.add("n1", "ada", "hello");
170
- await expect(hotUpdater.api.notes.read("n1")).resolves.toMatchObject({
171
- text: "hello",
172
- });
173
- } finally {
174
- await kysely.destroy();
175
- await db.close();
176
- }
177
- });
178
-
179
- it("generates Drizzle and Prisma schemas with the plugin's tables", () => {
180
- const generated = (
181
- database: Parameters<typeof createHotUpdater>[0]["database"],
182
- ) =>
183
- generateSchema(
184
- createHotUpdater({
185
- database,
186
- plugins: [notes],
187
- clientAccess: "public",
188
- }),
189
- "latest",
190
- ).code;
191
-
192
- expect(
193
- generated(drizzleAdapter({ db: {}, provider: "postgresql" })),
194
- ).toContain('pgTable("notes_notes"');
195
- expect(
196
- generated(prismaAdapter({ prisma: {}, provider: "postgresql" })),
197
- ).toContain("model notes_notes {");
198
- });
199
-
200
- it("checks a plugin's id and tables against core and the other plugins the server runs", () => {
201
- const named = definePlugin({
202
- id: "insights",
203
- schemaVersion: "1",
204
- schema: {
205
- notes: defineTable({ id: { type: "string" } }, { key: ["id"] }),
206
- },
207
- init: () => ({ api: {} }),
208
- });
209
- const tabled = definePlugin({
210
- id: "api",
211
- schemaVersion: "1",
212
- schema: {
213
- keys: defineTable({ id: { type: "string" } }, { key: ["id"] }),
214
- },
215
- init: () => ({ api: {} }),
216
- });
217
- const unprefixed = definePlugin({
218
- id: "shadowCore",
219
- namespace: false,
220
- schemaVersion: "1",
221
- schema: {
222
- channels: defineTable({ id: { type: "string" } }, { key: ["id"] }),
223
- },
224
- init: () => ({ api: {} }),
225
- });
226
- const start = (plugins: readonly AnyHotUpdaterPlugin[]) => () =>
227
- createHotUpdater({
228
- database: memoryDatabase(),
229
- plugins,
230
- ...(plugins.some(({ provides }) => provides?.clientAuth)
231
- ? {}
232
- : { clientAccess: "public" }),
233
- } as Parameters<typeof createHotUpdater>[0]);
234
-
235
- // Only the plugins a server runs get tables, so these fit on their own.
236
- expect(start([named])).not.toThrow();
237
- expect(start([tabled])).not.toThrow();
238
- expect(start([named, insights()])).toThrow(
239
- 'Plugin "insights" is registered twice.',
240
- );
241
- expect(start([tabled, apiKeys()])).toThrow(
242
- 'apiKeys.api_keys: table "api_keys" is also declared by api.keys',
243
- );
244
- expect(start([unprefixed])).toThrow(
245
- 'shadowCore.channels: table "channels" is also declared by core.channels',
246
- );
247
- });
248
- });
@@ -1,106 +0,0 @@
1
- import {
2
- createReleaseCatalogScopeKey,
3
- RELEASE_CATALOG_FALLBACK_POLICY,
4
- RELEASE_CATALOG_SCHEMA_VERSION,
5
- type ReleaseCatalog,
6
- } from "@hot-updater/core";
7
- import {
8
- projectCompiledCatalog,
9
- projectCompiledRollbackCatalog,
10
- type CompiledReleaseCatalog,
11
- type ReleaseCatalogRow,
12
- } from "@hot-updater/plugin-core";
13
-
14
- export type ReleaseCatalogRequest =
15
- | {
16
- readonly strategy: "APP_VERSION";
17
- readonly platform: "ios" | "android";
18
- readonly channelKey: string;
19
- readonly appVersion: string;
20
- }
21
- | {
22
- readonly strategy: "FINGERPRINT";
23
- readonly platform: "ios" | "android";
24
- readonly channelKey: string;
25
- readonly fingerprintHash: string;
26
- };
27
-
28
- /** A stored catalog payload, checked against its strategy's shape. */
29
- export const parseCompiledCatalog = (
30
- payload: string,
31
- strategy: ReleaseCatalogRequest["strategy"],
32
- ): CompiledReleaseCatalog => {
33
- const parsed: unknown = JSON.parse(payload);
34
- if (
35
- typeof parsed !== "object" ||
36
- parsed === null ||
37
- Reflect.get(parsed, "schemaVersion") !== RELEASE_CATALOG_SCHEMA_VERSION ||
38
- Reflect.get(parsed, "strategy") !== strategy ||
39
- Reflect.get(parsed, "fallbackPolicy") !== RELEASE_CATALOG_FALLBACK_POLICY ||
40
- !Array.isArray(Reflect.get(parsed, "releaseDescriptors"))
41
- ) {
42
- throw new Error("Stored Release catalog payload is invalid");
43
- }
44
- if (
45
- strategy === "APP_VERSION" &&
46
- !Array.isArray(Reflect.get(parsed, "segments"))
47
- ) {
48
- throw new Error("Stored app-version Release catalog is invalid");
49
- }
50
- if (
51
- strategy === "FINGERPRINT" &&
52
- !Array.isArray(Reflect.get(parsed, "releaseIndexes"))
53
- ) {
54
- throw new Error("Stored fingerprint Release catalog is invalid");
55
- }
56
- return parsed as CompiledReleaseCatalog;
57
- };
58
-
59
- /** The scope key an update check reads. */
60
- export const releaseCatalogScopeKeyOf = (
61
- input: ReleaseCatalogRequest,
62
- ): string =>
63
- input.strategy === "APP_VERSION"
64
- ? createReleaseCatalogScopeKey({
65
- channelKey: input.channelKey,
66
- platform: input.platform,
67
- strategy: "APP_VERSION",
68
- })
69
- : createReleaseCatalogScopeKey({
70
- channelKey: input.channelKey,
71
- fingerprintHash: input.fingerprintHash,
72
- platform: input.platform,
73
- strategy: "FINGERPRINT",
74
- });
75
-
76
- /** Projects a stored catalog row for one update check; null when the row is not this scope's. */
77
- export const projectReleaseCatalogRow = (
78
- row: ReleaseCatalogRow | null,
79
- input: ReleaseCatalogRequest,
80
- scopeKey = releaseCatalogScopeKeyOf(input),
81
- ): ReleaseCatalog | null => {
82
- if (
83
- row === null ||
84
- row.platform !== input.platform ||
85
- row.strategy !== input.strategy ||
86
- row.channel_key !== input.channelKey ||
87
- row.scope_key !== scopeKey ||
88
- row.fingerprint_hash !==
89
- (input.strategy === "FINGERPRINT" ? input.fingerprintHash : null)
90
- ) {
91
- return null;
92
- }
93
- const compiled = parseCompiledCatalog(row.payload, input.strategy);
94
- const appVersion =
95
- input.strategy === "APP_VERSION" ? input.appVersion : undefined;
96
- return {
97
- catalogId: row.catalog_id,
98
- catalogHash: row.catalog_hash,
99
- fallbackPolicy: RELEASE_CATALOG_FALLBACK_POLICY,
100
- generation: row.generation,
101
- releases: projectCompiledCatalog(compiled, appVersion),
102
- rollbackReleases: projectCompiledRollbackCatalog(compiled, appVersion),
103
- schemaVersion: RELEASE_CATALOG_SCHEMA_VERSION,
104
- scopeKey,
105
- };
106
- };
@@ -1,104 +0,0 @@
1
- import type {
2
- DatabaseAdapter,
3
- PhysicalTable,
4
- StoredRow,
5
- WriteOp,
6
- } from "@hot-updater/plugin-core/internal";
7
-
8
- import {
9
- ENGINE_SCHEMA_KEY,
10
- ENGINE_SCHEMA_VERSION,
11
- HotUpdaterSchemaMigrationRequiredError,
12
- isMissingSchemaError,
13
- readSettings,
14
- SETTINGS_TABLE,
15
- type SchemaSettings,
16
- } from "../database/fence";
17
-
18
- /** Refuses a database with `schema.core` but no `schema.engine`: it predates the engine. */
19
- const assertEngineDatabase = (
20
- adapterName: string,
21
- stored: ReadonlyMap<string, StoredRow | null>,
22
- ) => {
23
- if (stored.get("schema.core") && !stored.get(ENGINE_SCHEMA_KEY)) {
24
- throw new HotUpdaterSchemaMigrationRequiredError(
25
- adapterName,
26
- String(stored.get("schema.core")!.value),
27
- { key: ENGINE_SCHEMA_KEY, expected: ENGINE_SCHEMA_VERSION, found: null },
28
- );
29
- }
30
- };
31
-
32
- const storedSettings = async (
33
- adapter: DatabaseAdapter,
34
- keys: readonly string[],
35
- ) => {
36
- const rows = await readSettings(adapter, keys);
37
- return new Map(keys.map((key, position) => [key, rows[position] ?? null]));
38
- };
39
-
40
- /** Writes the settings rows after every table exists, refusing a pre-engine database. */
41
- export const writeSchemaSettings = async (
42
- adapter: DatabaseAdapter,
43
- adapterName: string,
44
- settings: SchemaSettings,
45
- ): Promise<void> => {
46
- const stored = await storedSettings(adapter, [
47
- ...new Set(["schema.core", ENGINE_SCHEMA_KEY, ...Object.keys(settings)]),
48
- ]);
49
- assertEngineDatabase(adapterName, stored);
50
- const ops = Object.entries(settings).flatMap(([key, value]): WriteOp[] => {
51
- const row = stored.get(key);
52
- if (row === null || row === undefined) {
53
- return [
54
- { type: "insert", table: SETTINGS_TABLE, row: { key, value, _v: 0 } },
55
- ];
56
- }
57
- if (row.value === value) return [];
58
- return [
59
- {
60
- type: "patch",
61
- table: SETTINGS_TABLE,
62
- key: [key],
63
- set: { value },
64
- guard: { v: Number(row._v) },
65
- previous: row,
66
- },
67
- ];
68
- });
69
- if (ops.length === 0) return;
70
- const result = await adapter.write(ops);
71
- if (!result.ok) {
72
- throw new Error(
73
- "The schema settings changed during the migration; run it again.",
74
- );
75
- }
76
- };
77
-
78
- /**
79
- * Creates or updates every table, then writes the settings rows last. A
80
- * pre-engine database is refused before any table changes.
81
- */
82
- export const migrateSchema = async (
83
- adapter: DatabaseAdapter,
84
- adapterName: string,
85
- tables: readonly PhysicalTable[],
86
- settings: SchemaSettings,
87
- ): Promise<void> => {
88
- if (adapter.migrations === undefined) {
89
- throw new Error(
90
- `${adapterName} creates its tables with its own tooling; write only the settings rows.`,
91
- );
92
- }
93
- // A database without the settings table is empty, so nothing is refused.
94
- const stored = await storedSettings(adapter, [
95
- "schema.core",
96
- ENGINE_SCHEMA_KEY,
97
- ]).catch((error: unknown) => {
98
- if (!isMissingSchemaError(error)) throw error;
99
- return new Map<string, StoredRow | null>();
100
- });
101
- assertEngineDatabase(adapterName, stored);
102
- await adapter.migrations.apply([...tables, SETTINGS_TABLE]);
103
- await writeSchemaSettings(adapter, adapterName, settings);
104
- };
@@ -1,65 +0,0 @@
1
- import { DatabaseSync } from "node:sqlite";
2
-
3
- import { describe, expect, it } from "vitest";
4
-
5
- import { checkSchemaFence, SETTINGS_TABLE } from "../database/fence";
6
- import { createSqlAdapter } from "../database/sql/sqlAdapter";
7
- import { createTableStatements } from "../database/sql/sqlSchema";
8
- import { sqliteExecutor } from "../database/sql/sqlTestExecutors";
9
- import { createSettingsMigrator } from "./settingsMigrator";
10
-
11
- const settings = { "schema.engine": "1", "schema.core": "1.0.0" };
12
-
13
- const migratorOver = (database: DatabaseSync) =>
14
- createSettingsMigrator({
15
- adapterName: "orm",
16
- executor: sqliteExecutor(database),
17
- settings,
18
- applyTables: "the ORM's push",
19
- });
20
-
21
- describe("the settings-only migrator", () => {
22
- it("writes only the settings rows once the ORM applied the tables, then has nothing left", async () => {
23
- const database = new DatabaseSync(":memory:");
24
- database.exec(createTableStatements("sqlite", [SETTINGS_TABLE]).join(";"));
25
- const migrator = migratorOver(database);
26
-
27
- const pending = await migrator.migrateToLatest();
28
- expect(pending.operations).toEqual([
29
- expect.objectContaining({ type: "custom" }),
30
- ]);
31
- expect(pending.getSQL?.()).toContain("ON CONFLICT");
32
- await pending.execute();
33
- await expect(migrator.migrateToLatest()).resolves.toMatchObject({
34
- operations: [],
35
- });
36
- await expect(migrator.getVersion()).resolves.toBe("1.0.0");
37
- await expect(
38
- checkSchemaFence(
39
- createSqlAdapter({ executor: sqliteExecutor(database) }),
40
- "orm",
41
- settings,
42
- ),
43
- ).resolves.toBeUndefined();
44
- });
45
-
46
- it("asks for the ORM's tables first, refuses a database from before the engine, and rethrows other failures", async () => {
47
- await expect(
48
- migratorOver(new DatabaseSync(":memory:")).migrateToLatest(),
49
- ).rejects.toThrow("the ORM's push");
50
-
51
- const legacy = new DatabaseSync(":memory:");
52
- legacy.exec(
53
- "CREATE TABLE private_hot_updater_settings (key TEXT PRIMARY KEY, value TEXT NOT NULL); INSERT INTO private_hot_updater_settings VALUES ('schema.core', '1.0.0');",
54
- );
55
- await expect(migratorOver(legacy).migrateToLatest()).rejects.toMatchObject({
56
- setting: { key: "schema.engine", expected: "1", found: null },
57
- });
58
-
59
- const closed = new DatabaseSync(":memory:");
60
- closed.close();
61
- await expect(migratorOver(closed).migrateToLatest()).rejects.toThrow(
62
- "database is not open",
63
- );
64
- });
65
- });
@@ -1,152 +0,0 @@
1
- import { HOT_UPDATER_SCHEMA_VERSION } from "../core/schema";
2
- import {
3
- ENGINE_SCHEMA_KEY,
4
- ENGINE_SCHEMA_VERSION,
5
- isMissingSchemaError,
6
- SETTINGS_TABLE,
7
- type SchemaSettings,
8
- } from "../database/fence";
9
- import { HotUpdaterSchemaMigrationRequiredError } from "../database/fence";
10
- import type { SqlExecutor } from "../database/sql/sqlAdapter";
11
- import { quoteSql } from "../database/sql/sqlSchema";
12
- import { settingsStatements } from "./engineSql";
13
- import {
14
- assertSupportedMigrationMode,
15
- getEmptyMigrationResult,
16
- } from "./fixedMigratorShared";
17
- import type { MigrateOptions, MigrationResult, Migrator } from "./types";
18
-
19
- /**
20
- * Every settings row by key and value alone, so a v0 layout reads too; null
21
- * when the settings table is missing.
22
- */
23
- export const readStoredSettings = async (
24
- executor: SqlExecutor,
25
- tablePrefix = "",
26
- ): Promise<ReadonlyMap<string, unknown> | null> => {
27
- const quote = (name: string) => quoteSql(executor.dialect, name);
28
- try {
29
- const { rows } = await executor.execute({
30
- sql: `SELECT ${quote("key")}, ${quote("value")} FROM ${quote(tablePrefix + SETTINGS_TABLE.name)}`,
31
- params: [],
32
- });
33
- return new Map(rows.map((row) => [String(row.key), row.value]));
34
- } catch (error) {
35
- if (!isMissingSchemaError(error)) throw error;
36
- return null;
37
- }
38
- };
39
-
40
- /** `schema.core`, or a v0 database's `version`. */
41
- export const storedSchemaVersion = (
42
- stored: ReadonlyMap<string, unknown> | null,
43
- ): string | undefined => {
44
- const version = stored?.get("schema.core") ?? stored?.get("version");
45
- return typeof version === "string" ? version : undefined;
46
- };
47
-
48
- /** A v0 or pre-engine database is recreated, never converted. */
49
- export const refusePreEngineDatabase = (
50
- adapterName: string,
51
- stored: ReadonlyMap<string, unknown>,
52
- ): void => {
53
- const version = storedSchemaVersion(stored);
54
- if (version === undefined || stored.has(ENGINE_SCHEMA_KEY)) return;
55
- throw new HotUpdaterSchemaMigrationRequiredError(
56
- adapterName,
57
- version,
58
- stored.has("schema.core")
59
- ? { key: ENGINE_SCHEMA_KEY, expected: ENGINE_SCHEMA_VERSION, found: null }
60
- : undefined,
61
- );
62
- };
63
-
64
- /**
65
- * `hot-updater db migrate` for an ORM that applies the DDL itself (Drizzle,
66
- * Prisma): it sets what the ORM cannot declare, writes the settings rows, and
67
- * refuses a v0 or pre-engine database.
68
- */
69
- export const createSettingsMigrator = (options: {
70
- readonly adapterName: string;
71
- readonly executor: SqlExecutor;
72
- readonly settings: SchemaSettings;
73
- /** How the ORM applies the tables, for the error when they are missing. */
74
- readonly applyTables: string;
75
- /** What the ORM cannot declare, set before the settings rows. */
76
- readonly fixups?: {
77
- readonly description: string;
78
- readonly statements: readonly string[];
79
- };
80
- }): Migrator => {
81
- const read = () => readStoredSettings(options.executor);
82
- const getVersion = async () => storedSchemaVersion(await read());
83
-
84
- const makeResult = async (
85
- migrate: MigrateOptions = {},
86
- ): Promise<MigrationResult> => {
87
- assertSupportedMigrationMode(migrate);
88
- const stored = await read();
89
- if (stored === null) {
90
- throw new Error(
91
- `${options.adapterName}: the Hot Updater tables are missing. Run \`hot-updater db generate\`, apply the schema with ${options.applyTables}, then migrate again.`,
92
- );
93
- }
94
- refusePreEngineDatabase(options.adapterName, stored);
95
- if (
96
- migrate.updateSettings === false ||
97
- Object.entries(options.settings).every(
98
- ([key, value]) => stored.get(key) === value,
99
- )
100
- ) {
101
- return getEmptyMigrationResult();
102
- }
103
- const fixups = options.fixups?.statements ?? [];
104
- const statements = [
105
- ...fixups,
106
- ...settingsStatements(options.executor.dialect, options.settings),
107
- ];
108
- return {
109
- operations: [
110
- ...(fixups.length === 0
111
- ? []
112
- : [
113
- {
114
- type: "custom" as const,
115
- description: options.fixups!.description,
116
- },
117
- ]),
118
- {
119
- type: "custom",
120
- description: `Write the schema settings: ${Object.keys(options.settings).join(", ")}`,
121
- },
122
- ],
123
- getSQL: () => statements.map((statement) => `${statement};`).join("\n\n"),
124
- execute: async () => {
125
- for (const sql of statements) {
126
- await options.executor.execute({ sql, params: [] });
127
- }
128
- },
129
- };
130
- };
131
-
132
- return {
133
- getVersion,
134
- getNameVariants: async () => undefined,
135
- next: async () =>
136
- (await getVersion()) === HOT_UPDATER_SCHEMA_VERSION
137
- ? undefined
138
- : { version: HOT_UPDATER_SCHEMA_VERSION },
139
- previous: async () => undefined,
140
- up: makeResult,
141
- down: async () => {
142
- throw new Error("No previous schema to migrate to.");
143
- },
144
- migrateTo: async (version, migrate) => {
145
- if (version !== HOT_UPDATER_SCHEMA_VERSION) {
146
- throw new Error(`Invalid version ${version}`);
147
- }
148
- return makeResult(migrate);
149
- },
150
- migrateToLatest: makeResult,
151
- };
152
- };