@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
@@ -1,35 +1,29 @@
1
1
  import {
2
2
  createStoragePlugin,
3
- type DatabasePlugin,
4
3
  type ConfigInput,
5
4
  } from "@hot-updater/plugin-core";
6
5
  import { describe, expect, expectTypeOf, it, vi } from "vitest";
7
6
 
8
- import { createInMemoryDatabasePlugin } from "../../test-utils/test/inMemoryDatabasePlugin";
9
7
  import packageJson from "../package.json" with { type: "json" };
10
- import { createHotUpdater } from "./index";
8
+ import { builtInSettings } from "./db/builtInDatabase";
9
+ import { createHotUpdater, HotUpdaterConfigError } from "./index";
11
10
  import type {
12
11
  ClientAccessPolicy,
13
12
  CreateHotUpdaterOptions,
14
- HandlerAPI,
13
+ RuntimeHotUpdaterAPI,
15
14
  } from "./index";
16
15
  import {
16
+ createFencedDatabase,
17
17
  createRuntimeDatabase,
18
- createSchemaManagedDatabase,
19
18
  } from "./runtime.testFixtures";
20
- import { HOT_UPDATER_SCHEMA_VERSION } from "./schema/types";
21
19
  import { HOT_UPDATER_SERVER_VERSION } from "./version";
22
20
 
