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

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (542) hide show
  1. package/dist/_virtual/_rolldown/runtime.cjs +1 -1
  2. package/dist/adapters/drizzle.cjs +35 -69
  3. package/dist/adapters/drizzle.d.cts +13 -6
  4. package/dist/adapters/drizzle.d.mts +13 -6
  5. package/dist/adapters/drizzle.mjs +34 -69
  6. package/dist/adapters/drizzleExecutor.cjs +114 -0
  7. package/dist/adapters/drizzleExecutor.d.cts +9 -0
  8. package/dist/adapters/drizzleExecutor.d.mts +9 -0
  9. package/dist/adapters/drizzleExecutor.mjs +112 -0
  10. package/dist/adapters/kysely.cjs +25 -31
  11. package/dist/adapters/kysely.d.cts +10 -7
  12. package/dist/adapters/kysely.d.mts +10 -7
  13. package/dist/adapters/kysely.mjs +25 -31
  14. package/dist/adapters/kyselyExecutor.cjs +32 -0
  15. package/dist/adapters/kyselyExecutor.d.cts +12 -0
  16. package/dist/adapters/kyselyExecutor.d.mts +12 -0
  17. package/dist/adapters/kyselyExecutor.mjs +32 -0
  18. package/dist/adapters/mongodb.cjs +28 -27
  19. package/dist/adapters/mongodb.d.cts +10 -5
  20. package/dist/adapters/mongodb.d.mts +10 -5
  21. package/dist/adapters/mongodb.mjs +28 -27
  22. package/dist/adapters/mongodbAdapter.cjs +174 -0
  23. package/dist/adapters/mongodbAdapter.d.cts +9 -0
  24. package/dist/adapters/mongodbAdapter.d.mts +9 -0
  25. package/dist/adapters/mongodbAdapter.mjs +173 -0
  26. package/dist/adapters/prisma.cjs +38 -220
  27. package/dist/adapters/prisma.d.cts +12 -8
  28. package/dist/adapters/prisma.d.mts +12 -8
  29. package/dist/adapters/prisma.mjs +38 -219
  30. package/dist/adapters/prismaExecutor.cjs +64 -0
  31. package/dist/adapters/prismaExecutor.mjs +64 -0
  32. package/dist/adapters/sqlProviders.cjs +9 -0
  33. package/dist/adapters/sqlProviders.mjs +9 -0
  34. package/dist/apiKeys.cjs +8 -8
  35. package/dist/apiKeys.d.cts +1 -24
  36. package/dist/apiKeys.d.mts +1 -24
  37. package/dist/apiKeys.mjs +5 -9
  38. package/dist/assembly/assemblePlugins.cjs +147 -0
  39. package/dist/assembly/assemblePlugins.d.cts +12 -0
  40. package/dist/assembly/assemblePlugins.d.mts +12 -0
  41. package/dist/assembly/assemblePlugins.mjs +146 -0
  42. package/dist/assembly/databasePlugins.cjs +23 -0
  43. package/dist/assembly/databasePlugins.d.cts +43 -0
  44. package/dist/assembly/databasePlugins.d.mts +43 -0
  45. package/dist/assembly/databasePlugins.mjs +22 -0
  46. package/dist/core/api.cjs +91 -0
  47. package/dist/core/api.d.cts +65 -0
  48. package/dist/core/api.d.mts +65 -0
  49. package/dist/core/api.mjs +87 -0
  50. package/dist/core/baseCandidates.cjs +71 -0
  51. package/dist/core/baseCandidates.d.cts +17 -0
  52. package/dist/core/baseCandidates.d.mts +17 -0
  53. package/dist/core/baseCandidates.mjs +69 -0
  54. package/dist/core/operations.cjs +350 -0
  55. package/dist/core/operations.mjs +350 -0
  56. package/dist/core/reads.cjs +273 -0
  57. package/dist/core/reads.d.cts +48 -0
  58. package/dist/core/reads.d.mts +48 -0
  59. package/dist/core/reads.mjs +267 -0
  60. package/dist/core/releases.cjs +193 -0
  61. package/dist/core/releases.mjs +190 -0
  62. package/dist/core/schema.cjs +279 -0
  63. package/dist/core/schema.d.cts +307 -0
  64. package/dist/core/schema.d.mts +307 -0
  65. package/dist/core/schema.mjs +277 -0
  66. package/dist/core/writes.cjs +96 -0
  67. package/dist/core/writes.mjs +91 -0
  68. package/dist/createHotUpdaterCore.cjs +61 -63
  69. package/dist/createHotUpdaterCore.d.cts +53 -45
  70. package/dist/createHotUpdaterCore.d.mts +53 -45
  71. package/dist/createHotUpdaterCore.mjs +61 -63
  72. package/dist/database/cursor.cjs +44 -0
  73. package/dist/database/cursor.d.cts +7 -0
  74. package/dist/database/cursor.d.mts +7 -0
  75. package/dist/database/cursor.mjs +40 -0
  76. package/dist/database/database.cjs +44 -0
  77. package/dist/database/database.d.cts +123 -0
  78. package/dist/database/database.d.mts +123 -0
  79. package/dist/database/database.mjs +44 -0
  80. package/dist/database/definitions.d.cts +68 -0
  81. package/dist/database/definitions.d.mts +68 -0
  82. package/dist/database/engine.cjs +37 -0
  83. package/dist/database/engine.d.cts +40 -0
  84. package/dist/database/engine.d.mts +40 -0
  85. package/dist/database/engine.mjs +37 -0
  86. package/dist/database/engineAggregates.cjs +115 -0
  87. package/dist/database/engineAggregates.mjs +112 -0
  88. package/dist/database/engineReads.cjs +180 -0
  89. package/dist/database/engineReads.d.cts +35 -0
  90. package/dist/database/engineReads.d.mts +35 -0
  91. package/dist/database/engineReads.mjs +179 -0
  92. package/dist/database/engineTransaction.cjs +403 -0
  93. package/dist/database/engineTransaction.d.cts +26 -0
  94. package/dist/database/engineTransaction.d.mts +26 -0
  95. package/dist/database/engineTransaction.mjs +402 -0
  96. package/dist/database/errors.cjs +27 -0
  97. package/dist/database/errors.d.cts +21 -0
  98. package/dist/database/errors.d.mts +21 -0
  99. package/dist/database/errors.mjs +24 -0
  100. package/dist/database/fence.cjs +124 -0
  101. package/dist/database/fence.d.cts +42 -0
  102. package/dist/database/fence.d.mts +42 -0
  103. package/dist/database/fence.mjs +116 -0
  104. package/dist/database/index.cjs +127 -0
  105. package/dist/database/index.d.cts +17 -0
  106. package/dist/database/index.d.mts +17 -0
  107. package/dist/database/index.mjs +15 -0
  108. package/dist/database/kv/kvAdapter.cjs +273 -0
  109. package/dist/database/kv/kvAdapter.d.cts +101 -0
  110. package/dist/database/kv/kvAdapter.d.mts +101 -0
  111. package/dist/database/kv/kvAdapter.mjs +272 -0
  112. package/dist/database/resolveSchema.cjs +196 -0
  113. package/dist/database/resolveSchema.d.cts +42 -0
  114. package/dist/database/resolveSchema.d.mts +42 -0
  115. package/dist/database/resolveSchema.mjs +193 -0
  116. package/dist/database/schema.cjs +21 -0
  117. package/dist/database/schema.d.cts +61 -0
  118. package/dist/database/schema.d.mts +61 -0
  119. package/dist/database/schema.mjs +20 -0
  120. package/dist/database/sql/sqlAdapter.cjs +282 -0
  121. package/dist/database/sql/sqlAdapter.d.cts +46 -0
  122. package/dist/database/sql/sqlAdapter.d.mts +46 -0
  123. package/dist/database/sql/sqlAdapter.mjs +279 -0
  124. package/dist/database/sql/sqlSchema.cjs +115 -0
  125. package/dist/database/sql/sqlSchema.d.cts +8 -0
  126. package/dist/database/sql/sqlSchema.d.mts +8 -0
  127. package/dist/database/sql/sqlSchema.mjs +111 -0
  128. package/dist/db/builtInDatabase.cjs +104 -0
  129. package/dist/db/builtInDatabase.d.cts +38 -0
  130. package/dist/db/builtInDatabase.d.mts +38 -0
  131. package/dist/db/builtInDatabase.mjs +97 -0
  132. package/dist/db/createBundleDiff.cjs +6 -6
  133. package/dist/db/createBundleDiff.d.cts +4 -7
  134. package/dist/db/createBundleDiff.d.mts +4 -7
  135. package/dist/db/createBundleDiff.mjs +5 -5
  136. package/dist/db/engineDrizzleSchema.cjs +54 -0
  137. package/dist/db/engineDrizzleSchema.mjs +54 -0
  138. package/dist/db/engineMigrator.cjs +53 -0
  139. package/dist/db/engineMigrator.mjs +53 -0
  140. package/dist/db/enginePrismaSchema.cjs +85 -0
  141. package/dist/db/enginePrismaSchema.d.cts +5 -0
  142. package/dist/db/enginePrismaSchema.d.mts +5 -0
  143. package/dist/db/enginePrismaSchema.mjs +84 -0
  144. package/dist/db/engineSql.cjs +26 -0
  145. package/dist/db/engineSql.d.cts +17 -0
  146. package/dist/db/engineSql.d.mts +17 -0
  147. package/dist/db/engineSql.mjs +25 -0
  148. package/dist/db/engineSqlMigrator.cjs +66 -0
  149. package/dist/db/engineSqlMigrator.mjs +66 -0
  150. package/dist/db/fixedMigratorShared.cjs +0 -11
  151. package/dist/db/fixedMigratorShared.mjs +1 -8
  152. package/dist/db/index.cjs +23 -8
  153. package/dist/db/index.d.cts +10 -4
  154. package/dist/db/index.d.mts +10 -4
  155. package/dist/db/index.mjs +16 -8
  156. package/dist/db/releaseCatalog.cjs +20 -44
  157. package/dist/db/releaseCatalog.d.cts +2 -3
  158. package/dist/db/releaseCatalog.d.mts +2 -3
  159. package/dist/db/releaseCatalog.mjs +20 -44
  160. package/dist/db/schemaSettings.cjs +63 -0
  161. package/dist/db/schemaSettings.d.cts +12 -0
  162. package/dist/db/schemaSettings.d.mts +12 -0
  163. package/dist/db/schemaSettings.mjs +62 -0
  164. package/dist/db/settingsMigrator.cjs +92 -0
  165. package/dist/db/settingsMigrator.mjs +89 -0
  166. package/dist/db/types.cjs +3 -12
  167. package/dist/db/types.d.cts +26 -69
  168. package/dist/db/types.d.mts +26 -69
  169. package/dist/db/types.mjs +2 -11
  170. package/dist/db/updateArtifacts.cjs +38 -68
  171. package/dist/db/updateArtifacts.mjs +40 -69
  172. package/dist/handler.cjs +72 -43
  173. package/dist/handler.d.cts +3 -6
  174. package/dist/handler.d.mts +3 -6
  175. package/dist/handler.mjs +73 -43
  176. package/dist/handlerAdminRoutes.cjs +375 -0
  177. package/dist/handlerAdminRoutes.mjs +373 -0
  178. package/dist/handlerParameters.cjs +6 -11
  179. package/dist/handlerParameters.mjs +6 -10
  180. package/dist/handlerReleaseCatalogRoutes.cjs +11 -14
  181. package/dist/handlerReleaseCatalogRoutes.mjs +11 -13
  182. package/dist/handlerTypes.d.cts +2 -56
  183. package/dist/handlerTypes.d.mts +2 -56
  184. package/dist/handlerVersionRoutes.cjs +20 -4
  185. package/dist/handlerVersionRoutes.d.cts +1 -0
  186. package/dist/handlerVersionRoutes.d.mts +1 -0
  187. package/dist/handlerVersionRoutes.mjs +20 -4
  188. package/dist/index.cjs +4 -7
  189. package/dist/index.d.cts +10 -9
  190. package/dist/index.d.mts +10 -9
  191. package/dist/index.mjs +4 -4
  192. package/dist/insights/domain.d.cts +53 -70
  193. package/dist/insights/domain.d.mts +53 -70
  194. package/dist/insights/errors.cjs +35 -8
  195. package/dist/insights/errors.mjs +35 -8
  196. package/dist/insights/eventInput.cjs +64 -24
  197. package/dist/insights/eventInput.mjs +63 -25
  198. package/dist/insights/provider.cjs +356 -0
  199. package/dist/insights/provider.d.cts +6 -0
  200. package/dist/insights/provider.d.mts +6 -0
  201. package/dist/insights/provider.mjs +355 -0
  202. package/dist/insights/queryInput.cjs +78 -43
  203. package/dist/insights/queryInput.mjs +76 -40
  204. package/dist/insights/routes.cjs +94 -34
  205. package/dist/insights/routes.mjs +93 -35
  206. package/dist/insights/types.d.cts +27 -12
  207. package/dist/insights/types.d.mts +27 -12
  208. package/dist/node.d.cts +1 -2
  209. package/dist/node.d.mts +1 -2
  210. package/dist/package.cjs +1 -1
  211. package/dist/package.mjs +1 -1
  212. package/dist/plugins/api-keys/index.cjs +50 -0
  213. package/dist/plugins/api-keys/index.d.cts +85 -0
  214. package/dist/plugins/api-keys/index.d.mts +85 -0
  215. package/dist/plugins/api-keys/index.mjs +47 -0
  216. package/dist/plugins/api-keys/model.cjs +58 -0
  217. package/dist/plugins/api-keys/model.d.cts +8 -0
  218. package/dist/plugins/api-keys/model.d.mts +8 -0
  219. package/dist/plugins/api-keys/model.mjs +58 -0
  220. package/dist/plugins/api-keys/schema.cjs +38 -0
  221. package/dist/plugins/api-keys/schema.d.cts +44 -0
  222. package/dist/plugins/api-keys/schema.d.mts +44 -0
  223. package/dist/plugins/api-keys/schema.mjs +39 -0
  224. package/dist/plugins/builtIn.cjs +7 -0
  225. package/dist/plugins/builtIn.mjs +6 -0
  226. package/dist/plugins/definePlugin.cjs +5 -0
  227. package/dist/plugins/definePlugin.d.cts +73 -0
  228. package/dist/plugins/definePlugin.d.mts +73 -0
  229. package/dist/plugins/definePlugin.mjs +5 -0
  230. package/dist/plugins/index.cjs +17 -0
  231. package/dist/plugins/index.d.cts +9 -0
  232. package/dist/plugins/index.d.mts +9 -0
  233. package/dist/plugins/index.mjs +7 -0
  234. package/dist/plugins/insights/index.cjs +48 -0
  235. package/dist/plugins/insights/index.d.cts +295 -0
  236. package/dist/plugins/insights/index.d.mts +295 -0
  237. package/dist/plugins/insights/index.mjs +44 -0
  238. package/dist/plugins/insights/model.cjs +17 -0
  239. package/dist/plugins/insights/model.d.cts +10 -0
  240. package/dist/plugins/insights/model.d.mts +10 -0
  241. package/dist/plugins/insights/model.mjs +17 -0
  242. package/dist/plugins/insights/reads.cjs +471 -0
  243. package/dist/plugins/insights/reads.mjs +466 -0
  244. package/dist/plugins/insights/recordEvent.cjs +135 -0
  245. package/dist/plugins/insights/recordEvent.d.cts +13 -0
  246. package/dist/plugins/insights/recordEvent.d.mts +13 -0
  247. package/dist/plugins/insights/recordEvent.mjs +132 -0
  248. package/dist/plugins/insights/schema.cjs +347 -0
  249. package/dist/plugins/insights/schema.d.cts +258 -0
  250. package/dist/plugins/insights/schema.d.mts +258 -0
  251. package/dist/plugins/insights/schema.mjs +344 -0
  252. package/dist/storageAccess.cjs +0 -1
  253. package/dist/types/index.d.cts +2 -29
  254. package/dist/types/index.d.mts +2 -29
  255. package/package.json +30 -7
  256. package/src/adapters/drizzle.conformance.integration.spec.ts +34 -0
  257. package/src/adapters/drizzle.readBudgets.integration.spec.ts +41 -0
  258. package/src/adapters/drizzle.spec.ts +277 -208
  259. package/src/adapters/drizzle.ts +48 -128
  260. package/src/adapters/drizzleExecutor.ts +166 -0
  261. package/src/adapters/kysely.conformance.integration.spec.ts +36 -0
  262. package/src/adapters/kysely.readBudgets.integration.spec.ts +42 -0
  263. package/src/adapters/kysely.spec.ts +212 -117
  264. package/src/adapters/kysely.ts +32 -87
  265. package/src/adapters/kyselyExecutor.ts +53 -0
  266. package/src/adapters/mongodb.integration.spec.ts +180 -0
  267. package/src/adapters/mongodb.readBudgets.integration.spec.ts +61 -0
  268. package/src/adapters/mongodb.ts +36 -65
  269. package/src/adapters/mongodbAdapter.ts +293 -0
  270. package/src/adapters/prisma.conformance.integration.spec.ts +36 -0
  271. package/src/adapters/prisma.integration.spec.ts +138 -0
  272. package/src/adapters/prisma.readBudgets.integration.spec.ts +40 -0
  273. package/src/adapters/prisma.spec.ts +226 -173
  274. package/src/adapters/prisma.ts +60 -451
  275. package/src/adapters/prismaExecutor.ts +107 -0
  276. package/src/adapters/prismaTestClients.ts +175 -0
  277. package/src/adapters/sqlProviders.ts +14 -0
  278. package/src/apiKeys.integration.spec.ts +19 -119
  279. package/src/apiKeys.spec.ts +39 -35
  280. package/src/apiKeys.ts +2 -8
  281. package/src/assembly/assemblePlugins.ts +269 -0
  282. package/src/assembly/assembly.spec.ts +325 -0
  283. package/src/assembly/assembly.types.spec.ts +155 -0
  284. package/src/assembly/builtInRoutes.spec.ts +213 -0
  285. package/src/assembly/databasePlugins.spec.ts +71 -0
  286. package/src/assembly/databasePlugins.ts +96 -0
  287. package/src/core/api.ts +139 -0
  288. package/src/core/baseCandidates.spec.ts +378 -0
  289. package/src/core/baseCandidates.ts +136 -0
  290. package/src/core/index.ts +44 -0
  291. package/src/core/operations.spec.ts +415 -0
  292. package/src/core/operations.ts +551 -0
  293. package/src/core/reads.spec.ts +300 -0
  294. package/src/core/reads.ts +417 -0
  295. package/src/core/releases.spec.ts +308 -0
  296. package/src/core/releases.ts +345 -0
  297. package/src/core/schema.ts +173 -0
  298. package/src/core/writes.ts +160 -0
  299. package/src/createHotUpdaterCore.ts +191 -167
  300. package/src/database/cursor.ts +65 -0
  301. package/src/database/database.ts +335 -0
  302. package/src/database/database.types.spec.ts +135 -0
  303. package/src/database/definitions.ts +72 -0
  304. package/src/database/engine.ts +62 -0
  305. package/src/database/engineAggregates.spec.ts +539 -0
  306. package/src/database/engineAggregates.ts +193 -0
  307. package/src/database/engineReads.spec.ts +219 -0
  308. package/src/database/engineReads.ts +302 -0
  309. package/src/database/engineTransaction.spec.ts +710 -0
  310. package/src/database/engineTransaction.ts +588 -0
  311. package/src/database/errors.ts +30 -0
  312. package/src/database/fence.spec.ts +223 -0
  313. package/src/database/fence.ts +171 -0
  314. package/src/database/index.ts +154 -0
  315. package/src/database/kv/kvAdapter.conformance.integration.spec.ts +17 -0
  316. package/src/database/kv/kvAdapter.readBudgets.integration.spec.ts +17 -0
  317. package/src/database/kv/kvAdapter.spec.ts +468 -0
  318. package/src/database/kv/kvAdapter.ts +450 -0
  319. package/src/database/kv/kvTestStore.ts +91 -0
  320. package/src/database/memory.readBudgets.integration.spec.ts +13 -0
  321. package/src/database/resolveSchema.spec.ts +230 -0
  322. package/src/database/resolveSchema.ts +372 -0
  323. package/src/database/schema.ts +169 -0
  324. package/src/database/schema.types.spec.ts +94 -0
  325. package/src/database/sql/docker-compose.yml +36 -0
  326. package/src/database/sql/sqlAdapter.integration.spec.ts +148 -0
  327. package/src/database/sql/sqlAdapter.readBudgets.integration.spec.ts +109 -0
  328. package/src/database/sql/sqlAdapter.spec.ts +255 -0
  329. package/src/database/sql/sqlAdapter.ts +532 -0
  330. package/src/database/sql/sqlSchema.ts +205 -0
  331. package/src/database/sql/sqlTestExecutors.ts +183 -0
  332. package/src/databaseTestSuite.spec.ts +39 -0
  333. package/src/db/builtInDatabase.ts +149 -0
  334. package/src/db/bundleRows.spec.ts +3 -3
  335. package/src/db/createBundleDiff.spec.ts +43 -29
  336. package/src/db/createBundleDiff.ts +13 -7
  337. package/src/db/engineDrizzleSchema.ts +72 -0
  338. package/src/db/engineMigrator.ts +105 -0
  339. package/src/db/enginePrismaSchema.ts +147 -0
  340. package/src/db/engineSql.spec.ts +129 -0
  341. package/src/db/engineSql.ts +48 -0
  342. package/src/db/engineSqlMigrator.ts +116 -0
  343. package/src/db/fixedMigratorShared.ts +1 -20
  344. package/src/db/index.spec.ts +116 -824
  345. package/src/db/index.ts +43 -14
  346. package/src/db/pluginTables.spec.ts +218 -0
  347. package/src/db/releaseCatalog.ts +48 -90
  348. package/src/db/schemaSettings.ts +104 -0
  349. package/src/db/settingsMigrator.spec.ts +65 -0
  350. package/src/db/settingsMigrator.ts +152 -0
  351. package/src/db/types.ts +25 -165
  352. package/src/db/updateArtifacts.spec.ts +170 -294
  353. package/src/db/updateArtifacts.ts +74 -142
  354. package/src/db/updateCheck.bench.ts +47 -0
  355. package/src/handler-standalone.integration.spec.ts +204 -412
  356. package/src/handler.spec.ts +134 -51
  357. package/src/handler.testFixtures.ts +14 -19
  358. package/src/handler.ts +163 -75
  359. package/src/handlerAdminRoutes.spec.ts +183 -0
  360. package/src/handlerAdminRoutes.ts +536 -0
  361. package/src/handlerAuth.integration.spec.ts +3 -3
  362. package/src/handlerManagement.spec.ts +136 -196
  363. package/src/handlerReleaseCatalogRoutes.ts +15 -17
  364. package/src/handlerTypes.ts +3 -80
  365. package/src/handlerVersionRoutes.ts +20 -7
  366. package/src/index.ts +7 -14
  367. package/src/insights/domain.ts +56 -77
  368. package/src/insights/errors.spec.ts +48 -0
  369. package/src/insights/errors.ts +50 -6
  370. package/src/insights/eventInput.ts +80 -27
  371. package/src/insights/insights.integration.spec.ts +525 -44
  372. package/src/insights/provider.spec.ts +574 -0
  373. package/src/insights/provider.ts +667 -0
  374. package/src/insights/queryInput.ts +113 -73
  375. package/src/insights/routes.ts +125 -69
  376. package/src/insights/types.ts +47 -36
  377. package/src/lintRules.spec.ts +76 -0
  378. package/src/plugins/api-keys/apiKeysPlugin.spec.ts +172 -0
  379. package/src/plugins/api-keys/index.ts +66 -0
  380. package/src/plugins/api-keys/model.ts +69 -0
  381. package/src/plugins/api-keys/schema.ts +22 -0
  382. package/src/plugins/builtIn.ts +5 -0
  383. package/src/plugins/definePlugin.ts +100 -0
  384. package/src/plugins/index.ts +55 -0
  385. package/src/plugins/insights/index.ts +86 -0
  386. package/src/plugins/insights/insightsRollout.integration.spec.ts +187 -0
  387. package/src/plugins/insights/model.spec.ts +66 -0
  388. package/src/plugins/insights/model.ts +19 -0
  389. package/src/plugins/insights/reads.spec.ts +725 -0
  390. package/src/plugins/insights/reads.ts +707 -0
  391. package/src/plugins/insights/recordEvent.spec.ts +443 -0
  392. package/src/plugins/insights/recordEvent.ts +238 -0
  393. package/src/plugins/insights/schema.ts +229 -0
  394. package/src/plugins/pluginTestHarness.spec.ts +56 -0
  395. package/src/readBudgets.testFixtures.ts +15 -0
  396. package/src/releaseCatalogRoutes.integration.spec.ts +47 -92
  397. package/src/runtime.spec.ts +91 -77
  398. package/src/runtime.testFixtures.ts +28 -44
  399. package/src/runtimeBundles.integration.spec.ts +112 -0
  400. package/src/testUtilsMutation.integration.spec.ts +215 -0
  401. package/src/testUtilsPackage.integration.spec.ts +176 -0
  402. package/src/types/index.ts +0 -32
  403. package/dist/adapters/databaseConstraintErrors.cjs +0 -23
  404. package/dist/adapters/databaseConstraintErrors.mjs +0 -21
  405. package/dist/adapters/databasePluginUtils.cjs +0 -117
  406. package/dist/adapters/databasePluginUtils.mjs +0 -106
  407. package/dist/adapters/drizzleCrud.cjs +0 -250
  408. package/dist/adapters/drizzleCrud.mjs +0 -249
  409. package/dist/adapters/drizzleLazyDB.cjs +0 -101
  410. package/dist/adapters/drizzleLazyDB.mjs +0 -101
  411. package/dist/adapters/drizzleQuery.cjs +0 -68
  412. package/dist/adapters/drizzleQuery.mjs +0 -67
  413. package/dist/adapters/kyselyCrud.cjs +0 -254
  414. package/dist/adapters/kyselyCrud.mjs +0 -253
  415. package/dist/adapters/kyselyQuery.cjs +0 -56
  416. package/dist/adapters/kyselyQuery.mjs +0 -55
  417. package/dist/adapters/mongodbCollections.cjs +0 -36
  418. package/dist/adapters/mongodbCollections.mjs +0 -30
  419. package/dist/adapters/mongodbQuery.cjs +0 -77
  420. package/dist/adapters/mongodbQuery.mjs +0 -70
  421. package/dist/adapters/mongodbReads.cjs +0 -148
  422. package/dist/adapters/mongodbReads.mjs +0 -147
  423. package/dist/adapters/mongodbWrites.cjs +0 -134
  424. package/dist/adapters/mongodbWrites.mjs +0 -133
  425. package/dist/adapters/prismaQuery.cjs +0 -58
  426. package/dist/adapters/prismaQuery.mjs +0 -56
  427. package/dist/adapters/prismaRows.cjs +0 -198
  428. package/dist/adapters/prismaRows.mjs +0 -188
  429. package/dist/db/databasePluginCore.cjs +0 -138
  430. package/dist/db/databasePluginCore.mjs +0 -137
  431. package/dist/db/fixedMigrator.cjs +0 -79
  432. package/dist/db/fixedMigrator.mjs +0 -78
  433. package/dist/db/fixedMigratorMongo.cjs +0 -319
  434. package/dist/db/fixedMigratorMongo.mjs +0 -319
  435. package/dist/db/mongoMigrationExecution.cjs +0 -11
  436. package/dist/db/mongoMigrationExecution.mjs +0 -11
  437. package/dist/db/schema/mongodb.cjs +0 -25
  438. package/dist/db/schema/mongodb.mjs +0 -25
  439. package/dist/db/schema/registry.cjs +0 -21
  440. package/dist/db/schema/registry.mjs +0 -17
  441. package/dist/db/schema/sql.cjs +0 -101
  442. package/dist/db/schema/sql.mjs +0 -97
  443. package/dist/db/schema/sqlOperations.cjs +0 -27
  444. package/dist/db/schema/sqlOperations.mjs +0 -26
  445. package/dist/db/schemaGenerators.cjs +0 -256
  446. package/dist/db/schemaGenerators.mjs +0 -254
  447. package/dist/db/schemaReadiness.cjs +0 -24
  448. package/dist/db/schemaReadiness.d.cts +0 -8
  449. package/dist/db/schemaReadiness.d.mts +0 -8
  450. package/dist/db/schemaReadiness.mjs +0 -23
  451. package/dist/db/sqlMigrationExecution.cjs +0 -67
  452. package/dist/db/sqlMigrationExecution.mjs +0 -66
  453. package/dist/handlerBundleRoutes.cjs +0 -155
  454. package/dist/handlerBundleRoutes.mjs +0 -155
  455. package/dist/handlerReleaseManagementRoutes.cjs +0 -125
  456. package/dist/handlerReleaseManagementRoutes.mjs +0 -124
  457. package/dist/insights/bounded/activeOverview.cjs +0 -87
  458. package/dist/insights/bounded/activeOverview.mjs +0 -85
  459. package/dist/insights/bounded/installationSearch.cjs +0 -42
  460. package/dist/insights/bounded/installationSearch.mjs +0 -42
  461. package/dist/insights/bounded/persistence.cjs +0 -39
  462. package/dist/insights/bounded/persistence.mjs +0 -38
  463. package/dist/insights/bounded/provider.cjs +0 -170
  464. package/dist/insights/bounded/provider.d.cts +0 -7
  465. package/dist/insights/bounded/provider.d.mts +0 -7
  466. package/dist/insights/bounded/provider.mjs +0 -170
  467. package/dist/insights/bounded/scan.cjs +0 -144
  468. package/dist/insights/bounded/scan.mjs +0 -138
  469. package/dist/insights/persistence.d.cts +0 -6
  470. package/dist/insights/persistence.d.mts +0 -6
  471. package/dist/schema/dsl.cjs +0 -103
  472. package/dist/schema/dsl.mjs +0 -87
  473. package/dist/schema/index.cjs +0 -6
  474. package/dist/schema/index.mjs +0 -7
  475. package/dist/schema/settings.cjs +0 -9
  476. package/dist/schema/settings.mjs +0 -9
  477. package/dist/schema/types.cjs +0 -8
  478. package/dist/schema/types.mjs +0 -6
  479. package/dist/schema/v1_0_0.cjs +0 -364
  480. package/dist/schema/v1_0_0.mjs +0 -357
  481. package/src/adapters/databaseConstraintErrors.ts +0 -25
  482. package/src/adapters/databasePluginTestDatabase.ts +0 -106
  483. package/src/adapters/databasePluginUtils.spec.ts +0 -29
  484. package/src/adapters/databasePluginUtils.ts +0 -214
  485. package/src/adapters/drizzleCrud.ts +0 -419
  486. package/src/adapters/drizzleLazyDB.ts +0 -257
  487. package/src/adapters/drizzleQuery.ts +0 -164
  488. package/src/adapters/kyselyCrud.ts +0 -588
  489. package/src/adapters/kyselyQuery.ts +0 -128
  490. package/src/adapters/mongodb.spec.ts +0 -141
  491. package/src/adapters/mongodbCollections.ts +0 -62
  492. package/src/adapters/mongodbQuery.ts +0 -226
  493. package/src/adapters/mongodbReads.ts +0 -311
  494. package/src/adapters/mongodbRows.spec.ts +0 -64
  495. package/src/adapters/mongodbRows.ts +0 -118
  496. package/src/adapters/mongodbTestClient.ts +0 -342
  497. package/src/adapters/mongodbTestFilter.ts +0 -166
  498. package/src/adapters/mongodbWrites.ts +0 -260
  499. package/src/adapters/prismaQuery.ts +0 -129
  500. package/src/adapters/prismaRows.spec.ts +0 -98
  501. package/src/adapters/prismaRows.ts +0 -301
  502. package/src/adapters/prismaTestClient.ts +0 -396
  503. package/src/calculatePagination.ts +0 -34
  504. package/src/db/databasePluginCore.spec.ts +0 -62
  505. package/src/db/databasePluginCore.testFixtures.ts +0 -76
  506. package/src/db/databasePluginCore.ts +0 -185
  507. package/src/db/databasePluginUpdateCheck.bench.ts +0 -107
  508. package/src/db/fixedMigrator.spec.ts +0 -231
  509. package/src/db/fixedMigrator.ts +0 -147
  510. package/src/db/fixedMigratorMongo.spec.ts +0 -192
  511. package/src/db/fixedMigratorMongo.ts +0 -425
  512. package/src/db/hotUpdaterSchema.ts +0 -5
  513. package/src/db/mongoMigrationExecution.ts +0 -23
  514. package/src/db/schema/definitions.ts +0 -1
  515. package/src/db/schema/mongodb.ts +0 -40
  516. package/src/db/schema/registry.ts +0 -55
  517. package/src/db/schema/sql.ts +0 -241
  518. package/src/db/schema/sqlOperations.ts +0 -63
  519. package/src/db/schema/types.ts +0 -1
  520. package/src/db/schemaGenerators.ts +0 -466
  521. package/src/db/schemaReadiness.ts +0 -34
  522. package/src/db/sqlMigrationExecution.spec.ts +0 -65
  523. package/src/db/sqlMigrationExecution.ts +0 -108
  524. package/src/db/types.spec.ts +0 -55
  525. package/src/handlerBundleRoutes.ts +0 -259
  526. package/src/handlerReleaseManagementRoutes.ts +0 -213
  527. package/src/insights/bounded/activeOverview.spec.ts +0 -189
  528. package/src/insights/bounded/activeOverview.ts +0 -148
  529. package/src/insights/bounded/installationSearch.spec.ts +0 -130
  530. package/src/insights/bounded/installationSearch.ts +0 -69
  531. package/src/insights/bounded/persistence.ts +0 -43
  532. package/src/insights/bounded/provider.spec.ts +0 -219
  533. package/src/insights/bounded/provider.ts +0 -229
  534. package/src/insights/bounded/scan.ts +0 -235
  535. package/src/insights/persistence.ts +0 -10
  536. package/src/schema/dsl-all-versions.spec.ts +0 -35
  537. package/src/schema/dsl.ts +0 -187
  538. package/src/schema/index.ts +0 -10
  539. package/src/schema/settings.ts +0 -15
  540. package/src/schema/types.ts +0 -79
  541. package/src/schema/v1_0_0.spec.ts +0 -146
  542. package/src/schema/v1_0_0.ts +0 -465
