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

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (542) hide show
  1. package/dist/_virtual/_rolldown/runtime.cjs +1 -1
  2. package/dist/adapters/drizzle.cjs +35 -69
  3. package/dist/adapters/drizzle.d.cts +13 -6
  4. package/dist/adapters/drizzle.d.mts +13 -6
  5. package/dist/adapters/drizzle.mjs +34 -69
  6. package/dist/adapters/drizzleExecutor.cjs +114 -0
  7. package/dist/adapters/drizzleExecutor.d.cts +9 -0
  8. package/dist/adapters/drizzleExecutor.d.mts +9 -0
  9. package/dist/adapters/drizzleExecutor.mjs +112 -0
  10. package/dist/adapters/kysely.cjs +25 -31
  11. package/dist/adapters/kysely.d.cts +10 -7
  12. package/dist/adapters/kysely.d.mts +10 -7
  13. package/dist/adapters/kysely.mjs +25 -31
  14. package/dist/adapters/kyselyExecutor.cjs +32 -0
  15. package/dist/adapters/kyselyExecutor.d.cts +12 -0
  16. package/dist/adapters/kyselyExecutor.d.mts +12 -0
  17. package/dist/adapters/kyselyExecutor.mjs +32 -0
  18. package/dist/adapters/mongodb.cjs +28 -27
  19. package/dist/adapters/mongodb.d.cts +10 -5
  20. package/dist/adapters/mongodb.d.mts +10 -5
  21. package/dist/adapters/mongodb.mjs +28 -27
  22. package/dist/adapters/mongodbAdapter.cjs +174 -0
  23. package/dist/adapters/mongodbAdapter.d.cts +9 -0
  24. package/dist/adapters/mongodbAdapter.d.mts +9 -0
  25. package/dist/adapters/mongodbAdapter.mjs +173 -0
  26. package/dist/adapters/prisma.cjs +38 -220
  27. package/dist/adapters/prisma.d.cts +12 -8
  28. package/dist/adapters/prisma.d.mts +12 -8
  29. package/dist/adapters/prisma.mjs +38 -219
  30. package/dist/adapters/prismaExecutor.cjs +64 -0
  31. package/dist/adapters/prismaExecutor.mjs +64 -0
  32. package/dist/adapters/sqlProviders.cjs +9 -0
  33. package/dist/adapters/sqlProviders.mjs +9 -0
  34. package/dist/apiKeys.cjs +8 -8
  35. package/dist/apiKeys.d.cts +1 -24
  36. package/dist/apiKeys.d.mts +1 -24
  37. package/dist/apiKeys.mjs +5 -9
  38. package/dist/assembly/assemblePlugins.cjs +147 -0
  39. package/dist/assembly/assemblePlugins.d.cts +12 -0
  40. package/dist/assembly/assemblePlugins.d.mts +12 -0
  41. package/dist/assembly/assemblePlugins.mjs +146 -0
  42. package/dist/assembly/databasePlugins.cjs +23 -0
  43. package/dist/assembly/databasePlugins.d.cts +43 -0
  44. package/dist/assembly/databasePlugins.d.mts +43 -0
  45. package/dist/assembly/databasePlugins.mjs +22 -0
  46. package/dist/core/api.cjs +91 -0
  47. package/dist/core/api.d.cts +65 -0
  48. package/dist/core/api.d.mts +65 -0
  49. package/dist/core/api.mjs +87 -0
  50. package/dist/core/baseCandidates.cjs +71 -0
  51. package/dist/core/baseCandidates.d.cts +17 -0
  52. package/dist/core/baseCandidates.d.mts +17 -0
  53. package/dist/core/baseCandidates.mjs +69 -0
  54. package/dist/core/operations.cjs +350 -0
  55. package/dist/core/operations.mjs +350 -0
  56. package/dist/core/reads.cjs +273 -0
  57. package/dist/core/reads.d.cts +48 -0
  58. package/dist/core/reads.d.mts +48 -0
  59. package/dist/core/reads.mjs +267 -0
  60. package/dist/core/releases.cjs +193 -0
  61. package/dist/core/releases.mjs +190 -0
  62. package/dist/core/schema.cjs +279 -0
  63. package/dist/core/schema.d.cts +307 -0
  64. package/dist/core/schema.d.mts +307 -0
  65. package/dist/core/schema.mjs +277 -0
  66. package/dist/core/writes.cjs +96 -0
  67. package/dist/core/writes.mjs +91 -0
  68. package/dist/createHotUpdaterCore.cjs +61 -63
  69. package/dist/createHotUpdaterCore.d.cts +53 -45
  70. package/dist/createHotUpdaterCore.d.mts +53 -45
  71. package/dist/createHotUpdaterCore.mjs +61 -63
  72. package/dist/database/cursor.cjs +44 -0
  73. package/dist/database/cursor.d.cts +7 -0
  74. package/dist/database/cursor.d.mts +7 -0
  75. package/dist/database/cursor.mjs +40 -0
  76. package/dist/database/database.cjs +44 -0
  77. package/dist/database/database.d.cts +123 -0
  78. package/dist/database/database.d.mts +123 -0
  79. package/dist/database/database.mjs +44 -0
  80. package/dist/database/definitions.d.cts +68 -0
  81. package/dist/database/definitions.d.mts +68 -0
  82. package/dist/database/engine.cjs +37 -0
  83. package/dist/database/engine.d.cts +40 -0
  84. package/dist/database/engine.d.mts +40 -0
  85. package/dist/database/engine.mjs +37 -0
  86. package/dist/database/engineAggregates.cjs +115 -0
  87. package/dist/database/engineAggregates.mjs +112 -0
  88. package/dist/database/engineReads.cjs +180 -0
  89. package/dist/database/engineReads.d.cts +35 -0
  90. package/dist/database/engineReads.d.mts +35 -0
  91. package/dist/database/engineReads.mjs +179 -0
  92. package/dist/database/engineTransaction.cjs +403 -0
  93. package/dist/database/engineTransaction.d.cts +26 -0
  94. package/dist/database/engineTransaction.d.mts +26 -0
  95. package/dist/database/engineTransaction.mjs +402 -0
  96. package/dist/database/errors.cjs +27 -0
  97. package/dist/database/errors.d.cts +21 -0
  98. package/dist/database/errors.d.mts +21 -0
  99. package/dist/database/errors.mjs +24 -0
  100. package/dist/database/fence.cjs +124 -0
  101. package/dist/database/fence.d.cts +42 -0
  102. package/dist/database/fence.d.mts +42 -0
  103. package/dist/database/fence.mjs +116 -0
  104. package/dist/database/index.cjs +127 -0
  105. package/dist/database/index.d.cts +17 -0
  106. package/dist/database/index.d.mts +17 -0
  107. package/dist/database/index.mjs +15 -0
  108. package/dist/database/kv/kvAdapter.cjs +273 -0
  109. package/dist/database/kv/kvAdapter.d.cts +101 -0
  110. package/dist/database/kv/kvAdapter.d.mts +101 -0
  111. package/dist/database/kv/kvAdapter.mjs +272 -0
  112. package/dist/database/resolveSchema.cjs +196 -0
  113. package/dist/database/resolveSchema.d.cts +42 -0
  114. package/dist/database/resolveSchema.d.mts +42 -0
  115. package/dist/database/resolveSchema.mjs +193 -0
  116. package/dist/database/schema.cjs +21 -0
  117. package/dist/database/schema.d.cts +61 -0
  118. package/dist/database/schema.d.mts +61 -0
  119. package/dist/database/schema.mjs +20 -0
  120. package/dist/database/sql/sqlAdapter.cjs +282 -0
  121. package/dist/database/sql/sqlAdapter.d.cts +46 -0
  122. package/dist/database/sql/sqlAdapter.d.mts +46 -0
  123. package/dist/database/sql/sqlAdapter.mjs +279 -0
  124. package/dist/database/sql/sqlSchema.cjs +115 -0
  125. package/dist/database/sql/sqlSchema.d.cts +8 -0
  126. package/dist/database/sql/sqlSchema.d.mts +8 -0
  127. package/dist/database/sql/sqlSchema.mjs +111 -0
  128. package/dist/db/builtInDatabase.cjs +104 -0
  129. package/dist/db/builtInDatabase.d.cts +38 -0
  130. package/dist/db/builtInDatabase.d.mts +38 -0
  131. package/dist/db/builtInDatabase.mjs +97 -0
  132. package/dist/db/createBundleDiff.cjs +6 -6
  133. package/dist/db/createBundleDiff.d.cts +4 -7
  134. package/dist/db/createBundleDiff.d.mts +4 -7
  135. package/dist/db/createBundleDiff.mjs +5 -5
  136. package/dist/db/engineDrizzleSchema.cjs +54 -0
  137. package/dist/db/engineDrizzleSchema.mjs +54 -0
  138. package/dist/db/engineMigrator.cjs +53 -0
  139. package/dist/db/engineMigrator.mjs +53 -0
  140. package/dist/db/enginePrismaSchema.cjs +85 -0
  141. package/dist/db/enginePrismaSchema.d.cts +5 -0
  142. package/dist/db/enginePrismaSchema.d.mts +5 -0
  143. package/dist/db/enginePrismaSchema.mjs +84 -0
  144. package/dist/db/engineSql.cjs +26 -0
  145. package/dist/db/engineSql.d.cts +17 -0
  146. package/dist/db/engineSql.d.mts +17 -0
  147. package/dist/db/engineSql.mjs +25 -0
  148. package/dist/db/engineSqlMigrator.cjs +66 -0
  149. package/dist/db/engineSqlMigrator.mjs +66 -0
  150. package/dist/db/fixedMigratorShared.cjs +0 -11
  151. package/dist/db/fixedMigratorShared.mjs +1 -8
  152. package/dist/db/index.cjs +23 -8
  153. package/dist/db/index.d.cts +10 -4
  154. package/dist/db/index.d.mts +10 -4
  155. package/dist/db/index.mjs +16 -8
  156. package/dist/db/releaseCatalog.cjs +20 -44
  157. package/dist/db/releaseCatalog.d.cts +2 -3
  158. package/dist/db/releaseCatalog.d.mts +2 -3
  159. package/dist/db/releaseCatalog.mjs +20 -44
  160. package/dist/db/schemaSettings.cjs +63 -0
  161. package/dist/db/schemaSettings.d.cts +12 -0
  162. package/dist/db/schemaSettings.d.mts +12 -0
  163. package/dist/db/schemaSettings.mjs +62 -0
  164. package/dist/db/settingsMigrator.cjs +92 -0
  165. package/dist/db/settingsMigrator.mjs +89 -0
  166. package/dist/db/types.cjs +3 -12
  167. package/dist/db/types.d.cts +26 -69
  168. package/dist/db/types.d.mts +26 -69
  169. package/dist/db/types.mjs +2 -11
  170. package/dist/db/updateArtifacts.cjs +38 -68
  171. package/dist/db/updateArtifacts.mjs +40 -69
  172. package/dist/handler.cjs +72 -43
  173. package/dist/handler.d.cts +3 -6
  174. package/dist/handler.d.mts +3 -6
  175. package/dist/handler.mjs +73 -43
  176. package/dist/handlerAdminRoutes.cjs +375 -0
  177. package/dist/handlerAdminRoutes.mjs +373 -0
  178. package/dist/handlerParameters.cjs +6 -11
  179. package/dist/handlerParameters.mjs +6 -10
  180. package/dist/handlerReleaseCatalogRoutes.cjs +11 -14
  181. package/dist/handlerReleaseCatalogRoutes.mjs +11 -13
  182. package/dist/handlerTypes.d.cts +2 -56
  183. package/dist/handlerTypes.d.mts +2 -56
  184. package/dist/handlerVersionRoutes.cjs +20 -4
  185. package/dist/handlerVersionRoutes.d.cts +1 -0
  186. package/dist/handlerVersionRoutes.d.mts +1 -0
  187. package/dist/handlerVersionRoutes.mjs +20 -4
  188. package/dist/index.cjs +4 -7
  189. package/dist/index.d.cts +10 -9
  190. package/dist/index.d.mts +10 -9
  191. package/dist/index.mjs +4 -4
  192. package/dist/insights/domain.d.cts +53 -70
  193. package/dist/insights/domain.d.mts +53 -70
  194. package/dist/insights/errors.cjs +35 -8
  195. package/dist/insights/errors.mjs +35 -8
  196. package/dist/insights/eventInput.cjs +64 -24
  197. package/dist/insights/eventInput.mjs +63 -25
  198. package/dist/insights/provider.cjs +356 -0
  199. package/dist/insights/provider.d.cts +6 -0
  200. package/dist/insights/provider.d.mts +6 -0
  201. package/dist/insights/provider.mjs +355 -0
  202. package/dist/insights/queryInput.cjs +78 -43
  203. package/dist/insights/queryInput.mjs +76 -40
  204. package/dist/insights/routes.cjs +94 -34
  205. package/dist/insights/routes.mjs +93 -35
  206. package/dist/insights/types.d.cts +27 -12
  207. package/dist/insights/types.d.mts +27 -12
  208. package/dist/node.d.cts +1 -2
  209. package/dist/node.d.mts +1 -2
  210. package/dist/package.cjs +1 -1
  211. package/dist/package.mjs +1 -1
  212. package/dist/plugins/api-keys/index.cjs +50 -0
  213. package/dist/plugins/api-keys/index.d.cts +85 -0
  214. package/dist/plugins/api-keys/index.d.mts +85 -0
  215. package/dist/plugins/api-keys/index.mjs +47 -0
  216. package/dist/plugins/api-keys/model.cjs +58 -0
  217. package/dist/plugins/api-keys/model.d.cts +8 -0
  218. package/dist/plugins/api-keys/model.d.mts +8 -0
  219. package/dist/plugins/api-keys/model.mjs +58 -0
  220. package/dist/plugins/api-keys/schema.cjs +38 -0
  221. package/dist/plugins/api-keys/schema.d.cts +44 -0
  222. package/dist/plugins/api-keys/schema.d.mts +44 -0
  223. package/dist/plugins/api-keys/schema.mjs +39 -0
  224. package/dist/plugins/builtIn.cjs +7 -0
  225. package/dist/plugins/builtIn.mjs +6 -0
  226. package/dist/plugins/definePlugin.cjs +5 -0
  227. package/dist/plugins/definePlugin.d.cts +73 -0
  228. package/dist/plugins/definePlugin.d.mts +73 -0
  229. package/dist/plugins/definePlugin.mjs +5 -0
  230. package/dist/plugins/index.cjs +17 -0
  231. package/dist/plugins/index.d.cts +9 -0
  232. package/dist/plugins/index.d.mts +9 -0
  233. package/dist/plugins/index.mjs +7 -0
  234. package/dist/plugins/insights/index.cjs +48 -0
  235. package/dist/plugins/insights/index.d.cts +295 -0
  236. package/dist/plugins/insights/index.d.mts +295 -0
  237. package/dist/plugins/insights/index.mjs +44 -0
  238. package/dist/plugins/insights/model.cjs +17 -0
  239. package/dist/plugins/insights/model.d.cts +10 -0
  240. package/dist/plugins/insights/model.d.mts +10 -0
  241. package/dist/plugins/insights/model.mjs +17 -0
  242. package/dist/plugins/insights/reads.cjs +471 -0
  243. package/dist/plugins/insights/reads.mjs +466 -0
  244. package/dist/plugins/insights/recordEvent.cjs +135 -0
  245. package/dist/plugins/insights/recordEvent.d.cts +13 -0
  246. package/dist/plugins/insights/recordEvent.d.mts +13 -0
  247. package/dist/plugins/insights/recordEvent.mjs +132 -0
  248. package/dist/plugins/insights/schema.cjs +347 -0
  249. package/dist/plugins/insights/schema.d.cts +258 -0
  250. package/dist/plugins/insights/schema.d.mts +258 -0
  251. package/dist/plugins/insights/schema.mjs +344 -0
  252. package/dist/storageAccess.cjs +0 -1
  253. package/dist/types/index.d.cts +2 -29
  254. package/dist/types/index.d.mts +2 -29
  255. package/package.json +30 -7
  256. package/src/adapters/drizzle.conformance.integration.spec.ts +34 -0
  257. package/src/adapters/drizzle.readBudgets.integration.spec.ts +41 -0
  258. package/src/adapters/drizzle.spec.ts +277 -208
  259. package/src/adapters/drizzle.ts +48 -128
  260. package/src/adapters/drizzleExecutor.ts +166 -0
  261. package/src/adapters/kysely.conformance.integration.spec.ts +36 -0
  262. package/src/adapters/kysely.readBudgets.integration.spec.ts +42 -0
  263. package/src/adapters/kysely.spec.ts +212 -117
  264. package/src/adapters/kysely.ts +32 -87
  265. package/src/adapters/kyselyExecutor.ts +53 -0
  266. package/src/adapters/mongodb.integration.spec.ts +180 -0
  267. package/src/adapters/mongodb.readBudgets.integration.spec.ts +61 -0
  268. package/src/adapters/mongodb.ts +36 -65
  269. package/src/adapters/mongodbAdapter.ts +293 -0
  270. package/src/adapters/prisma.conformance.integration.spec.ts +36 -0
  271. package/src/adapters/prisma.integration.spec.ts +138 -0
  272. package/src/adapters/prisma.readBudgets.integration.spec.ts +40 -0
  273. package/src/adapters/prisma.spec.ts +226 -173
  274. package/src/adapters/prisma.ts +60 -451
  275. package/src/adapters/prismaExecutor.ts +107 -0
  276. package/src/adapters/prismaTestClients.ts +175 -0
  277. package/src/adapters/sqlProviders.ts +14 -0
  278. package/src/apiKeys.integration.spec.ts +19 -119
  279. package/src/apiKeys.spec.ts +39 -35
  280. package/src/apiKeys.ts +2 -8
  281. package/src/assembly/assemblePlugins.ts +269 -0
  282. package/src/assembly/assembly.spec.ts +325 -0
  283. package/src/assembly/assembly.types.spec.ts +155 -0
  284. package/src/assembly/builtInRoutes.spec.ts +213 -0
  285. package/src/assembly/databasePlugins.spec.ts +71 -0
  286. package/src/assembly/databasePlugins.ts +96 -0
  287. package/src/core/api.ts +139 -0
  288. package/src/core/baseCandidates.spec.ts +378 -0
  289. package/src/core/baseCandidates.ts +136 -0
  290. package/src/core/index.ts +44 -0
  291. package/src/core/operations.spec.ts +415 -0
  292. package/src/core/operations.ts +551 -0
  293. package/src/core/reads.spec.ts +300 -0
  294. package/src/core/reads.ts +417 -0
  295. package/src/core/releases.spec.ts +308 -0
  296. package/src/core/releases.ts +345 -0
  297. package/src/core/schema.ts +173 -0
  298. package/src/core/writes.ts +160 -0
  299. package/src/createHotUpdaterCore.ts +191 -167
  300. package/src/database/cursor.ts +65 -0
  301. package/src/database/database.ts +335 -0
  302. package/src/database/database.types.spec.ts +135 -0
  303. package/src/database/definitions.ts +72 -0
  304. package/src/database/engine.ts +62 -0
  305. package/src/database/engineAggregates.spec.ts +539 -0
  306. package/src/database/engineAggregates.ts +193 -0
  307. package/src/database/engineReads.spec.ts +219 -0
  308. package/src/database/engineReads.ts +302 -0
  309. package/src/database/engineTransaction.spec.ts +710 -0
  310. package/src/database/engineTransaction.ts +588 -0
  311. package/src/database/errors.ts +30 -0
  312. package/src/database/fence.spec.ts +223 -0
  313. package/src/database/fence.ts +171 -0
  314. package/src/database/index.ts +154 -0
  315. package/src/database/kv/kvAdapter.conformance.integration.spec.ts +17 -0
  316. package/src/database/kv/kvAdapter.readBudgets.integration.spec.ts +17 -0
  317. package/src/database/kv/kvAdapter.spec.ts +468 -0
  318. package/src/database/kv/kvAdapter.ts +450 -0
  319. package/src/database/kv/kvTestStore.ts +91 -0
  320. package/src/database/memory.readBudgets.integration.spec.ts +13 -0
  321. package/src/database/resolveSchema.spec.ts +230 -0
  322. package/src/database/resolveSchema.ts +372 -0
  323. package/src/database/schema.ts +169 -0
  324. package/src/database/schema.types.spec.ts +94 -0
  325. package/src/database/sql/docker-compose.yml +36 -0
  326. package/src/database/sql/sqlAdapter.integration.spec.ts +148 -0
  327. package/src/database/sql/sqlAdapter.readBudgets.integration.spec.ts +109 -0
  328. package/src/database/sql/sqlAdapter.spec.ts +255 -0
  329. package/src/database/sql/sqlAdapter.ts +532 -0
  330. package/src/database/sql/sqlSchema.ts +205 -0
  331. package/src/database/sql/sqlTestExecutors.ts +183 -0
  332. package/src/databaseTestSuite.spec.ts +39 -0
  333. package/src/db/builtInDatabase.ts +149 -0
  334. package/src/db/bundleRows.spec.ts +3 -3
  335. package/src/db/createBundleDiff.spec.ts +43 -29
  336. package/src/db/createBundleDiff.ts +13 -7
  337. package/src/db/engineDrizzleSchema.ts +72 -0
  338. package/src/db/engineMigrator.ts +105 -0
  339. package/src/db/enginePrismaSchema.ts +147 -0
  340. package/src/db/engineSql.spec.ts +129 -0
  341. package/src/db/engineSql.ts +48 -0
  342. package/src/db/engineSqlMigrator.ts +116 -0
  343. package/src/db/fixedMigratorShared.ts +1 -20
  344. package/src/db/index.spec.ts +116 -824
  345. package/src/db/index.ts +43 -14
  346. package/src/db/pluginTables.spec.ts +218 -0
  347. package/src/db/releaseCatalog.ts +48 -90
  348. package/src/db/schemaSettings.ts +104 -0
  349. package/src/db/settingsMigrator.spec.ts +65 -0
  350. package/src/db/settingsMigrator.ts +152 -0
  351. package/src/db/types.ts +25 -165
  352. package/src/db/updateArtifacts.spec.ts +170 -294
  353. package/src/db/updateArtifacts.ts +74 -142
  354. package/src/db/updateCheck.bench.ts +47 -0
  355. package/src/handler-standalone.integration.spec.ts +204 -412
  356. package/src/handler.spec.ts +134 -51
  357. package/src/handler.testFixtures.ts +14 -19
  358. package/src/handler.ts +163 -75
  359. package/src/handlerAdminRoutes.spec.ts +183 -0
  360. package/src/handlerAdminRoutes.ts +536 -0
  361. package/src/handlerAuth.integration.spec.ts +3 -3
  362. package/src/handlerManagement.spec.ts +136 -196
  363. package/src/handlerReleaseCatalogRoutes.ts +15 -17
  364. package/src/handlerTypes.ts +3 -80
  365. package/src/handlerVersionRoutes.ts +20 -7
  366. package/src/index.ts +7 -14
  367. package/src/insights/domain.ts +56 -77
  368. package/src/insights/errors.spec.ts +48 -0
  369. package/src/insights/errors.ts +50 -6
  370. package/src/insights/eventInput.ts +80 -27
  371. package/src/insights/insights.integration.spec.ts +525 -44
  372. package/src/insights/provider.spec.ts +574 -0
  373. package/src/insights/provider.ts +667 -0
  374. package/src/insights/queryInput.ts +113 -73
  375. package/src/insights/routes.ts +125 -69
  376. package/src/insights/types.ts +47 -36
  377. package/src/lintRules.spec.ts +76 -0
  378. package/src/plugins/api-keys/apiKeysPlugin.spec.ts +172 -0
  379. package/src/plugins/api-keys/index.ts +66 -0
  380. package/src/plugins/api-keys/model.ts +69 -0
  381. package/src/plugins/api-keys/schema.ts +22 -0
  382. package/src/plugins/builtIn.ts +5 -0
  383. package/src/plugins/definePlugin.ts +100 -0
  384. package/src/plugins/index.ts +55 -0
  385. package/src/plugins/insights/index.ts +86 -0
  386. package/src/plugins/insights/insightsRollout.integration.spec.ts +187 -0
  387. package/src/plugins/insights/model.spec.ts +66 -0
  388. package/src/plugins/insights/model.ts +19 -0
  389. package/src/plugins/insights/reads.spec.ts +725 -0
  390. package/src/plugins/insights/reads.ts +707 -0
  391. package/src/plugins/insights/recordEvent.spec.ts +443 -0
  392. package/src/plugins/insights/recordEvent.ts +238 -0
  393. package/src/plugins/insights/schema.ts +229 -0
  394. package/src/plugins/pluginTestHarness.spec.ts +56 -0
  395. package/src/readBudgets.testFixtures.ts +15 -0
  396. package/src/releaseCatalogRoutes.integration.spec.ts +47 -92
  397. package/src/runtime.spec.ts +91 -77
  398. package/src/runtime.testFixtures.ts +28 -44
  399. package/src/runtimeBundles.integration.spec.ts +112 -0
  400. package/src/testUtilsMutation.integration.spec.ts +215 -0
  401. package/src/testUtilsPackage.integration.spec.ts +176 -0
  402. package/src/types/index.ts +0 -32
  403. package/dist/adapters/databaseConstraintErrors.cjs +0 -23
  404. package/dist/adapters/databaseConstraintErrors.mjs +0 -21
  405. package/dist/adapters/databasePluginUtils.cjs +0 -117
  406. package/dist/adapters/databasePluginUtils.mjs +0 -106
  407. package/dist/adapters/drizzleCrud.cjs +0 -250
  408. package/dist/adapters/drizzleCrud.mjs +0 -249
  409. package/dist/adapters/drizzleLazyDB.cjs +0 -101
  410. package/dist/adapters/drizzleLazyDB.mjs +0 -101
  411. package/dist/adapters/drizzleQuery.cjs +0 -68
  412. package/dist/adapters/drizzleQuery.mjs +0 -67
  413. package/dist/adapters/kyselyCrud.cjs +0 -254
  414. package/dist/adapters/kyselyCrud.mjs +0 -253
  415. package/dist/adapters/kyselyQuery.cjs +0 -56
  416. package/dist/adapters/kyselyQuery.mjs +0 -55
  417. package/dist/adapters/mongodbCollections.cjs +0 -36
  418. package/dist/adapters/mongodbCollections.mjs +0 -30
  419. package/dist/adapters/mongodbQuery.cjs +0 -77
  420. package/dist/adapters/mongodbQuery.mjs +0 -70
  421. package/dist/adapters/mongodbReads.cjs +0 -148
  422. package/dist/adapters/mongodbReads.mjs +0 -147
  423. package/dist/adapters/mongodbWrites.cjs +0 -134
  424. package/dist/adapters/mongodbWrites.mjs +0 -133
  425. package/dist/adapters/prismaQuery.cjs +0 -58
  426. package/dist/adapters/prismaQuery.mjs +0 -56
  427. package/dist/adapters/prismaRows.cjs +0 -198
  428. package/dist/adapters/prismaRows.mjs +0 -188
  429. package/dist/db/databasePluginCore.cjs +0 -138
  430. package/dist/db/databasePluginCore.mjs +0 -137
  431. package/dist/db/fixedMigrator.cjs +0 -79
  432. package/dist/db/fixedMigrator.mjs +0 -78
  433. package/dist/db/fixedMigratorMongo.cjs +0 -319
  434. package/dist/db/fixedMigratorMongo.mjs +0 -319
  435. package/dist/db/mongoMigrationExecution.cjs +0 -11
  436. package/dist/db/mongoMigrationExecution.mjs +0 -11
  437. package/dist/db/schema/mongodb.cjs +0 -25
  438. package/dist/db/schema/mongodb.mjs +0 -25
  439. package/dist/db/schema/registry.cjs +0 -21
  440. package/dist/db/schema/registry.mjs +0 -17
  441. package/dist/db/schema/sql.cjs +0 -101
  442. package/dist/db/schema/sql.mjs +0 -97
  443. package/dist/db/schema/sqlOperations.cjs +0 -27
  444. package/dist/db/schema/sqlOperations.mjs +0 -26
  445. package/dist/db/schemaGenerators.cjs +0 -256
  446. package/dist/db/schemaGenerators.mjs +0 -254
  447. package/dist/db/schemaReadiness.cjs +0 -24
  448. package/dist/db/schemaReadiness.d.cts +0 -8
  449. package/dist/db/schemaReadiness.d.mts +0 -8
  450. package/dist/db/schemaReadiness.mjs +0 -23
  451. package/dist/db/sqlMigrationExecution.cjs +0 -67
  452. package/dist/db/sqlMigrationExecution.mjs +0 -66
  453. package/dist/handlerBundleRoutes.cjs +0 -155
  454. package/dist/handlerBundleRoutes.mjs +0 -155
  455. package/dist/handlerReleaseManagementRoutes.cjs +0 -125
  456. package/dist/handlerReleaseManagementRoutes.mjs +0 -124
  457. package/dist/insights/bounded/activeOverview.cjs +0 -87
  458. package/dist/insights/bounded/activeOverview.mjs +0 -85
  459. package/dist/insights/bounded/installationSearch.cjs +0 -42
  460. package/dist/insights/bounded/installationSearch.mjs +0 -42
  461. package/dist/insights/bounded/persistence.cjs +0 -39
  462. package/dist/insights/bounded/persistence.mjs +0 -38
  463. package/dist/insights/bounded/provider.cjs +0 -170
  464. package/dist/insights/bounded/provider.d.cts +0 -7
  465. package/dist/insights/bounded/provider.d.mts +0 -7
  466. package/dist/insights/bounded/provider.mjs +0 -170
  467. package/dist/insights/bounded/scan.cjs +0 -144
  468. package/dist/insights/bounded/scan.mjs +0 -138
  469. package/dist/insights/persistence.d.cts +0 -6
  470. package/dist/insights/persistence.d.mts +0 -6
  471. package/dist/schema/dsl.cjs +0 -103
  472. package/dist/schema/dsl.mjs +0 -87
  473. package/dist/schema/index.cjs +0 -6
  474. package/dist/schema/index.mjs +0 -7
  475. package/dist/schema/settings.cjs +0 -9
  476. package/dist/schema/settings.mjs +0 -9
  477. package/dist/schema/types.cjs +0 -8
  478. package/dist/schema/types.mjs +0 -6
  479. package/dist/schema/v1_0_0.cjs +0 -364
  480. package/dist/schema/v1_0_0.mjs +0 -357
  481. package/src/adapters/databaseConstraintErrors.ts +0 -25
  482. package/src/adapters/databasePluginTestDatabase.ts +0 -106
  483. package/src/adapters/databasePluginUtils.spec.ts +0 -29
  484. package/src/adapters/databasePluginUtils.ts +0 -214
  485. package/src/adapters/drizzleCrud.ts +0 -419
  486. package/src/adapters/drizzleLazyDB.ts +0 -257
  487. package/src/adapters/drizzleQuery.ts +0 -164
  488. package/src/adapters/kyselyCrud.ts +0 -588
  489. package/src/adapters/kyselyQuery.ts +0 -128
  490. package/src/adapters/mongodb.spec.ts +0 -141
  491. package/src/adapters/mongodbCollections.ts +0 -62
  492. package/src/adapters/mongodbQuery.ts +0 -226
  493. package/src/adapters/mongodbReads.ts +0 -311
  494. package/src/adapters/mongodbRows.spec.ts +0 -64
  495. package/src/adapters/mongodbRows.ts +0 -118
  496. package/src/adapters/mongodbTestClient.ts +0 -342
  497. package/src/adapters/mongodbTestFilter.ts +0 -166
  498. package/src/adapters/mongodbWrites.ts +0 -260
  499. package/src/adapters/prismaQuery.ts +0 -129
  500. package/src/adapters/prismaRows.spec.ts +0 -98
  501. package/src/adapters/prismaRows.ts +0 -301
  502. package/src/adapters/prismaTestClient.ts +0 -396
  503. package/src/calculatePagination.ts +0 -34
  504. package/src/db/databasePluginCore.spec.ts +0 -62
  505. package/src/db/databasePluginCore.testFixtures.ts +0 -76
  506. package/src/db/databasePluginCore.ts +0 -185
  507. package/src/db/databasePluginUpdateCheck.bench.ts +0 -107
  508. package/src/db/fixedMigrator.spec.ts +0 -231
  509. package/src/db/fixedMigrator.ts +0 -147
  510. package/src/db/fixedMigratorMongo.spec.ts +0 -192
  511. package/src/db/fixedMigratorMongo.ts +0 -425
  512. package/src/db/hotUpdaterSchema.ts +0 -5
  513. package/src/db/mongoMigrationExecution.ts +0 -23
  514. package/src/db/schema/definitions.ts +0 -1
  515. package/src/db/schema/mongodb.ts +0 -40
  516. package/src/db/schema/registry.ts +0 -55
  517. package/src/db/schema/sql.ts +0 -241
  518. package/src/db/schema/sqlOperations.ts +0 -63
  519. package/src/db/schema/types.ts +0 -1
  520. package/src/db/schemaGenerators.ts +0 -466
  521. package/src/db/schemaReadiness.ts +0 -34
  522. package/src/db/sqlMigrationExecution.spec.ts +0 -65
  523. package/src/db/sqlMigrationExecution.ts +0 -108
  524. package/src/db/types.spec.ts +0 -55
  525. package/src/handlerBundleRoutes.ts +0 -259
  526. package/src/handlerReleaseManagementRoutes.ts +0 -213
  527. package/src/insights/bounded/activeOverview.spec.ts +0 -189
  528. package/src/insights/bounded/activeOverview.ts +0 -148
  529. package/src/insights/bounded/installationSearch.spec.ts +0 -130
  530. package/src/insights/bounded/installationSearch.ts +0 -69
  531. package/src/insights/bounded/persistence.ts +0 -43
  532. package/src/insights/bounded/provider.spec.ts +0 -219
  533. package/src/insights/bounded/provider.ts +0 -229
  534. package/src/insights/bounded/scan.ts +0 -235
  535. package/src/insights/persistence.ts +0 -10
  536. package/src/schema/dsl-all-versions.spec.ts +0 -35
  537. package/src/schema/dsl.ts +0 -187
  538. package/src/schema/index.ts +0 -10
  539. package/src/schema/settings.ts +0 -15
  540. package/src/schema/types.ts +0 -79
  541. package/src/schema/v1_0_0.spec.ts +0 -146
  542. package/src/schema/v1_0_0.ts +0 -465