23
- const publicClientAccess = {
24
- type: "public",
25
- } satisfies ClientAccessPolicy;
26
-
27
21
  describe("runtime createHotUpdater", () => {
28
22
  it.each(["authorityId", "catalogId"])("rejects a user-supplied %s", (key) => {
29
23
  expect(() =>
30
24
  createHotUpdater({
31
- clientAccess: publicClientAccess,
32
- database: createInMemoryDatabasePlugin(),
25
+ clientAccess: "public",
26
+ database: createRuntimeDatabase(),
33
27
  [key]: "user-controlled",
34
28
  }),
35
29
  ).toThrow(`Remove ${key}`);
@@ -45,24 +39,21 @@ describe("runtime createHotUpdater", () => {
45
39
  expect(hasRuntimeEntry).toBe(false);
46
40
  });
47
41
 
48
- it("exports runtime-safe handler types from the root entry", () => {
42
+ it("types the options and the instance without the legacy API", () => {
49
43
  expectTypeOf<ConfigInput>().not.toHaveProperty("authorityId");
50
44
  expectTypeOf<ConfigInput>().not.toHaveProperty("catalogId");
51
- expectTypeOf<HandlerAPI>().toHaveProperty("getBundles");
52
45
  expectTypeOf<keyof CreateHotUpdaterOptions>().toEqualTypeOf<
53
- "clientAccess" | "database" | "storage"
46
+ "clientAccess" | "database" | "plugins" | "storage"
54
47
  >();
55
- expectTypeOf<CreateHotUpdaterOptions>().toHaveProperty("clientAccess");
56
48
  expectTypeOf<
57
49
  CreateHotUpdaterOptions["clientAccess"]
58
50
  >().toEqualTypeOf<ClientAccessPolicy>();
51
+ expectTypeOf<keyof RuntimeHotUpdaterAPI>().toEqualTypeOf<
52
+ "adapterName" | "api" | "core" | "handlers"
53
+ >();
59
54
  });
60
55
 
61
- it("accepts a direct v2 plugin object without exposing maintenance methods", () => {
62
- const database: DatabasePlugin = {
63
- ...createInMemoryDatabasePlugin(),
64
- name: "contextlessTestDatabase",
65
- };
56
+ it("runs on an engine database without exposing its tooling", () => {
66
57
  const storage = createStoragePlugin({
67
58
  name: "contextlessTestStorage",
68
59
  protocol: "s3",
@@ -73,36 +64,77 @@ describe("runtime createHotUpdater", () => {
73
64
  });
74
65
 
75
66
  const hotUpdater = createHotUpdater({
76
- clientAccess: publicClientAccess,
77
- database,
67
+ clientAccess: "public",
68
+ database: createRuntimeDatabase("contextlessTestDatabase"),
78
69
  storage: [storage],
79
70
  });
80
71
 
81
72
  expect(hotUpdater.adapterName).toBe("contextlessTestDatabase");
82
- expect(hotUpdater.handlers.client).toEqual(expect.any(Function));
83
- expect(hotUpdater.handlers.admin).toEqual(expect.any(Function));
84
- expect("createMigrator" in hotUpdater).toBe(false);
85
- expect("generateSchema" in hotUpdater).toBe(false);
73
+ expect(Object.keys(hotUpdater).sort()).toEqual([
74
+ "adapterName",
75
+ "api",
76
+ "core",
77
+ "handlers",
78
+ ]);
86
79
  expect(hotUpdater).not.toHaveProperty("authorityId");
87
- expect(hotUpdater).not.toHaveProperty("catalogId");
88
80
  expectTypeOf(hotUpdater).not.toHaveProperty("createMigrator");
89
- expectTypeOf(hotUpdater).not.toHaveProperty("generateSchema");
90
81
  expectTypeOf(hotUpdater.handlers.client)
91
82
  .parameter(0)
92
83
  .toEqualTypeOf<Request>();
93
84
  });
94
85
 
95
- it("rejects access when a managed schema is not initialized", async () => {
86
+ it("refuses a database that is not on the storage engine", () => {
87
+ const legacy = { name: "legacy", models: {}, commit: async () => ({}) };
88
+ const remote = {
89
+ name: "standalone",
90
+ core: {},
91
+ fetchAdmin: async () => new Response(null),
92
+ };
93
+
94
+ for (const database of [legacy, remote, undefined]) {
95
+ expect(() =>
96
+ createHotUpdater({
97
+ clientAccess: "public",
98
+ database: database as unknown as CreateHotUpdaterOptions["database"],
99
+ }),
100
+ ).toThrow(HotUpdaterConfigError);
101
+ }
102
+ expect(() =>
103
+ createHotUpdater({
104
+ clientAccess: "public",
105
+ database: remote as unknown as CreateHotUpdaterOptions["database"],
106
+ }),
107
+ ).toThrow("standaloneRepository reaches a server's admin API");
108
+ });
109
+
110
+ it("answers 503 until the schema settings are written", async () => {
111
+ const error = vi.spyOn(console, "error").mockImplementation(() => {});
112
+ try {
113
+ const hotUpdater = createHotUpdater({
114
+ clientAccess: "public",
115
+ database: await createFencedDatabase("kysely"),
116
+ });
117
+
118
+ const response = await hotUpdater.handlers.admin(
119
+ new Request("https://updates.example.com/channels"),
120
+ );
121
+
122
+ expect(response.status).toBe(503);
123
+ await expect(hotUpdater.core.listChannels()).rejects.toThrow(
124
+ "Hot Updater schema setting",
125
+ );
126
+ } finally {
127
+ error.mockRestore();
128
+ }
129
+ });
130
+
131
+ it("serves a fenced database once its settings are written", async () => {
96
132
  const hotUpdater = createHotUpdater({
97
- clientAccess: publicClientAccess,
98
- database: createSchemaManagedDatabase("kysely", undefined),
133
+ clientAccess: "public",
134
+ database: await createFencedDatabase("kysely", builtInSettings),
99
135
  });
100
136
 
101
- const result = hotUpdater.getBundles({ limit: 10 });
102
-
103
- await expect(result).rejects.toThrow(
104
- "Hot Updater database schema is not initialized for kysely.",
105
- );
137
+ await expect(hotUpdater.core.listChannels()).resolves.toEqual([]);
106
138
  });
107
139
 
108
140
  it.each(["s3", "https"])(
@@ -116,7 +148,7 @@ describe("runtime createHotUpdater", () => {
116
148
 
117
149
  expect(() =>
118
150
  createHotUpdater({
119
- clientAccess: publicClientAccess,
151
+ clientAccess: "public",
120
152
  database: createRuntimeDatabase(),
121
153
  storage: [storage],
122
154
  }),
@@ -126,39 +158,9 @@ describe("runtime createHotUpdater", () => {
126
158
  },
127
159
  );
128
160
 
129
- it("rejects access when a managed schema is stale", async () => {
130
- const hotUpdater = createHotUpdater({
131
- clientAccess: publicClientAccess,
132
- database: createSchemaManagedDatabase("mongodb", "0.21.0"),
133
- });
134
-
135
- const result = hotUpdater.getChannels();
136
-
137
- await expect(result).rejects.toThrow(
138
- "Hot Updater v1 cannot migrate schema 0.21.0 in place.",
139
- );
140
- });
141
-
142
- it("checks a ready managed schema only once", async () => {
143
- const database = createSchemaManagedDatabase(
144
- "kysely",
145
- HOT_UPDATER_SCHEMA_VERSION,
146
- );
147
- const createMigrator = vi.spyOn(database, "createMigrator");
148
- const hotUpdater = createHotUpdater({
149
- clientAccess: publicClientAccess,
150
- database,
151
- });
152
-
153
- await hotUpdater.getChannels();
154
- await hotUpdater.getChannels();
155
-
156
- expect(createMigrator).toHaveBeenCalledOnce();
157
- });
158
-
159
161
  it("keeps the version route mounted on the client handler", async () => {
160
162
  const hotUpdater = createHotUpdater({
161
- clientAccess: publicClientAccess,
163
+ clientAccess: "public",
162
164
  database: createRuntimeDatabase(),
163
165
  });
164
166
 
@@ -168,6 +170,7 @@ describe("runtime createHotUpdater", () => {
168
170
 
169
171
  expect(response.status).toBe(200);
170
172
  await expect(response.json()).resolves.toEqual({
173
+ adminProtocol: 2,
171
174
  infrastructureGeneration: 1,
172
175
  version: HOT_UPDATER_SERVER_VERSION,
173
176
  });
@@ -178,17 +181,28 @@ describe("runtime createHotUpdater", () => {
178
181
  createHotUpdater({
179
182
  database: createRuntimeDatabase(),
180
183
  } as unknown as CreateHotUpdaterOptions),
181
- ).toThrow("clientAccess must be an object.");
184
+ ).toThrow(
185
+ 'Set clientAccess to "public", or add a plugin that provides clientAuth.',
186
+ );
182
187
  });
183
188
 
184
- it("rejects an unsupported client access policy", () => {
185
- expect(() =>
189
+ it("rejects a clientAccess object, naming apiKeys() and insights()", () => {
190
+ const withObject = (clientAccess: unknown) => () =>
186
191
  createHotUpdater({
187
- clientAccess: {
188
- type: "private" as unknown as "public",
189
- },
192
+ clientAccess: clientAccess as ClientAccessPolicy,
190
193
  database: createRuntimeDatabase(),
191
- }),
192
- ).toThrow('clientAccess.type must be either "public" or "api-key".');
194
+ });
195
+ const keepInsights =
196
+ "To keep Insights, which the release candidates ran by default, add insights() from @hot-updater/server/plugins/insights to plugins.";
197
+
198
+ expect(withObject({ type: "api-key", headerName: "x-client-key" })).toThrow(
199
+ 'clientAccess: { type: "api-key" } was removed in 1.0. Remove it and add apiKeys({ headerName: "x-client-key" }) from @hot-updater/server/plugins/api-keys to plugins',
200
+ );
201
+ expect(withObject({ type: "api-key" })).toThrow(keepInsights);
202
+ expect(withObject({ type: "public" })).toThrow(
203
+ 'clientAccess objects were removed in 1.0. Use clientAccess: "public", or add apiKeys()',
204
+ );
205
+ expect(withObject({ type: "public" })).toThrow(keepInsights);
206
+ expect(withObject("private")).toThrow(HotUpdaterConfigError);
193
207
  });
194
208
  });
@@ -1,21 +1,23 @@
1
1
  import type { Bundle } from "@hot-updater/core";
2
2
  import type {
3
- DatabasePlugin,
3
+ EngineDatabase,
4
4
  StoragePlugin,
5
5
  StoragePluginWith,
6
6
  } from "@hot-updater/plugin-core";
7
7
  import { createStoragePlugin } from "@hot-updater/plugin-core";
8
+ import { createMemoryAdapter } from "@hot-updater/plugin-core/internal";
8
9
 
9
- import { createInMemoryDatabasePlugin } from "../../test-utils/test/inMemoryDatabasePlugin";
10
- import type { DatabaseAdapterCapabilities, Migrator } from "./db/types";
10
+ import type { SchemaSettings } from "./database/fence";
11
+ import { builtInSchema, createEngineDatabase } from "./db/builtInDatabase";
12
+ import { migrateSchema } from "./db/schemaSettings";
11
13
 
12
14
  export const runtimeBundle: Bundle = {
13
15
  id: "00000000-0000-0000-0000-000000000001",
14
16
  platform: "ios",
15
- fileHash: "hash123",
16
17
  gitCommitHash: null,
17
- storageUri: "s3://test-bucket/bundles/bundle.zip",
18
- archiveByteSize: 3_000_000_001,
18
+ manifestStorageUri: "s3://test-bucket/bundles/bundle/manifest.json",
19
+ manifestFileHash: "manifest-hash",
20
+ assetBaseStorageUri: "s3://test-bucket/assets",
19
21
  };
20
22
 
21
23
  export const createRuntimeStorage = (
@@ -29,43 +31,25 @@ export const createRuntimeStorage = (
29
31
  ...(getDownloadUrl ? { getDownloadUrl } : {}),
30
32
  });
31
33
 
32
- const createMigrator = (version: string | undefined): Migrator => ({
33
- async getVersion() {
34
- return version;
35
- },
36
- async getNameVariants() {
37
- return {};
38
- },
39
- async next() {
40
- return undefined;
41
- },
42
- async previous() {
43
- return undefined;
44
- },
45
- async up() {
46
- throw new Error("not implemented");
47
- },
48
- async down() {
49
- throw new Error("not implemented");
50
- },
51
- async migrateTo() {
52
- throw new Error("not implemented");
53
- },
54
- async migrateToLatest() {
55
- throw new Error("not implemented");
56
- },
34
+ /** An in-memory database on the storage engine, without the schema fence. */
35
+ export const createRuntimeDatabase = (
36
+ name = "testDatabase",
37
+ ): EngineDatabase => ({
38
+ name,
39
+ adapter: createMemoryAdapter(),
57
40
  });
58
41
 
59
- export const createRuntimeDatabase = (): DatabasePlugin => ({
60
- ...createInMemoryDatabasePlugin(),
61
- name: "testDatabase",
62
- });
63
-
64
- export const createSchemaManagedDatabase = (
65
- adapterName: string,
66
- version: string | undefined,
67
- ): DatabasePlugin & DatabaseAdapterCapabilities => ({
68
- ...createRuntimeDatabase(),
69
- adapterName,
70
- createMigrator: () => createMigrator(version),
71
- });
42
+ /**
43
+ * An in-memory database behind the schema fence, as a provider builds it:
44
+ * its tables and `settings` rows written first, or none at all.
45
+ */
46
+ export const createFencedDatabase = async (
47
+ name: string,
48
+ settings?: SchemaSettings,
49
+ ): Promise<EngineDatabase> => {
50
+ const adapter = createMemoryAdapter();
51
+ if (settings !== undefined) {
52
+ await migrateSchema(adapter, name, builtInSchema.tables, settings);
53
+ }
54
+ return createEngineDatabase({ name, adapter });
55
+ };
@@ -0,0 +1,112 @@
1
+ import { type ChildProcess, spawn, spawnSync } from "node:child_process";
2
+ import net from "node:net";
3
+ import path from "node:path";
4
+ import { fileURLToPath } from "node:url";
5
+
6
+ import { afterEach, describe, expect, it } from "vitest";
7
+
8
+ import { HOT_UPDATER_SERVER_VERSION } from "./version";
9
+
10
+ /** Runs the built bundle from `tests/runtime`, with `plugins: []` and no Node APIs. */
11
+ const root = path.resolve(path.dirname(fileURLToPath(import.meta.url)), "..");
12
+
13
+ for (const [command, ...args] of [
14
+ ["deno", "--version"],
15
+ ["pnpm", "exec", "wrangler", "--version"],
16
+ ]) {
17
+ if (spawnSync(command!, args, { cwd: root, stdio: "ignore" }).status !== 0) {
18
+ throw new Error(
19
+ `${command === "pnpm" ? "wrangler" : command} is required for the server runtime bundle tests.`,
20
+ );
21
+ }
22
+ }
23
+
24
+ const openPort = () =>
25
+ new Promise<number>((resolve, reject) => {
26
+ const server = net.createServer();
27
+ server.on("error", reject);
28
+ server.listen(0, "127.0.0.1", () => {
29
+ const { port } = server.address() as net.AddressInfo;
30
+ server.close(() => resolve(port));
31
+ });
32
+ });
33
+
34
+ let running: ChildProcess | undefined;
35
+
36
+ const serve = async (command: string, args: readonly string[]) => {
37
+ const port = await openPort();
38
+ const child = spawn(command, [...args, "--port", String(port)], {
39
+ cwd: root,
40
+ detached: true,
41
+ env: { ...process.env, NO_COLOR: "1" },
42
+ stdio: ["ignore", "pipe", "pipe"],
43
+ });
44
+ running = child;
45
+ const logs: string[] = [];
46
+ child.stdout.on("data", (chunk: Buffer) => logs.push(chunk.toString()));
47
+ child.stderr.on("data", (chunk: Buffer) => logs.push(chunk.toString()));
48
+ const url = `http://127.0.0.1:${port}`;
49
+ for (
50
+ let attempt = 0;
51
+ attempt < 120 && child.exitCode === null;
52
+ attempt += 1
53
+ ) {
54
+ const ready = await fetch(`${url}/version`).then(
55
+ (response) => response.ok,
56
+ () => false,
57
+ );
58
+ if (ready) return url;
59
+ await new Promise((resolve) => setTimeout(resolve, 500));
60
+ }
61
+ throw new Error(`${command} never served /version:\n${logs.join("")}`);
62
+ };
63
+
64
+ describe.sequential("server bundle with plugins: []", () => {
65
+ afterEach(() => {
66
+ if (running?.pid !== undefined && running.exitCode === null) {
67
+ process.kill(-running.pid, "SIGTERM");
68
+ }
69
+ running = undefined;
70
+ });
71
+
72
+ it.each([
73
+ [
74
+ "Deno",
75
+ "deno",
76
+ [
77
+ "run",
78
+ "--allow-read",
79
+ "--allow-net",
80
+ "--allow-env",
81
+ "tests/runtime/deno-server.mjs",
82
+ ],
83
+ ],
84
+ [
85
+ "workerd",
86
+ "pnpm",
87
+ [
88
+ "exec",
89
+ "wrangler",
90
+ "dev",
91
+ "--config",
92
+ "tests/runtime/wrangler.runtime.jsonc",
93
+ "--local",
94
+ "--log-level",
95
+ "error",
96
+ ],
97
+ ],
98
+ ] as const)(
99
+ "serves client routes on %s",
100
+ async (_runtime, command, args) => {
101
+ const url = await serve(command, args);
102
+ const version = await fetch(`${url}/version`);
103
+ await expect(version.json()).resolves.toEqual({
104
+ adminProtocol: 2,
105
+ infrastructureGeneration: 1,
106
+ version: HOT_UPDATER_SERVER_VERSION,
107
+ });
108
+ expect((await fetch(`${url}/not-a-route`)).status).toBe(404);
109
+ },
110
+ 120_000,
111
+ );
112
+ });
@@ -0,0 +1,215 @@
1
+ import { execFile } from "node:child_process";
2
+ import {
3
+ mkdir,
4
+ mkdtemp,
5
+ readFile,
6
+ rm,
7
+ symlink,
8
+ writeFile,
9
+ } from "node:fs/promises";
10
+ import os from "node:os";
11
+ import path from "node:path";
12
+ import { promisify } from "node:util";
13
+
14
+ import { expect, it } from "vitest";
15
+
16
+ const exec = promisify(execFile);
17
+ const packageDirectory = path.resolve(import.meta.dirname, "..");
18
+
19
+ // These are deliberately broken providers: a storage adapter, the Insights
20
+ // model, or the served answers. Each must fail its behavioral scenario, not
21
+ // merely fail to import or initialize the suite.
22
+ const mutations = [
23
+ {
24
+ name: "ignore-lower-bound",
25
+ scenario: "pages all scoped Releases including disabled rows",
26
+ implementation:
27
+ "adapter.query = (table, request) => original.query(table, { ...request, lower: undefined });",
28
+ },
29
+ {
30
+ name: "ignore-upper-bound",
31
+ scenario: "pages each release filter set by key",
32
+ implementation:
33
+ "adapter.query = (table, request) => original.query(table, { ...request, upper: undefined });",
34
+ },
35
+ {
36
+ name: "reverse-order",
37
+ scenario: "pages Catalogs in scope order",
38
+ implementation:
39
+ 'adapter.query = (table, request) => original.query(table, { ...request, order: request.order === "asc" ? "desc" : "asc" });',
40
+ },
41
+ {
42
+ name: "short-pages",
43
+ scenario:
44
+ "serves the newest Release among 200 distinct compatible version ranges",
45
+ implementation:
46
+ "adapter.query = (table, request) => original.query(table, { ...request, limit: Math.min(request.limit, 2) });",
47
+ },
48
+ {
49
+ name: "drop-deletes",
50
+ scenario: "hard deletes a Release, rebuilds its Catalog",
51
+ implementation:
52
+ 'adapter.write = ops => original.write(ops.filter(op => op.type !== "delete"));',
53
+ },
54
+ {
55
+ name: "ignore-insights-cursor",
56
+ scenario: "uses exact identity and UTF-8 cursor order",
57
+ implementation:
58
+ 'const model = insightsModel; insightsModel = database => { const m = model(database); return { ...m, findLatestEvents: input => m.findLatestEvents("userId" in input ? { ...input, afterInstallId: undefined } : input) }; };',
59
+ },
60
+ {
61
+ name: "oldest-ota-first",
62
+ scenario: "rolls a deleted active Release back to older OTA bytes",
63
+ implementation: "",
64
+ responseMutation: "if (body.releases) body.releases.reverse();",
65
+ },
66
+ {
67
+ name: "missing-rollback-candidates",
68
+ scenario:
69
+ "re-evaluates cohort changes and rolls back even when the predecessor rollout is closed",
70
+ implementation: "",
71
+ responseMutation: "if (body.rollbackReleases) body.rollbackReleases = [];",
72
+ },
73
+ {
74
+ name: "wrong-ota-artifact",
75
+ scenario: "runs built-in → OTA A → OTA B → rollback A → built-in",
76
+ implementation: "",
77
+ responseMutation:
78
+ 'if (body.manifestFileHash) body.manifestFileHash = "wrong-manifest-hash";',
79
+ },
80
+ ] as const;
81
+
82
+ it("rejects broken providers while the unmodified provider passes the public suite", async () => {
83
+ const directory = await mkdtemp(
84
+ path.join(os.tmpdir(), "hot-updater-contract-mutants-"),
85
+ );
86
+ try {
87
+ await mkdir(path.join(directory, "node_modules/@hot-updater"), {
88
+ recursive: true,
89
+ });
90
+ for (const name of ["server", "test-utils"]) {
91
+ await symlink(
92
+ path.resolve(packageDirectory, "..", name),
93
+ path.join(directory, "node_modules/@hot-updater", name),
94
+ "dir",
95
+ );
96
+ }
97
+ const variants = [
98
+ { name: "control", scenario: undefined, implementation: "" },
99
+ ...mutations,
100
+ ];
101
+ for (const variant of variants) {
102
+ await writeFile(
103
+ path.join(directory, `${variant.name}.spec.ts`),
104
+ `
105
+ import { createHotUpdater } from "@hot-updater/server";
106
+ import { createMemoryAdapter } from "@hot-updater/server/database";
107
+ import { createDatabasePluginApis } from "@hot-updater/server/db";
108
+ import { createInsightsModel, insights } from "@hot-updater/server/plugins/insights";
109
+ import { setupDatabaseTestSuite, startHttpTestServer } from "@hot-updater/test-utils";
110
+ // An empty memory adapter per test, behind one adapter a mutant may break.
111
+ let original = createMemoryAdapter();
112
+ const adapter = {
113
+ id: "memory",
114
+ fits: ops => original.fits(ops),
115
+ get: (table, keys) => original.get(table, keys),
116
+ query: (table, request) => original.query(table, request),
117
+ write: ops => original.write(ops),
118
+ };
119
+ let insightsModel = database =>
120
+ createInsightsModel(createDatabasePluginApis(database, [insights()]).insights);
121
+ ${variant.implementation}
122
+ setupDatabaseTestSuite({
123
+ name: ${JSON.stringify(variant.name)},
124
+ createDatabase: () => ({ name: "memory", adapter }),
125
+ migrate: () => undefined,
126
+ reset: () => { original = createMemoryAdapter(); },
127
+ dispose: () => undefined,
128
+ createInsightsModel: database => insightsModel(database),
129
+ createHttpClient: options => {
130
+ const handlers = createHotUpdater({
131
+ ...options, plugins: [insights()], clientAccess: "public",
132
+ }).handlers;
133
+ return startHttpTestServer({
134
+ ...handlers,
135
+ client: async request => {
136
+ const response = await handlers.client(request);
137
+ if (response.status !== 200) return response;
138
+ const body = await response.json();
139
+ ${"responseMutation" in variant ? variant.responseMutation : ""}
140
+ return new Response(JSON.stringify(body), {
141
+ status: response.status, headers: response.headers,
142
+ });
143
+ },
144
+ });
145
+ },
146
+ });
147
+ `,
148
+ );
149
+ }
150
+ await writeFile(
151
+ path.join(directory, "vitest.config.mts"),
152
+ `export default ${JSON.stringify({
153
+ test: {
154
+ maxWorkers: 4,
155
+ projects: variants.map((variant) => ({
156
+ test: {
157
+ name: variant.name,
158
+ root: directory,
159
+ include: [`${variant.name}.spec.ts`],
160
+ testNamePattern: variant.scenario,
161
+ testTimeout: 20000,
162
+ hookTimeout: 20000,
163
+ },
164
+ })),
165
+ },
166
+ })};`,
167
+ );
168
+ const { code } = await exec(
169
+ process.execPath,
170
+ [
171
+ path.resolve(packageDirectory, "../../node_modules/vitest/vitest.mjs"),
172
+ "run",
173
+ "--config",
174
+ path.join(directory, "vitest.config.mts"),
175
+ "--reporter=json",
176
+ "--outputFile=results.json",
177
+ ],
178
+ { cwd: directory, timeout: 300000 },
179
+ ).then(
180
+ () => ({ code: 0 }),
181
+ (error: { code: number }) => ({ code: error.code }),
182
+ );
183
+ expect(code).toBe(1);
184
+ const result = JSON.parse(
185
+ await readFile(path.join(directory, "results.json"), "utf8"),
186
+ ) as {
187
+ testResults: {
188
+ name: string;
189
+ assertionResults: { title: string; status: string }[];
190
+ }[];
191
+ };
192
+ expect(result.testResults).toHaveLength(variants.length);
193
+ const control = result.testResults.find(
194
+ (test) => path.basename(test.name) === "control.spec.ts",
195
+ )!;
196
+ expect(control.assertionResults.length).toBeGreaterThan(0);
197
+ expect(
198
+ control.assertionResults.every((test) => test.status === "passed"),
199
+ ).toBe(true);
200
+ for (const mutation of mutations) {
201
+ const run = result.testResults.find(
202
+ (test) => path.basename(test.name) === `${mutation.name}.spec.ts`,
203
+ )!;
204
+ const detected = run.assertionResults.some(
205
+ (test) =>
206
+ test.status === "failed" && test.title.includes(mutation.scenario),
207
+ );
208
+ expect(detected, `${mutation.name} must fail: ${mutation.scenario}`).toBe(
209
+ true,
210
+ );
211
+ }
212
+ } finally {
213
+ await rm(directory, { recursive: true, force: true });
214
+ }
215
+ }, 360000);