@@ -1,20 +1,8 @@
1
- import { getManifestAssetDownloadPath, isContentAddressedAssetFileHash, resolveManifestAssetStorageUri } from "@hot-updater/plugin-core";
2
- import { getAssetBaseStorageUri, getBundlePatch, getManifestFileHash, getManifestStorageUri } from "@hot-updater/core";
1
+ import { getBundleArchiveStorageUri, getManifestAssetDownloadPath, isContentAddressedAssetFileHash, resolveManifestAssetStorageUri } from "@hot-updater/plugin-core";
2
+ import { ARTIFACT_PROTOCOL_VERSION, getAssetBaseStorageUri, getBundlePatch, getManifestFileHash, getManifestStorageUri } from "@hot-updater/core";
3
3
  //#region src/db/updateArtifacts.ts
4
4
  const HBC_ASSET_PATH_RE = /\.bundle$/;
5
5
  const asByteSize = (value) => typeof value === "number" && Number.isSafeInteger(value) && value >= 0 ? value : null;
6
- const sumByteSizes = (byteSizes) => {
7
- let total = 0;
8
- for (const byteSize of byteSizes) {
9
- if (byteSize === null || total > Number.MAX_SAFE_INTEGER - byteSize) return null;
10
- total += byteSize;
11
- }
12
- return total;
13
- };
14
- const shouldUseArchive = (targetBundle, downloadByteSize) => {
15
- const archiveByteSize = asByteSize(targetBundle.archiveByteSize);
16
- return archiveByteSize !== null && downloadByteSize !== null && downloadByteSize >= archiveByteSize;
17
- };
18
6
  const resolveUniqueHbcAssetPath = (manifest) => {
19
7
  const candidates = Object.keys(manifest.assets).sort((left, right) => left.localeCompare(right)).filter((candidate) => HBC_ASSET_PATH_RE.test(candidate));
20
8
  return candidates.length === 1 ? candidates[0] : null;
@@ -40,10 +28,7 @@ async function fetchBundleManifest(storageUri, readStorageText) {
40
28
  return null;
41
29
  }
42
30
  if (!isBundleManifest(payload)) return null;
43
- return {
44
- byteSize: asByteSize(new TextEncoder().encode(storageText).byteLength),
45
- manifest: payload
46
- };
31
+ return payload;
47
32
  }