@@ -2,12 +2,8 @@ import type { ReleaseCatalog } from "@hot-updater/core";
2
2
  import { Hono } from "hono";
3
3
  import { describe, expect, it, vi } from "vitest";
4
4
 
5
- import {
6
- createHandlers,
7
- createHotUpdaterHandlers,
8
- type HandlerAPI,
9
- } from "./handler";
10
- import { createApi } from "./handler.testFixtures";
5
+ import { createHotUpdaterHandlers } from "./handler";
6
+ import { createApi, createHandlers } from "./handler.testFixtures";
11
7
  import { HOT_UPDATER_INFRASTRUCTURE_GENERATION } from "./handlerVersionRoutes";
12
8
  import { HOT_UPDATER_SERVER_VERSION } from "./version";
13
9
 
@@ -18,6 +14,22 @@ describe("createHandlers client routes", () => {
18
14
 
19
15
  expect(response.status).toBe(200);
20
16
  await expect(response.json()).resolves.toEqual({
17
+ adminProtocol: 2,
18
+ infrastructureGeneration: HOT_UPDATER_INFRASTRUCTURE_GENERATION,
19
+ version: HOT_UPDATER_SERVER_VERSION,
20
+ });
21
+ });
22
+
23
+ it("keeps the plugins the server runs off the client /version", async () => {
24
+ const handler = createHotUpdaterHandlers({
25
+ api: createApi(),
26
+ plugins: ["insights", "apiKeys"],
27
+ }).client;
28
+
29
+ const response = await handler(new Request("http://localhost/version"));
30
+
31
+ await expect(response.json()).resolves.toEqual({
32
+ adminProtocol: 2,
21
33
  infrastructureGeneration: HOT_UPDATER_INFRASTRUCTURE_GENERATION,
22
34
  version: HOT_UPDATER_SERVER_VERSION,
23
35
  });
@@ -37,7 +49,8 @@ describe("createHandlers client routes", () => {
37
49
  it.each([
38
50
  "/v2/release-catalogs/app-version/ios/cHJvZHVjdGlvbg/1.0.0",
39
51
  "/v2/artifacts/target-bundle/from/current-bundle",
40
- ])("does not expose the version-prefixed route %s", async (path) => {
52
+ "/artifacts/target-bundle/from/current-bundle",
53
+ ])("does not expose the unsupported route %s", async (path) => {
41
54
  const handler = createHandlers(createApi()).client;
42
55
 
43
56
  const response = await handler(new Request(`http://localhost${path}`));
@@ -65,13 +78,11 @@ describe("createHandlers client routes", () => {
65
78
  schemaVersion: 1,
66
79
  scopeKey: "v1:fingerprint:android:cHJvZHVjdGlvbg:fingerprint-123",
67
80
  } satisfies ReleaseCatalog;
81
+ const api = createApi();
68
82
  const getReleaseCatalog = vi
69
- .fn<NonNullable<HandlerAPI["getReleaseCatalog"]>>()
83
+ .spyOn(api.core, "getReleaseCatalog")
70
84
  .mockResolvedValue(catalog);
71
- const handler = createHandlers({
72
- ...createApi(),
73
- getReleaseCatalog,
74
- }).client;
85
+ const handler = createHandlers(api).client;
75
86
  const url =
76
87
  "http://localhost/release-catalogs/fingerprint/android/" +
77
88
  "cHJvZHVjdGlvbg/fingerprint-123";
@@ -97,75 +108,147 @@ describe("createHandlers client routes", () => {
97
108
  });
98
109
 
99
110
  it("serves client-relative storage paths under a framework mount", async () => {
100
- const api = {
101
- ...createApi(),
102
- getArtifactInfo: vi.fn().mockResolvedValue({
103
- changedAssets: {
104
- "index.bundle": {
105
- file: {
106
- url: "/storage/asset-token/asset-signature",
107
- },
108
- fileHash: "asset-hash",
109
- patch: {
110
- algorithm: "bsdiff",
111
- baseBundleId: "bundle-1",
112
- baseFileHash: "base-hash",
113
- patchFileHash: "patch-hash",
114
- patchUrl: "/storage/patch-token/patch-signature",
115
- },
111
+ const api = createApi();
112
+ vi.spyOn(api.core, "getArtifactInfo").mockResolvedValue({
113
+ artifactProtocolVersion: 1,
114
+ assets: {
115
+ "index.bundle": {
116
+ file: {
117
+ url: "/storage/asset-token/asset-signature",
118
+ },
119
+ fileHash: "asset-hash",
120
+ patch: {
121
+ algorithm: "bsdiff",
122
+ baseBundleId: "bundle-1",
123
+ baseFileHash: "base-hash",
124
+ patchFileHash: "patch-hash",
125
+ patchUrl: "/storage/patch-token/patch-signature",
116
126
  },
117
127
  },
118
- fileHash: "archive-hash",
119
- fileUrl: "/storage/archive-token/archive-signature",
120
- manifestFileHash: "manifest-hash",
121
- manifestUrl: "/storage/manifest-token/manifest-signature",
122
- }),
123
- };
124
- const handlers = createHotUpdaterHandlers(
128
+ },
129
+ manifestFileHash: "manifest-hash",
130
+ manifestUrl: "/storage/manifest-token/manifest-signature",
131
+ });
132
+ const handlers = createHotUpdaterHandlers({
125
133
  api,
126
- undefined,
127
- undefined,
128
- async () => new Response("bundle archive"),
129
- );
134
+ downloadStorageObject: async () => new Response("bundle archive"),
135
+ });
130
136
  const app = new Hono();
131
137
  app.mount("/hot-updater", handlers.client);
132
138
 
133
139
  const response = await app.request(
134
- "/hot-updater/artifacts/bundle-2/from/bundle-1",
140
+ "/hot-updater/artifacts/v1/bundle-2/from/bundle-1",
135
141
  );
136
142
 
137
143
  expect(response.status).toBe(200);
138
144
  const info = (await response.json()) as {
139
- changedAssets: Record<
145
+ assets: Record<
140
146
  string,
141
147
  { file: { url: string }; patch: { patchUrl: string } }
142
148
  >;
143
- fileUrl: string;
144
149
  manifestUrl: string;
145
150
  };
146
151
  expect(info).toMatchObject({
147
- changedAssets: {
152
+ assets: {
148
153
  "index.bundle": {
149
154
  file: { url: "/storage/asset-token/asset-signature" },
150
155
  patch: { patchUrl: "/storage/patch-token/patch-signature" },
151
156
  },
152
157
  },
153
- fileUrl: "/storage/archive-token/archive-signature",
154
158
  manifestUrl: "/storage/manifest-token/manifest-signature",
155
159
  });
156
160
 
157
- const download = await app.request(`/hot-updater${info.fileUrl}`);
161
+ const download = await app.request(
162
+ `/hot-updater${info.assets["index.bundle"]!.file.url}`,
163
+ );
158
164
  expect(download.status).toBe(200);
159
165
  await expect(download.text()).resolves.toBe("bundle archive");
160
166
  });
161
167
 
168
+ it("serves artifact protocol v1 on an explicit route", async () => {
169
+ const api = createApi();
170
+ const getArtifactInfo = vi
171
+ .spyOn(api.core, "getArtifactInfo")
172
+ .mockResolvedValue({
173
+ artifactProtocolVersion: 1,
174
+ assets: {
175
+ "index.ios.bundle": {
176
+ file: { url: "/storage/file-token/file-signature" },
177
+ fileHash: "target-hash",
178
+ },
179
+ },
180
+ manifestFileHash: "manifest-hash",
181
+ manifestUrl: "/storage/manifest-token/manifest-signature",
182
+ });
183
+ const handler = createHandlers(api).client;
184
+
185
+ const response = await handler(
186
+ new Request("http://localhost/artifacts/v1/target/from/current"),
187
+ );
188
+
189
+ expect(response.status).toBe(200);
190
+ expect(response.headers.get("content-type")).toBe(
191
+ "application/vnd.hot-updater.artifact+json; version=1",
192
+ );
193
+ await expect(response.json()).resolves.toMatchObject({
194
+ artifactProtocolVersion: 1,
195
+ assets: {
196
+ "index.ios.bundle": {
197
+ file: { url: "/storage/file-token/file-signature" },
198
+ },
199
+ },
200
+ });
201
+ expect(getArtifactInfo).toHaveBeenCalledWith("target", "current", 1);
202
+ });
203
+
204
+ it("authenticates artifact protocol v1 before resolving artifacts", async () => {
205
+ const api = createApi();
206
+ const getArtifactInfo = vi
207
+ .spyOn(api.core, "getArtifactInfo")
208
+ .mockResolvedValue({
209
+ artifactProtocolVersion: 1,
210
+ assets: {},
211
+ manifestFileHash: "manifest-hash",
212
+ manifestUrl: "/storage/manifest-token/manifest-signature",
213
+ });
214
+ const authenticate = vi.fn(async (request: Request) => {
215
+ const apiKey = request.headers.get("x-api-key");
216
+ if (apiKey === "unavailable") {
217
+ throw new Error("credential storage unavailable");
218
+ }
219
+ return apiKey === "valid";
220
+ });
221
+ const handler = createHotUpdaterHandlers({
222
+ api,
223
+ clientPolicy: { authenticate, varyHeaders: ["x-api-key"] },
224
+ }).client;
225
+ const url = "http://localhost/artifacts/v1/target/from/current";
226
+
227
+ const missing = await handler(new Request(url));
228
+ const invalid = await handler(
229
+ new Request(url, { headers: { "x-api-key": "invalid" } }),
230
+ );
231
+ const valid = await handler(
232
+ new Request(url, { headers: { "x-api-key": "valid" } }),
233
+ );
234
+ const unavailable = await handler(
235
+ new Request(url, { headers: { "x-api-key": "unavailable" } }),
236
+ );
237
+
238
+ expect(missing.status).toBe(401);
239
+ expect(invalid.status).toBe(401);
240
+ expect(valid.status).toBe(200);
241
+ expect(unavailable.status).toBe(503);
242
+ expect(authenticate).toHaveBeenCalledTimes(4);
243
+ expect(getArtifactInfo).toHaveBeenCalledOnce();
244
+ expect(getArtifactInfo).toHaveBeenCalledWith("target", "current", 1);
245
+ });
246
+
162
247
  it("does not expose provider errors from the public client handler", async () => {
163
- const api = {
164
- ...createApi(),
165
- getReleaseCatalog: vi
166
- .fn()
167
- .mockRejectedValue(new Error("private database connection details")),
168
- };
248
+ const api = createApi();
249
+ vi.spyOn(api.core, "getReleaseCatalog").mockRejectedValue(
250
+ new Error("private database connection details"),
251
+ );
169
252
  const consoleError = vi
170
253
  .spyOn(console, "error")
171
254
  .mockImplementation(() => {});
@@ -1,30 +1,25 @@
1
1
  import type { Bundle } from "@hot-updater/core";
2
- import { vi } from "vitest";
2
+ import { createMemoryAdapter } from "@hot-updater/plugin-core/internal";
3
3
 
4
- import { createHandlers, type HandlerAPI } from "./handler";
4
+ import { createInProcessCoreApi } from "./core/api";
5
+ import { createHotUpdaterHandlers, type HandlerAPI } from "./handler";
5
6
 
6
7
  export const testBundle: Bundle = {
7
8
  id: "bundle-1",
8
9
  platform: "ios",
9
- fileHash: "hash123",
10
10
  gitCommitHash: null,
11
- storageUri: "s3://test-bucket/bundles/bundle-1.zip",
12
- archiveByteSize: 3_000_000_001,
11
+ manifestStorageUri: "s3://test-bucket/bundles/bundle-1/manifest.json",
12
+ manifestFileHash: "manifest-hash",
13
+ assetBaseStorageUri: "s3://test-bucket/assets",
13
14
  };
14
15
 
15
- export const createApi = () =>
16
- ({
17
- getBundleById: vi.fn<HandlerAPI["getBundleById"]>(),
18
- getBundles: vi.fn<HandlerAPI["getBundles"]>(),
19
- getChannels: vi
20
- .fn<HandlerAPI["getChannels"]>()
21
- .mockResolvedValue([{ id: "channel-production", name: "production" }]),
22
- insertChannel: vi.fn<HandlerAPI["insertChannel"]>(),
23
- deleteChannel: vi.fn<HandlerAPI["deleteChannel"]>(),
24
- insertBundle: vi.fn<HandlerAPI["insertBundle"]>(),
25
- updateBundleById: vi.fn<HandlerAPI["updateBundleById"]>(),
26
- deleteBundleById: vi.fn<HandlerAPI["deleteBundleById"]>(),
27
- }) satisfies HandlerAPI;
16
+ /** Core on an empty in-memory database; spy on a method to stub it. */
17
+ export const createApi = (): HandlerAPI => ({
18
+ core: createInProcessCoreApi(createMemoryAdapter()),
19
+ });
28
20
 
29
- export const createAdminHandler = (api: HandlerAPI) =>
21
+ export const createHandlers = (api: HandlerAPI = createApi()) =>
22
+ createHotUpdaterHandlers({ api });
23
+
24
+ export const createAdminHandler = (api: HandlerAPI = createApi()) =>
30
25
  createHandlers(api).admin;
package/src/handler.ts CHANGED
@@ -1,7 +1,9 @@
1
- import { createBundleRouteHandlers } from "./handlerBundleRoutes";
1
+ import type { MountedEndpoint } from "./assembly/assemblePlugins";
2
+ import { HotUpdaterConfigError } from "./assembly/assemblePlugins";
3
+ import { HotUpdaterSchemaMigrationRequiredError } from "./database/fence";
4
+ import { ADMIN_ROUTES, createAdminRouteHandlers } from "./handlerAdminRoutes";
2
5
  import { HandlerBadRequestError } from "./handlerErrors";
3
6
  import { createReleaseCatalogRouteHandlers } from "./handlerReleaseCatalogRoutes";
4
- import { createReleaseManagementRouteHandlers } from "./handlerReleaseManagementRoutes";
5
7
  import type {
6
8
  HandlerAPI,
7
9
  HotUpdaterHandler,
@@ -10,11 +12,10 @@ import type {
10
12
  } from "./handlerTypes";
11
13
  import { createVersionRouteHandlers } from "./handlerVersionRoutes";
12
14
  import {
13
- createInsightsRouteHandlers,
14
- registerInsightsAdminRoutes,
15
- registerInsightsClientRoutes,
15
+ createDroppedEventHandler,
16
+ INSIGHTS_ROUTES,
17
+ insightsDisabled,
16
18
  } from "./insights/routes";
17
- import type { InsightsProvider } from "./insights/types";
18
19
  import { addRoute, createRouter, findRoute } from "./internalRouter";
19
20
 
20
21
  export type {
@@ -42,24 +43,65 @@ const errorResponse = (error: string, status: number): Response =>
42
43
  },
43
44
  );
44
45
 
45
- const requiresApiKey = (handlerName: string): boolean =>
46
- handlerName === "appVersionReleaseCatalog" ||
47
- handlerName === "fingerprintReleaseCatalog" ||
48
- handlerName === "artifact" ||
49
- handlerName === "appendBundleEvent";
46
+ /** The client-route policy: the clientAuth of the plugin that provides it. */
47
+ export interface ClientRoutePolicy {
48
+ /** Request headers the decision reads; added to `Vary` on cacheable responses. */
49
+ readonly varyHeaders: readonly string[];
50
+ readonly authenticate: (request: Request) => Promise<boolean>;
51
+ }
52
+
53
+ /** `/version` and storage downloads never pass through the client policy. */
54
+ const PUBLIC_CLIENT_ROUTES = new Set(["version", "downloadStorageObject"]);
55
+
56
+ export type RouteAccess = "public" | "client" | "admin";
57
+
58
+ export interface HotUpdaterRoute {
59
+ readonly method: string;
60
+ readonly path: string;
61
+ readonly access: RouteAccess;
62
+ }
63
+
64
+ const routesOf = Symbol.for("@hot-updater/server/routes");
65
+
66
+ /** Every mounted route, for the route snapshot. */
67
+ export const listHotUpdaterRoutes = (
68
+ handlers: HotUpdaterHandlers,
69
+ ): readonly HotUpdaterRoute[] =>
70
+ (handlers as { readonly [routesOf]?: readonly HotUpdaterRoute[] })[
71
+ routesOf
72
+ ] ?? [];
73
+
74
+ const withVary = (response: Response, varyHeaders: readonly string[]) => {
75
+ const cacheControl = response.headers.get("cache-control") ?? "";
76
+ if (
77
+ varyHeaders.length === 0 ||
78
+ cacheControl === "" ||
79
+ /private|no-store/u.test(cacheControl)
80
+ ) {
81
+ return response;
82
+ }
83
+ const headers = new Headers(response.headers);
84
+ headers.set(
85
+ "vary",
86
+ [response.headers.get("vary"), ...varyHeaders].filter(Boolean).join(", "),
87
+ );
88
+ return new Response(response.body, {
89
+ headers,
90
+ status: response.status,
91
+ statusText: response.statusText,
92
+ });
93
+ };
50
94
 
51
95
  const createRequestHandler =
52
96
  ({
53
97
  api,
54
- apiKeyAuth,
98
+ clientPolicy,
55
99
  privateResponses = false,
56
100
  routeHandlers,
57
101
  router,
58
102
  }: {
59
103
  readonly api: HandlerAPI;
60
- readonly apiKeyAuth?: {
61
- readonly authenticate: (request: Request) => Promise<boolean>;
62
- };
104
+ readonly clientPolicy?: ClientRoutePolicy;
63
105
  readonly privateResponses?: boolean;
64
106
  readonly routeHandlers: Record<string, RouteHandler>;
65
107
  readonly router: ReturnType<typeof createRouter<string>>;
@@ -75,10 +117,12 @@ const createRequestHandler =
75
117
  return errorResponse("Not found", 404);
76
118
  }
77
119
 
78
- if (apiKeyAuth !== undefined && requiresApiKey(match.data)) {
120
+ const guarded =
121
+ clientPolicy !== undefined && !PUBLIC_CLIENT_ROUTES.has(match.data);
122
+ if (guarded) {
79
123
  let authenticated: boolean;
80
124
  try {
81
- authenticated = await apiKeyAuth.authenticate(request);
125
+ authenticated = await clientPolicy.authenticate(request);
82
126
  } catch {
83
127
  return errorResponse("Service unavailable", 503);
84
128
  }
@@ -92,11 +136,16 @@ const createRequestHandler =
92
136
  return errorResponse("Handler not found", 500);
93
137
  }
94
138
  const response = await handler(match.params, request, api);
95
- return privateResponses ? withPrivateNoStore(response) : response;
139
+ if (privateResponses) return withPrivateNoStore(response);
140
+ return guarded ? withVary(response, clientPolicy.varyHeaders) : response;
96
141
  } catch (error) {
97
142
  if (error instanceof HandlerBadRequestError) {
98
143
  return errorResponse(error.message, 400);
99
144
  }
145
+ if (error instanceof HotUpdaterSchemaMigrationRequiredError) {
146
+ console.error(error.message);
147
+ return errorResponse("Service unavailable", 503);
148
+ }
100
149
  console.error("Hot Updater handler error:", error);
101
150
  return Response.json(
102
151
  { error: "Internal server error" },
@@ -136,28 +185,38 @@ const createDownloadStorageRouteHandler =
136
185
  });
137
186
  };
138
187
 
139
- export function createHandlers(api: HandlerAPI): HotUpdaterHandlers {
140
- return createHotUpdaterHandlers(api);
141
- }
142
-
143
- export function createHotUpdaterHandlers(
144
- api: HandlerAPI,
145
- insights?: InsightsProvider,
146
- apiKeyAuth?: {
147
- readonly authenticate: (request: Request) => Promise<boolean>;
148
- readonly headerName: string;
149
- },
150
- downloadStorageObject?: (
188
+ export interface HotUpdaterHandlersOptions {
189
+ readonly api: HandlerAPI;
190
+ /** Absent when `clientAccess` is `"public"`. */
191
+ readonly clientPolicy?: ClientRoutePolicy;
192
+ readonly downloadStorageObject?: (
151
193
  token: string,
152
194
  signature: string,
153
- ) => Promise<Response | null>,
154
- ): HotUpdaterHandlers {
195
+ ) => Promise<Response | null>;
196
+ /**
197
+ * The plugins' endpoints; an Insights route none serves answers that
198
+ * Insights is off, and `POST /events` also warns on the first event it drops.
199
+ */
200
+ readonly endpoints?: readonly MountedEndpoint[];
201
+ /** The ids of the plugins the server runs, which the admin `/version` lists. */
202
+ readonly plugins?: readonly string[];
203
+ }
204
+
205
+ export function createHotUpdaterHandlers({
206
+ api,
207
+ clientPolicy,
208
+ downloadStorageObject,
209
+ endpoints = [],
210
+ plugins = [],
211
+ }: HotUpdaterHandlersOptions): HotUpdaterHandlers {
155
212
  const routeHandlers: Record<string, RouteHandler> = {
156
- ...createVersionRouteHandlers(),
157
- ...createReleaseCatalogRouteHandlers(apiKeyAuth?.headerName),
158
- ...createReleaseManagementRouteHandlers(),
159
- ...createBundleRouteHandlers(),
160
- ...(insights === undefined ? {} : createInsightsRouteHandlers(insights)),
213
+ ...createVersionRouteHandlers(plugins),
214
+ ...createReleaseCatalogRouteHandlers(),
215
+ ...createAdminRouteHandlers(),
216
+ ...Object.fromEntries(
217
+ INSIGHTS_ROUTES.map(({ handler }) => [handler, insightsDisabled]),
218
+ ),
219
+ appendBundleEvent: createDroppedEventHandler(),
161
220
  ...(downloadStorageObject === undefined
162
221
  ? {}
163
222
  : {
@@ -167,12 +226,49 @@ export function createHotUpdaterHandlers(
167
226
  }),
168
227
  };
169
228
 
229
+ const routes: HotUpdaterRoute[] = [];
230
+ const shapes = new Map<string, string>();
231
+ const mount =
232
+ (router: ReturnType<typeof createRouter<string>>, admin: boolean) =>
233
+ (method: string, path: string, handler: string): void => {
234
+ const shape = `${admin ? "admin" : "client"} ${method} ${path.replaceAll(/:[^/]+/gu, ":")}`;
235
+ const taken = shapes.get(shape);
236
+ if (taken !== undefined) {
237
+ throw new HotUpdaterConfigError(
238
+ `${handler} (${method} ${path}) collides with ${taken} on handlers.${admin ? "admin" : "client"}.`,
239
+ );
240
+ }
241
+ shapes.set(shape, handler);
242
+ addRoute(router, method, path, handler);
243
+ routes.push({
244
+ method,
245
+ path,
246
+ access: admin
247
+ ? "admin"
248
+ : PUBLIC_CLIENT_ROUTES.has(handler)
249
+ ? "public"
250
+ : "client",
251
+ });
252
+ };
253
+ /** The Insights routes no plugin endpoint serves, which answer that Insights is off. */
254
+ const mountInsights = (
255
+ access: "client" | "admin",
256
+ add: (method: string, path: string, handler: string) => void,
257
+ ) => {
258
+ for (const route of INSIGHTS_ROUTES) {
259
+ const served = endpoints.some(
260
+ (endpoint) =>
261
+ endpoint.access === route.access &&
262
+ endpoint.method === route.method &&
263
+ endpoint.path === route.path,
264
+ );
265
+ if (route.access === access && !served) {
266
+ add(route.method, route.path, route.handler);
267
+ }
268
+ }
269
+ };
170
270
  const clientRouter = createRouter<string>();
171
- const addClientRoute = (
172
- method: string,
173
- path: string,
174
- handler: string,
175
- ): void => addRoute(clientRouter, method, path, handler);
271
+ const addClientRoute = mount(clientRouter, false);
176
272
  addClientRoute("GET", "/version", "version");
177
273
  if (downloadStorageObject !== undefined) {
178
274
  addClientRoute(
@@ -193,45 +289,35 @@ export function createHotUpdaterHandlers(
193
289
  );
194
290
  addClientRoute(
195
291
  "GET",
196
- "/artifacts/:targetBundleId/from/:currentBundleId",
197
- "artifact",
292
+ "/artifacts/v1/:targetBundleId/from/:currentBundleId",
293
+ "artifactV1",
198
294
  );
199
- if (insights !== undefined) {
200
- registerInsightsClientRoutes(addClientRoute);
201
- }
295
+ mountInsights("client", addClientRoute);
202
296
 
203
297
  const adminRouter = createRouter<string>();
204
- const addAdminRoute = (method: string, path: string, handler: string): void =>
205
- addRoute(adminRouter, method, path, handler);
206
- addAdminRoute("GET", "/releases/:id", "getRelease");
207
- addAdminRoute("GET", "/releases", "getReleases");
208
- addAdminRoute("PATCH", "/releases/:id", "updateRelease");
209
- addAdminRoute("POST", "/releases/:id/preflight", "preflightRelease");
210
- addAdminRoute("DELETE", "/releases/:id", "deleteRelease");
211
- addAdminRoute("GET", "/release-catalogs/:scopeKey", "getReleaseCatalogRow");
212
- addAdminRoute("GET", "/release-catalogs", "getReleaseCatalogs");
213
- addAdminRoute(
214
- "POST",
215
- "/release-catalogs/:scopeKey/rebuild",
216
- "rebuildReleaseCatalog",
217
- );
218
- addAdminRoute("POST", "/database/commit", "commitDatabase");
219
- addAdminRoute("GET", "/channels", "getChannels");
220
- addAdminRoute("POST", "/channels", "createChannel");
221
- addAdminRoute("DELETE", "/channels/:id", "deleteChannel");
222
- addAdminRoute("GET", "/bundles/:id", "getBundle");
223
- addAdminRoute("GET", "/bundles", "getBundles");
224
- addAdminRoute("POST", "/bundles", "createBundles");
225
- addAdminRoute("PATCH", "/bundles/:id", "updateBundle");
226
- addAdminRoute("DELETE", "/bundles/:id", "deleteBundle");
227
- if (insights !== undefined) {
228
- registerInsightsAdminRoutes(addAdminRoute);
298
+ const addAdminRoute = mount(adminRouter, true);
299
+ // The admin mount also reports the protocol, so a standalone client checks
300
+ // it where it calls, and the plugins, so a console shows only their features.
301
+ addAdminRoute("GET", "/version", "adminVersion");
302
+ for (const route of ADMIN_ROUTES) {
303
+ addAdminRoute(route.method, route.path, route.handler);
304
+ }
305
+ mountInsights("admin", addAdminRoute);
306
+ for (const endpoint of endpoints) {
307
+ const name = `plugin ${endpoint.plugin}: ${endpoint.method} ${endpoint.path}`;
308
+ routeHandlers[name] = (params, request) =>
309
+ endpoint.handler(request, params);
310
+ (endpoint.access === "admin" ? addAdminRoute : addClientRoute)(
311
+ endpoint.method,
312
+ endpoint.path,
313
+ name,
314
+ );
229
315
  }
230
316
 
231
- return Object.freeze({
317
+ const handlers = {
232
318
  client: createRequestHandler({
233
319
  api,
234
- apiKeyAuth,
320
+ ...(clientPolicy === undefined ? {} : { clientPolicy }),
235
321
  routeHandlers,
236
322
  router: clientRouter,
237
323
  }),
@@ -241,5 +327,7 @@ export function createHotUpdaterHandlers(
241
327
  routeHandlers,
242
328
  router: adminRouter,
243
329
  }),
244
- });
330
+ };
331
+ Object.defineProperty(handlers, routesOf, { value: Object.freeze(routes) });
332
+ return Object.freeze(handlers);
245
333
  }