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

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