48
33
  function resolveHbcPatchPlan({ currentBundle, targetBundle, targetManifest }) {
49
34
  const matchingPatch = currentBundle ? getBundlePatch(targetBundle, currentBundle.id) : null;
@@ -60,14 +45,13 @@ function resolveHbcPatchPlan({ currentBundle, targetBundle, targetManifest }) {
60
45
  }
61
46
  };
62
47
  }
63
- function createManifestArtifactPlan({ assetBaseStorageUri, currentManifest, currentBundle, targetBundle, targetManifest, targetManifestByteSize }) {
48
+ function createManifestArtifactPlan({ assetBaseStorageUri, currentBundle, targetBundle, targetManifest }) {
64
49
  const patchCandidate = resolveHbcPatchPlan({
65
50
  currentBundle,
66
51
  targetBundle,
67
52
  targetManifest
68
53
  });
69
- const changedAssets = Object.entries(targetManifest.assets).flatMap(([assetPath, asset]) => {
70
- if ((currentManifest?.assets[assetPath])?.fileHash === asset.fileHash) return [];
54
+ return { assets: Object.entries(targetManifest.assets).map(([assetPath, asset]) => {
71
55
  const downloadByteSize = asByteSize(asset.downloadByteSize);
72
56
  const downloadPath = getManifestAssetDownloadPath(assetPath);
73
57
  const isTransformedDownload = downloadPath !== assetPath;
@@ -83,28 +67,16 @@ function createManifestArtifactPlan({ assetBaseStorageUri, currentManifest, curr
83
67
  };
84
68
  if (isTransformedDownload) file.compression = "br";
85
69
  const patch = patchCandidate?.assetPath === assetPath ? patchCandidate.patch : null;
86
- return [{
70
+ return {
87
71
  assetPath,
88
72
  file,
89
73
  fileHash: asset.fileHash,
90
74
  patch
91
- }];
92
- });
93
- const allPossibleByteSizesKnown = targetManifestByteSize !== null && changedAssets.every((asset) => asset.file.byteSize !== null && (asset.patch === null || asset.patch.byteSize !== null));
94
- const primaryByteSizes = changedAssets.map((asset) => {
95
- if (!asset.patch) return asset.file.byteSize;
96
- if (asset.patch.byteSize === null || asset.file.byteSize === null) return null;
97
- return Math.min(asset.patch.byteSize, asset.file.byteSize);
98
- });
99
- return {
100
- allPossibleByteSizesKnown,
101
- changedAssets,
102
- manifestByteSize: targetManifestByteSize,
103
- minimumDownloadByteSize: allPossibleByteSizesKnown ? sumByteSizes([targetManifestByteSize, ...primaryByteSizes]) : null
104
- };
75
+ };
76
+ }) };
105
77
  }
106
- async function resolveChangedAssets(plan, resolveFileUrl) {
107
- const patchAsset = plan.changedAssets.find((asset) => asset.patch !== null);
78
+ async function resolveAssets(plan, resolveFileUrl) {
79
+ const patchAsset = plan.assets.find((asset) => asset.patch !== null);
108
80
  let resolvedPatch = null;
109
81
  if (patchAsset?.patch) {
110
82
  const patchUrl = await resolveFileUrl(patchAsset.patch.storageUri);
@@ -115,11 +87,12 @@ async function resolveChangedAssets(plan, resolveFileUrl) {
115
87
  baseBundleId: patchAsset.patch.baseBundleId,
116
88
  baseFileHash: patchAsset.patch.baseFileHash,
117
89
  patchFileHash: patchAsset.patch.patchFileHash,
118
- patchUrl
90
+ patchUrl,
91
+ ...patchAsset.patch.byteSize === null ? {} : { byteSize: patchAsset.patch.byteSize }
119
92
  }
120
93
  };
121
94
  }
122
- const changedEntries = await Promise.all(plan.changedAssets.map(async (asset) => {
95
+ const entries = await Promise.all(plan.assets.map(async (asset) => {
123
96
  let patch = resolvedPatch?.assetPath === asset.assetPath ? resolvedPatch.patch : null;
124
97
  let fileUrl = null;
125
98
  try {
@@ -128,52 +101,50 @@ async function resolveChangedAssets(plan, resolveFileUrl) {
128
101
  if (!patch) throw error;
129
102
  }
130
103
  if (fileUrl && patch && asset.file.byteSize !== null && asset.patch !== null && asset.patch.byteSize !== null && asset.patch.byteSize >= asset.file.byteSize) patch = null;
131
- if (!fileUrl && !patch) return null;
132
- const changedAsset = { fileHash: asset.fileHash };
133
- if (fileUrl) {
134
- changedAsset.file = { url: fileUrl };
135
- if (asset.file.compression) changedAsset.file.compression = asset.file.compression;
136
- }
137
- if (patch) changedAsset.patch = patch;
138
- return {
139
- asset: [asset.assetPath, changedAsset],
140
- primaryByteSize: patch ? asset.patch?.byteSize ?? null : asset.file.byteSize
104
+ if (!fileUrl) return null;
105
+ const changedAsset = {
106
+ file: { url: fileUrl },
107
+ fileHash: asset.fileHash
141
108
  };
109
+ if (asset.file.compression) changedAsset.file.compression = asset.file.compression;
110
+ if (patch) changedAsset.patch = patch;
111
+ return { asset: [asset.assetPath, changedAsset] };
142
112
  }));
143
- if (changedEntries.some((entry) => entry === null)) return null;
144
- const resolvedEntries = changedEntries.filter((entry) => entry !== null);
145
- return {
146
- changedAssets: Object.fromEntries(resolvedEntries.map((entry) => entry.asset)),
147
- primaryByteSizes: resolvedEntries.map((entry) => entry.primaryByteSize)
148
- };
113
+ if (entries.some((entry) => entry === null)) return null;
114
+ const resolvedEntries = entries.filter((entry) => entry !== null);
115
+ return { assets: Object.fromEntries(resolvedEntries.map((entry) => entry.asset)) };
149
116
  }
150
- async function resolveManifestArtifacts({ archiveUrlUsable, currentBundle, resolveFileUrl, readStorageText, targetBundle }) {
117
+ async function resolveManifestArtifacts({ currentBundle, resolveFileUrl, readStorageText, targetBundle }) {
151
118
  const manifestStorageUri = targetBundle ? getManifestStorageUri(targetBundle) : null;
152
119
  const manifestFileHash = targetBundle ? getManifestFileHash(targetBundle) : null;
153
120
  const assetBaseStorageUri = targetBundle ? getAssetBaseStorageUri(targetBundle) : null;
154
121
  if (!targetBundle || !manifestStorageUri || !manifestFileHash || !assetBaseStorageUri) return null;
155
- const currentManifestStorageUri = currentBundle ? getManifestStorageUri(currentBundle) : null;
156
- const [targetManifestResult, currentManifestResult] = await Promise.all([fetchBundleManifest(manifestStorageUri, readStorageText), currentManifestStorageUri ? fetchBundleManifest(currentManifestStorageUri, readStorageText) : null]);
157
- if (!targetManifestResult) return null;
122
+ const targetManifest = await fetchBundleManifest(manifestStorageUri, readStorageText);
123
+ if (!targetManifest) return null;
158
124
  const plan = createManifestArtifactPlan({
159
125
  assetBaseStorageUri,
160
- currentManifest: currentManifestResult?.manifest ?? null,
161
126
  currentBundle,
162
127
  targetBundle,
163
- targetManifest: targetManifestResult.manifest,
164
- targetManifestByteSize: targetManifestResult.byteSize
128
+ targetManifest
165
129
  });
166
- if (archiveUrlUsable && plan.allPossibleByteSizesKnown && shouldUseArchive(targetBundle, plan.minimumDownloadByteSize)) return null;
167
130
  const manifestUrl = await resolveFileUrl(manifestStorageUri);
168
131
  if (!manifestUrl) return null;
169
- const resolved = await resolveChangedAssets(plan, resolveFileUrl);
132
+ const resolved = await resolveAssets(plan, resolveFileUrl);
170
133
  if (!resolved) return null;
171
- const resolvedDownloadByteSize = sumByteSizes([plan.manifestByteSize, ...resolved.primaryByteSizes]);
172
- if (archiveUrlUsable && shouldUseArchive(targetBundle, resolvedDownloadByteSize)) return null;
134
+ let archiveUrl = null;
135
+ const archive = targetManifest.archive;
136
+ if (archive && isContentAddressedAssetFileHash(archive.downloadFileHash) && (asByteSize(archive.downloadByteSize) ?? 0) > 0 && (asByteSize(archive.tarByteSize) ?? 0) > 0) try {
137
+ archiveUrl = await resolveFileUrl(getBundleArchiveStorageUri({
138
+ manifestStorageUri,
139
+ bundleId: targetBundle.id
140
+ }));
141
+ } catch {}
173
142
  return {
174
- changedAssets: resolved.changedAssets,
143
+ artifactProtocolVersion: ARTIFACT_PROTOCOL_VERSION,
144
+ assets: resolved.assets,
175
145
  manifestFileHash,
176
- manifestUrl
146
+ manifestUrl,
147
+ ...archiveUrl ? { archiveUrl } : {}
177
148
  };
178
149
  }
179
150
  //#endregion
package/dist/handler.cjs CHANGED
@@ -1,9 +1,10 @@
1
+ const require_fence = require("./database/fence.cjs");
2
+ const require_routes = require("./insights/routes.cjs");
3
+ const require_assemblePlugins = require("./assembly/assemblePlugins.cjs");
1
4
  const require_handlerErrors = require("./handlerErrors.cjs");
2
- const require_handlerBundleRoutes = require("./handlerBundleRoutes.cjs");
5
+ const require_handlerAdminRoutes = require("./handlerAdminRoutes.cjs");
3
6
  const require_handlerReleaseCatalogRoutes = require("./handlerReleaseCatalogRoutes.cjs");
4
- const require_handlerReleaseManagementRoutes = require("./handlerReleaseManagementRoutes.cjs");
5
7
  const require_handlerVersionRoutes = require("./handlerVersionRoutes.cjs");
6
- const require_routes = require("./insights/routes.cjs");
7
8
  const require_internalRouter = require("./internalRouter.cjs");
8
9
  //#region src/handler.ts
9
10
  const withPrivateNoStore = (response) => {
@@ -19,15 +20,29 @@ const errorResponse = (error, status) => Response.json({ error }, {
19
20
  headers: { "cache-control": "private, no-store" },
20
21
  status
21
22
  });
22
- const requiresApiKey = (handlerName) => handlerName === "appVersionReleaseCatalog" || handlerName === "fingerprintReleaseCatalog" || handlerName === "artifact" || handlerName === "appendBundleEvent";
23
- const createRequestHandler = ({ api, apiKeyAuth, privateResponses = false, routeHandlers, router }) => async (request) => {
23
+ /** `/version` and storage downloads never pass through the client policy. */
24
+ const PUBLIC_CLIENT_ROUTES = /* @__PURE__ */ new Set(["version", "downloadStorageObject"]);
25
+ const routesOf = Symbol.for("@hot-updater/server/routes");
26
+ const withVary = (response, varyHeaders) => {
27
+ const cacheControl = response.headers.get("cache-control") ?? "";
28
+ if (varyHeaders.length === 0 || cacheControl === "" || /private|no-store/u.test(cacheControl)) return response;
29
+ const headers = new Headers(response.headers);
30
+ headers.set("vary", [response.headers.get("vary"), ...varyHeaders].filter(Boolean).join(", "));
31
+ return new Response(response.body, {
32
+ headers,
33
+ status: response.status,
34
+ statusText: response.statusText
35
+ });
36
+ };
37
+ const createRequestHandler = ({ api, clientPolicy, privateResponses = false, routeHandlers, router }) => async (request) => {
24
38
  try {
25
39
  const match = require_internalRouter.findRoute(router, request.method, new URL(request.url).pathname);
26
40
  if (!match) return errorResponse("Not found", 404);
27
- if (apiKeyAuth !== void 0 && requiresApiKey(match.data)) {
41
+ const guarded = clientPolicy !== void 0 && !PUBLIC_CLIENT_ROUTES.has(match.data);
42
+ if (guarded) {
28
43
  let authenticated;
29
44
  try {
30
- authenticated = await apiKeyAuth.authenticate(request);
45
+ authenticated = await clientPolicy.authenticate(request);
31
46
  } catch {
32
47
  return errorResponse("Service unavailable", 503);
33
48
  }
@@ -36,9 +51,14 @@ const createRequestHandler = ({ api, apiKeyAuth, privateResponses = false, route
36
51
  const handler = routeHandlers[match.data];
37
52
  if (!handler) return errorResponse("Handler not found", 500);
38
53
  const response = await handler(match.params, request, api);
39
- return privateResponses ? withPrivateNoStore(response) : response;
54
+ if (privateResponses) return withPrivateNoStore(response);
55
+ return guarded ? withVary(response, clientPolicy.varyHeaders) : response;
40
56
  } catch (error) {
41
57
  if (error instanceof require_handlerErrors.HandlerBadRequestError) return errorResponse(error.message, 400);
58
+ if (error instanceof require_fence.HotUpdaterSchemaMigrationRequiredError) {
59
+ console.error(error.message);
60
+ return errorResponse("Service unavailable", 503);
61
+ }
42
62
  console.error("Hot Updater handler error:", error);
43
63
  return Response.json({ error: "Internal server error" }, {
44
64
  headers: { "cache-control": "private, no-store" },
@@ -60,50 +80,58 @@ const createDownloadStorageRouteHandler = (downloadStorageObject) => async (para
60
80
  statusText: response.statusText
61
81
  });
62
82
  };
63
- function createHandlers(api) {
64
- return createHotUpdaterHandlers(api);
65
- }
66
- function createHotUpdaterHandlers(api, insights, apiKeyAuth, downloadStorageObject) {
83
+ function createHotUpdaterHandlers({ api, clientPolicy, downloadStorageObject, endpoints = [], plugins = [] }) {
67
84
  const routeHandlers = {
68
- ...require_handlerVersionRoutes.createVersionRouteHandlers(),
69
- ...require_handlerReleaseCatalogRoutes.createReleaseCatalogRouteHandlers(apiKeyAuth?.headerName),
70
- ...require_handlerReleaseManagementRoutes.createReleaseManagementRouteHandlers(),
71
- ...require_handlerBundleRoutes.createBundleRouteHandlers(),
72
- ...insights === void 0 ? {} : require_routes.createInsightsRouteHandlers(insights),
85
+ ...require_handlerVersionRoutes.createVersionRouteHandlers(plugins),
86
+ ...require_handlerReleaseCatalogRoutes.createReleaseCatalogRouteHandlers(),
87
+ ...require_handlerAdminRoutes.createAdminRouteHandlers(),
88
+ ...Object.fromEntries(require_routes.INSIGHTS_ROUTES.map(({ handler }) => [handler, require_routes.insightsDisabled])),
89
+ appendBundleEvent: require_routes.createDroppedEventHandler(),
73
90
  ...downloadStorageObject === void 0 ? {} : { downloadStorageObject: createDownloadStorageRouteHandler(downloadStorageObject) }
74
91
  };
92
+ const routes = [];
93
+ const shapes = /* @__PURE__ */ new Map();
94
+ const mount = (router, admin) => (method, path, handler) => {
95
+ const shape = `${admin ? "admin" : "client"} ${method} ${path.replaceAll(/:[^/]+/gu, ":")}`;
96
+ const taken = shapes.get(shape);
97
+ if (taken !== void 0) throw new require_assemblePlugins.HotUpdaterConfigError(`${handler} (${method} ${path}) collides with ${taken} on handlers.${admin ? "admin" : "client"}.`);
98
+ shapes.set(shape, handler);
99
+ require_internalRouter.addRoute(router, method, path, handler);
100
+ routes.push({
101
+ method,
102
+ path,
103
+ access: admin ? "admin" : PUBLIC_CLIENT_ROUTES.has(handler) ? "public" : "client"
104
+ });
105
+ };
106
+ /** The Insights routes no plugin endpoint serves, which answer that Insights is off. */
107
+ const mountInsights = (access, add) => {
108
+ for (const route of require_routes.INSIGHTS_ROUTES) {
109
+ const served = endpoints.some((endpoint) => endpoint.access === route.access && endpoint.method === route.method && endpoint.path === route.path);
110
+ if (route.access === access && !served) add(route.method, route.path, route.handler);
111
+ }
112
+ };
75
113
  const clientRouter = require_internalRouter.createRouter();
76
- const addClientRoute = (method, path, handler) => require_internalRouter.addRoute(clientRouter, method, path, handler);
114
+ const addClientRoute = mount(clientRouter, false);
77
115
  addClientRoute("GET", "/version", "version");
78
116
  if (downloadStorageObject !== void 0) addClientRoute("GET", "/storage/:token/:signature", "downloadStorageObject");
79
117
  addClientRoute("GET", "/release-catalogs/app-version/:platform/:channelKey/:appVersion", "appVersionReleaseCatalog");
80
118
  addClientRoute("GET", "/release-catalogs/fingerprint/:platform/:channelKey/:fingerprintHash", "fingerprintReleaseCatalog");
81
- addClientRoute("GET", "/artifacts/:targetBundleId/from/:currentBundleId", "artifact");
82
- if (insights !== void 0) require_routes.registerInsightsClientRoutes(addClientRoute);
119
+ addClientRoute("GET", "/artifacts/v1/:targetBundleId/from/:currentBundleId", "artifactV1");
120
+ mountInsights("client", addClientRoute);
83
121
  const adminRouter = require_internalRouter.createRouter();
84
- const addAdminRoute = (method, path, handler) => require_internalRouter.addRoute(adminRouter, method, path, handler);
85
- addAdminRoute("GET", "/releases/:id", "getRelease");
86
- addAdminRoute("GET", "/releases", "getReleases");
87
- addAdminRoute("PATCH", "/releases/:id", "updateRelease");
88
- addAdminRoute("POST", "/releases/:id/preflight", "preflightRelease");
89
- addAdminRoute("DELETE", "/releases/:id", "deleteRelease");
90
- addAdminRoute("GET", "/release-catalogs/:scopeKey", "getReleaseCatalogRow");
91
- addAdminRoute("GET", "/release-catalogs", "getReleaseCatalogs");
92
- addAdminRoute("POST", "/release-catalogs/:scopeKey/rebuild", "rebuildReleaseCatalog");
93
- addAdminRoute("POST", "/database/commit", "commitDatabase");
94
- addAdminRoute("GET", "/channels", "getChannels");
95
- addAdminRoute("POST", "/channels", "createChannel");
96
- addAdminRoute("DELETE", "/channels/:id", "deleteChannel");
97
- addAdminRoute("GET", "/bundles/:id", "getBundle");
98
- addAdminRoute("GET", "/bundles", "getBundles");
99
- addAdminRoute("POST", "/bundles", "createBundles");
100
- addAdminRoute("PATCH", "/bundles/:id", "updateBundle");
101
- addAdminRoute("DELETE", "/bundles/:id", "deleteBundle");
102
- if (insights !== void 0) require_routes.registerInsightsAdminRoutes(addAdminRoute);
103
- return Object.freeze({
122
+ const addAdminRoute = mount(adminRouter, true);
123
+ addAdminRoute("GET", "/version", "adminVersion");
124
+ for (const route of require_handlerAdminRoutes.ADMIN_ROUTES) addAdminRoute(route.method, route.path, route.handler);
125
+ mountInsights("admin", addAdminRoute);
126
+ for (const endpoint of endpoints) {
127
+ const name = `plugin ${endpoint.plugin}: ${endpoint.method} ${endpoint.path}`;
128
+ routeHandlers[name] = (params, request) => endpoint.handler(request, params);
129
+ (endpoint.access === "admin" ? addAdminRoute : addClientRoute)(endpoint.method, endpoint.path, name);
130
+ }
131
+ const handlers = {
104
132
  client: createRequestHandler({
105
133
  api,
106
- apiKeyAuth,
134
+ ...clientPolicy === void 0 ? {} : { clientPolicy },
107
135
  routeHandlers,
108
136
  router: clientRouter
109
137
  }),
@@ -113,8 +141,9 @@ function createHotUpdaterHandlers(api, insights, apiKeyAuth, downloadStorageObje
113
141
  routeHandlers,
114
142
  router: adminRouter
115
143
  })
116
- });
144
+ };
145
+ Object.defineProperty(handlers, routesOf, { value: Object.freeze(routes) });
146
+ return Object.freeze(handlers);
117
147
  }
118
148
  //#endregion
119
- exports.createHandlers = createHandlers;
120
149
  exports.createHotUpdaterHandlers = createHotUpdaterHandlers;
@@ -1,6 +1,3 @@
1
- import { HandlerAPI, HotUpdaterHandler, HotUpdaterHandlers } from "./handlerTypes.cjs";
2
-
3
- //#region src/handler.d.ts
4
- declare function createHandlers(api: HandlerAPI): HotUpdaterHandlers;
5
- //#endregion
6
- export { createHandlers };
1
+ import "./assembly/assemblePlugins.cjs";
2
+ import { HotUpdaterHandler, HotUpdaterHandlers } from "./handlerTypes.cjs";
3
+ export type { HotUpdaterHandler, HotUpdaterHandlers };
@@ -1,6 +1,3 @@
1
- import { HandlerAPI, HotUpdaterHandler, HotUpdaterHandlers } from "./handlerTypes.mjs";
2
-
3
- //#region src/handler.d.ts
4
- declare function createHandlers(api: HandlerAPI): HotUpdaterHandlers;
5
- //#endregion
6
- export { createHandlers };
1
+ import "./assembly/assemblePlugins.mjs";
2
+ import { HotUpdaterHandler, HotUpdaterHandlers } from "./handlerTypes.mjs";
3
+ export type { HotUpdaterHandler, HotUpdaterHandlers };
package/dist/handler.mjs CHANGED
@@ -1,9 +1,10 @@
1
+ import { HotUpdaterSchemaMigrationRequiredError } from "./database/fence.mjs";
2
+ import { INSIGHTS_ROUTES, createDroppedEventHandler, insightsDisabled } from "./insights/routes.mjs";
3
+ import { HotUpdaterConfigError } from "./assembly/assemblePlugins.mjs";
1
4
  import { HandlerBadRequestError } from "./handlerErrors.mjs";
2
- import { createBundleRouteHandlers } from "./handlerBundleRoutes.mjs";
5
+ import { ADMIN_ROUTES, createAdminRouteHandlers } from "./handlerAdminRoutes.mjs";
3
6
  import { createReleaseCatalogRouteHandlers } from "./handlerReleaseCatalogRoutes.mjs";
4
- import { createReleaseManagementRouteHandlers } from "./handlerReleaseManagementRoutes.mjs";
5
7
  import { createVersionRouteHandlers } from "./handlerVersionRoutes.mjs";
6
- import { createInsightsRouteHandlers, registerInsightsAdminRoutes, registerInsightsClientRoutes } from "./insights/routes.mjs";
7
8
  import { addRoute, createRouter, findRoute } from "./internalRouter.mjs";
8
9
  //#region src/handler.ts
9
10
  const withPrivateNoStore = (response) => {
@@ -19,15 +20,29 @@ const errorResponse = (error, status) => Response.json({ error }, {
19
20
  headers: { "cache-control": "private, no-store" },
20
21
  status
21
22
  });
22
- const requiresApiKey = (handlerName) => handlerName === "appVersionReleaseCatalog" || handlerName === "fingerprintReleaseCatalog" || handlerName === "artifact" || handlerName === "appendBundleEvent";
23
- const createRequestHandler = ({ api, apiKeyAuth, privateResponses = false, routeHandlers, router }) => async (request) => {
23
+ /** `/version` and storage downloads never pass through the client policy. */
24
+ const PUBLIC_CLIENT_ROUTES = /* @__PURE__ */ new Set(["version", "downloadStorageObject"]);
25
+ const routesOf = Symbol.for("@hot-updater/server/routes");
26
+ const withVary = (response, varyHeaders) => {
27
+ const cacheControl = response.headers.get("cache-control") ?? "";
28
+ if (varyHeaders.length === 0 || cacheControl === "" || /private|no-store/u.test(cacheControl)) return response;
29
+ const headers = new Headers(response.headers);
30
+ headers.set("vary", [response.headers.get("vary"), ...varyHeaders].filter(Boolean).join(", "));
31
+ return new Response(response.body, {
32
+ headers,
33
+ status: response.status,
34
+ statusText: response.statusText
35
+ });
36
+ };
37
+ const createRequestHandler = ({ api, clientPolicy, privateResponses = false, routeHandlers, router }) => async (request) => {
24
38
  try {
25
39
  const match = findRoute(router, request.method, new URL(request.url).pathname);
26
40
  if (!match) return errorResponse("Not found", 404);
27
- if (apiKeyAuth !== void 0 && requiresApiKey(match.data)) {
41
+ const guarded = clientPolicy !== void 0 && !PUBLIC_CLIENT_ROUTES.has(match.data);
42
+ if (guarded) {
28
43
  let authenticated;
29
44
  try {
30
- authenticated = await apiKeyAuth.authenticate(request);
45
+ authenticated = await clientPolicy.authenticate(request);
31
46
  } catch {
32
47
  return errorResponse("Service unavailable", 503);
33
48
  }
@@ -36,9 +51,14 @@ const createRequestHandler = ({ api, apiKeyAuth, privateResponses = false, route
36
51
  const handler = routeHandlers[match.data];
37
52
  if (!handler) return errorResponse("Handler not found", 500);
38
53
  const response = await handler(match.params, request, api);
39
- return privateResponses ? withPrivateNoStore(response) : response;
54
+ if (privateResponses) return withPrivateNoStore(response);
55
+ return guarded ? withVary(response, clientPolicy.varyHeaders) : response;
40
56
  } catch (error) {
41
57
  if (error instanceof HandlerBadRequestError) return errorResponse(error.message, 400);
58
+ if (error instanceof HotUpdaterSchemaMigrationRequiredError) {
59
+ console.error(error.message);
60
+ return errorResponse("Service unavailable", 503);
61
+ }
42
62
  console.error("Hot Updater handler error:", error);
43
63
  return Response.json({ error: "Internal server error" }, {
44
64
  headers: { "cache-control": "private, no-store" },
@@ -60,50 +80,58 @@ const createDownloadStorageRouteHandler = (downloadStorageObject) => async (para
60
80
  statusText: response.statusText
61
81
  });
62
82
  };
63
- function createHandlers(api) {
64
- return createHotUpdaterHandlers(api);
65
- }
66
- function createHotUpdaterHandlers(api, insights, apiKeyAuth, downloadStorageObject) {
83
+ function createHotUpdaterHandlers({ api, clientPolicy, downloadStorageObject, endpoints = [], plugins = [] }) {
67
84
  const routeHandlers = {
68
- ...createVersionRouteHandlers(),
69
- ...createReleaseCatalogRouteHandlers(apiKeyAuth?.headerName),
70
- ...createReleaseManagementRouteHandlers(),
71
- ...createBundleRouteHandlers(),
72
- ...insights === void 0 ? {} : createInsightsRouteHandlers(insights),
85
+ ...createVersionRouteHandlers(plugins),
86
+ ...createReleaseCatalogRouteHandlers(),
87
+ ...createAdminRouteHandlers(),
88
+ ...Object.fromEntries(INSIGHTS_ROUTES.map(({ handler }) => [handler, insightsDisabled])),
89
+ appendBundleEvent: createDroppedEventHandler(),
73
90
  ...downloadStorageObject === void 0 ? {} : { downloadStorageObject: createDownloadStorageRouteHandler(downloadStorageObject) }
74
91
  };
92
+ const routes = [];
93
+ const shapes = /* @__PURE__ */ new Map();
94
+ const mount = (router, admin) => (method, path, handler) => {
95
+ const shape = `${admin ? "admin" : "client"} ${method} ${path.replaceAll(/:[^/]+/gu, ":")}`;
96
+ const taken = shapes.get(shape);
97
+ if (taken !== void 0) throw new HotUpdaterConfigError(`${handler} (${method} ${path}) collides with ${taken} on handlers.${admin ? "admin" : "client"}.`);
98
+ shapes.set(shape, handler);
99
+ addRoute(router, method, path, handler);
100
+ routes.push({
101
+ method,
102
+ path,
103
+ access: admin ? "admin" : PUBLIC_CLIENT_ROUTES.has(handler) ? "public" : "client"
104
+ });
105
+ };
106
+ /** The Insights routes no plugin endpoint serves, which answer that Insights is off. */
107
+ const mountInsights = (access, add) => {
108
+ for (const route of INSIGHTS_ROUTES) {
109
+ const served = endpoints.some((endpoint) => endpoint.access === route.access && endpoint.method === route.method && endpoint.path === route.path);
110
+ if (route.access === access && !served) add(route.method, route.path, route.handler);
111
+ }
112
+ };
75
113
  const clientRouter = createRouter();
76
- const addClientRoute = (method, path, handler) => addRoute(clientRouter, method, path, handler);
114
+ const addClientRoute = mount(clientRouter, false);
77
115
  addClientRoute("GET", "/version", "version");
78
116
  if (downloadStorageObject !== void 0) addClientRoute("GET", "/storage/:token/:signature", "downloadStorageObject");
79
117
  addClientRoute("GET", "/release-catalogs/app-version/:platform/:channelKey/:appVersion", "appVersionReleaseCatalog");
80
118
  addClientRoute("GET", "/release-catalogs/fingerprint/:platform/:channelKey/:fingerprintHash", "fingerprintReleaseCatalog");
81
- addClientRoute("GET", "/artifacts/:targetBundleId/from/:currentBundleId", "artifact");
82
- if (insights !== void 0) registerInsightsClientRoutes(addClientRoute);
119
+ addClientRoute("GET", "/artifacts/v1/:targetBundleId/from/:currentBundleId", "artifactV1");
120
+ mountInsights("client", addClientRoute);
83
121
  const adminRouter = createRouter();
84
- const addAdminRoute = (method, path, handler) => addRoute(adminRouter, method, path, handler);
85
- addAdminRoute("GET", "/releases/:id", "getRelease");
86
- addAdminRoute("GET", "/releases", "getReleases");
87
- addAdminRoute("PATCH", "/releases/:id", "updateRelease");
88
- addAdminRoute("POST", "/releases/:id/preflight", "preflightRelease");
89
- addAdminRoute("DELETE", "/releases/:id", "deleteRelease");
90
- addAdminRoute("GET", "/release-catalogs/:scopeKey", "getReleaseCatalogRow");
91
- addAdminRoute("GET", "/release-catalogs", "getReleaseCatalogs");
92
- addAdminRoute("POST", "/release-catalogs/:scopeKey/rebuild", "rebuildReleaseCatalog");
93
- addAdminRoute("POST", "/database/commit", "commitDatabase");
94
- addAdminRoute("GET", "/channels", "getChannels");
95
- addAdminRoute("POST", "/channels", "createChannel");
96
- addAdminRoute("DELETE", "/channels/:id", "deleteChannel");
97
- addAdminRoute("GET", "/bundles/:id", "getBundle");
98
- addAdminRoute("GET", "/bundles", "getBundles");
99
- addAdminRoute("POST", "/bundles", "createBundles");
100
- addAdminRoute("PATCH", "/bundles/:id", "updateBundle");
101
- addAdminRoute("DELETE", "/bundles/:id", "deleteBundle");
102
- if (insights !== void 0) registerInsightsAdminRoutes(addAdminRoute);
103
- return Object.freeze({
122
+ const addAdminRoute = mount(adminRouter, true);
123
+ addAdminRoute("GET", "/version", "adminVersion");
124
+ for (const route of ADMIN_ROUTES) addAdminRoute(route.method, route.path, route.handler);
125
+ mountInsights("admin", addAdminRoute);
126
+ for (const endpoint of endpoints) {
127
+ const name = `plugin ${endpoint.plugin}: ${endpoint.method} ${endpoint.path}`;
128
+ routeHandlers[name] = (params, request) => endpoint.handler(request, params);
129
+ (endpoint.access === "admin" ? addAdminRoute : addClientRoute)(endpoint.method, endpoint.path, name);
130
+ }
131
+ const handlers = {
104
132
  client: createRequestHandler({
105
133
  api,
106
- apiKeyAuth,
134
+ ...clientPolicy === void 0 ? {} : { clientPolicy },
107
135
  routeHandlers,
108
136
  router: clientRouter
109
137
  }),
@@ -113,7 +141,9 @@ function createHotUpdaterHandlers(api, insights, apiKeyAuth, downloadStorageObje
113
141
  routeHandlers,
114
142
  router: adminRouter
115
143
  })
116
- });
144
+ };
145
+ Object.defineProperty(handlers, routesOf, { value: Object.freeze(routes) });
146
+ return Object.freeze(handlers);
117
147
  }
118
148
  //#endregion
119
- export { createHandlers, createHotUpdaterHandlers };
149
+ export { createHotUpdaterHandlers };