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

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 (519) hide show
  1. package/dist/adapters/drizzle.cjs +35 -74
  2. package/dist/adapters/drizzle.d.cts +13 -5
  3. package/dist/adapters/drizzle.d.mts +13 -5
  4. package/dist/adapters/drizzle.mjs +34 -75
  5. package/dist/adapters/drizzleExecutor.cjs +114 -0
  6. package/dist/adapters/drizzleExecutor.d.cts +9 -0
  7. package/dist/adapters/drizzleExecutor.d.mts +9 -0
  8. package/dist/adapters/drizzleExecutor.mjs +112 -0
  9. package/dist/adapters/kysely.cjs +25 -31
  10. package/dist/adapters/kysely.d.cts +10 -6
  11. package/dist/adapters/kysely.d.mts +10 -6
  12. package/dist/adapters/kysely.mjs +25 -32
  13. package/dist/adapters/kyselyExecutor.cjs +32 -0
  14. package/dist/adapters/kyselyExecutor.d.cts +12 -0
  15. package/dist/adapters/kyselyExecutor.d.mts +12 -0
  16. package/dist/adapters/kyselyExecutor.mjs +32 -0
  17. package/dist/adapters/mongodb.cjs +28 -62
  18. package/dist/adapters/mongodb.d.cts +10 -5
  19. package/dist/adapters/mongodb.d.mts +10 -5
  20. package/dist/adapters/mongodb.mjs +28 -63
  21. package/dist/adapters/mongodbAdapter.cjs +174 -0
  22. package/dist/adapters/mongodbAdapter.d.cts +9 -0
  23. package/dist/adapters/mongodbAdapter.d.mts +9 -0
  24. package/dist/adapters/mongodbAdapter.mjs +173 -0
  25. package/dist/adapters/prisma.cjs +38 -257
  26. package/dist/adapters/prisma.d.cts +12 -7
  27. package/dist/adapters/prisma.d.mts +12 -7
  28. package/dist/adapters/prisma.mjs +38 -257
  29. package/dist/adapters/prismaExecutor.cjs +64 -0
  30. package/dist/adapters/prismaExecutor.mjs +64 -0
  31. package/dist/adapters/sqlProviders.cjs +9 -0
  32. package/dist/adapters/sqlProviders.mjs +9 -0
  33. package/dist/apiKeys.cjs +2 -6
  34. package/dist/apiKeys.d.cts +1 -23
  35. package/dist/apiKeys.d.mts +1 -23
  36. package/dist/apiKeys.mjs +2 -6
  37. package/dist/assembly/assemblePlugins.cjs +147 -0
  38. package/dist/assembly/assemblePlugins.d.cts +12 -0
  39. package/dist/assembly/assemblePlugins.d.mts +12 -0
  40. package/dist/assembly/assemblePlugins.mjs +146 -0
  41. package/dist/assembly/databasePlugins.cjs +23 -0
  42. package/dist/assembly/databasePlugins.d.cts +43 -0
  43. package/dist/assembly/databasePlugins.d.mts +43 -0
  44. package/dist/assembly/databasePlugins.mjs +22 -0
  45. package/dist/core/api.cjs +91 -0
  46. package/dist/core/api.d.cts +65 -0
  47. package/dist/core/api.d.mts +65 -0
  48. package/dist/core/api.mjs +87 -0
  49. package/dist/core/baseCandidates.cjs +71 -0
  50. package/dist/core/baseCandidates.d.cts +17 -0
  51. package/dist/core/baseCandidates.d.mts +17 -0
  52. package/dist/core/baseCandidates.mjs +69 -0
  53. package/dist/core/operations.cjs +350 -0
  54. package/dist/core/operations.mjs +350 -0
  55. package/dist/core/reads.cjs +273 -0
  56. package/dist/core/reads.d.cts +48 -0
  57. package/dist/core/reads.d.mts +48 -0
  58. package/dist/core/reads.mjs +267 -0
  59. package/dist/core/releases.cjs +193 -0
  60. package/dist/core/releases.mjs +190 -0
  61. package/dist/core/schema.cjs +279 -0
  62. package/dist/core/schema.d.cts +307 -0
  63. package/dist/core/schema.d.mts +307 -0
  64. package/dist/core/schema.mjs +277 -0
  65. package/dist/core/writes.cjs +96 -0
  66. package/dist/core/writes.mjs +91 -0
  67. package/dist/createHotUpdaterCore.cjs +58 -75
  68. package/dist/createHotUpdaterCore.d.cts +52 -44
  69. package/dist/createHotUpdaterCore.d.mts +52 -44
  70. package/dist/createHotUpdaterCore.mjs +59 -75
  71. package/dist/database/cursor.cjs +44 -0
  72. package/dist/database/cursor.d.cts +7 -0
  73. package/dist/database/cursor.d.mts +7 -0
  74. package/dist/database/cursor.mjs +40 -0
  75. package/dist/database/database.cjs +44 -0
  76. package/dist/database/database.d.cts +123 -0
  77. package/dist/database/database.d.mts +123 -0
  78. package/dist/database/database.mjs +44 -0
  79. package/dist/database/definitions.d.cts +68 -0
  80. package/dist/database/definitions.d.mts +68 -0
  81. package/dist/database/engine.cjs +37 -0
  82. package/dist/database/engine.d.cts +40 -0
  83. package/dist/database/engine.d.mts +40 -0
  84. package/dist/database/engine.mjs +37 -0
  85. package/dist/database/engineAggregates.cjs +115 -0
  86. package/dist/database/engineAggregates.mjs +112 -0
  87. package/dist/database/engineReads.cjs +180 -0
  88. package/dist/database/engineReads.d.cts +35 -0
  89. package/dist/database/engineReads.d.mts +35 -0
  90. package/dist/database/engineReads.mjs +179 -0
  91. package/dist/database/engineTransaction.cjs +403 -0
  92. package/dist/database/engineTransaction.d.cts +26 -0
  93. package/dist/database/engineTransaction.d.mts +26 -0
  94. package/dist/database/engineTransaction.mjs +402 -0
  95. package/dist/database/errors.cjs +27 -0
  96. package/dist/database/errors.d.cts +21 -0
  97. package/dist/database/errors.d.mts +21 -0
  98. package/dist/database/errors.mjs +24 -0
  99. package/dist/database/fence.cjs +124 -0
  100. package/dist/database/fence.d.cts +42 -0
  101. package/dist/database/fence.d.mts +42 -0
  102. package/dist/database/fence.mjs +116 -0
  103. package/dist/database/index.cjs +127 -0
  104. package/dist/database/index.d.cts +17 -0
  105. package/dist/database/index.d.mts +17 -0
  106. package/dist/database/index.mjs +15 -0
  107. package/dist/database/kv/kvAdapter.cjs +273 -0
  108. package/dist/database/kv/kvAdapter.d.cts +101 -0
  109. package/dist/database/kv/kvAdapter.d.mts +101 -0
  110. package/dist/database/kv/kvAdapter.mjs +272 -0
  111. package/dist/database/resolveSchema.cjs +196 -0
  112. package/dist/database/resolveSchema.d.cts +42 -0
  113. package/dist/database/resolveSchema.d.mts +42 -0
  114. package/dist/database/resolveSchema.mjs +193 -0
  115. package/dist/database/schema.cjs +21 -0
  116. package/dist/database/schema.d.cts +61 -0
  117. package/dist/database/schema.d.mts +61 -0
  118. package/dist/database/schema.mjs +20 -0
  119. package/dist/database/sql/sqlAdapter.cjs +282 -0
  120. package/dist/database/sql/sqlAdapter.d.cts +46 -0
  121. package/dist/database/sql/sqlAdapter.d.mts +46 -0
  122. package/dist/database/sql/sqlAdapter.mjs +279 -0
  123. package/dist/database/sql/sqlSchema.cjs +115 -0
  124. package/dist/database/sql/sqlSchema.d.cts +8 -0
  125. package/dist/database/sql/sqlSchema.d.mts +8 -0
  126. package/dist/database/sql/sqlSchema.mjs +111 -0
  127. package/dist/db/builtInDatabase.cjs +104 -0
  128. package/dist/db/builtInDatabase.d.cts +38 -0
  129. package/dist/db/builtInDatabase.d.mts +38 -0
  130. package/dist/db/builtInDatabase.mjs +97 -0
  131. package/dist/db/createBundleDiff.cjs +4 -4
  132. package/dist/db/createBundleDiff.d.cts +3 -2
  133. package/dist/db/createBundleDiff.d.mts +3 -2
  134. package/dist/db/createBundleDiff.mjs +5 -5
  135. package/dist/db/engineDrizzleSchema.cjs +54 -0
  136. package/dist/db/engineDrizzleSchema.mjs +54 -0
  137. package/dist/db/engineMigrator.cjs +53 -0
  138. package/dist/db/engineMigrator.mjs +53 -0
  139. package/dist/db/enginePrismaSchema.cjs +85 -0
  140. package/dist/db/enginePrismaSchema.d.cts +5 -0
  141. package/dist/db/enginePrismaSchema.d.mts +5 -0
  142. package/dist/db/enginePrismaSchema.mjs +84 -0
  143. package/dist/db/engineSql.cjs +26 -0
  144. package/dist/db/engineSql.d.cts +17 -0
  145. package/dist/db/engineSql.d.mts +17 -0
  146. package/dist/db/engineSql.mjs +25 -0
  147. package/dist/db/engineSqlMigrator.cjs +66 -0
  148. package/dist/db/engineSqlMigrator.mjs +66 -0
  149. package/dist/db/fixedMigratorShared.cjs +0 -11
  150. package/dist/db/fixedMigratorShared.mjs +1 -8
  151. package/dist/db/index.cjs +23 -10
  152. package/dist/db/index.d.cts +10 -4
  153. package/dist/db/index.d.mts +10 -4
  154. package/dist/db/index.mjs +16 -9
  155. package/dist/db/releaseCatalog.cjs +20 -43
  156. package/dist/db/releaseCatalog.d.cts +2 -2
  157. package/dist/db/releaseCatalog.d.mts +2 -2
  158. package/dist/db/releaseCatalog.mjs +20 -44
  159. package/dist/db/schemaSettings.cjs +63 -0
  160. package/dist/db/schemaSettings.d.cts +12 -0
  161. package/dist/db/schemaSettings.d.mts +12 -0
  162. package/dist/db/schemaSettings.mjs +62 -0
  163. package/dist/db/settingsMigrator.cjs +92 -0
  164. package/dist/db/settingsMigrator.mjs +89 -0
  165. package/dist/db/types.cjs +1 -12
  166. package/dist/db/types.d.cts +26 -66
  167. package/dist/db/types.d.mts +26 -66
  168. package/dist/db/types.mjs +2 -11
  169. package/dist/db/updateArtifacts.cjs +38 -67
  170. package/dist/db/updateArtifacts.mjs +40 -69
  171. package/dist/diff.cjs +3 -0
  172. package/dist/diff.d.cts +2 -0
  173. package/dist/diff.d.mts +2 -0
  174. package/dist/diff.mjs +2 -0
  175. package/dist/handler.cjs +72 -43
  176. package/dist/handler.d.cts +3 -5
  177. package/dist/handler.d.mts +3 -5
  178. package/dist/handler.mjs +73 -43
  179. package/dist/handlerAdminRoutes.cjs +375 -0
  180. package/dist/handlerAdminRoutes.mjs +373 -0
  181. package/dist/handlerParameters.cjs +6 -11
  182. package/dist/handlerParameters.mjs +6 -10
  183. package/dist/handlerReleaseCatalogRoutes.cjs +11 -13
  184. package/dist/handlerReleaseCatalogRoutes.mjs +11 -13
  185. package/dist/handlerTypes.d.cts +2 -55
  186. package/dist/handlerTypes.d.mts +2 -55
  187. package/dist/handlerVersionRoutes.cjs +20 -4
  188. package/dist/handlerVersionRoutes.mjs +20 -4
  189. package/dist/index.cjs +4 -7
  190. package/dist/index.d.cts +8 -7
  191. package/dist/index.d.mts +8 -7
  192. package/dist/index.mjs +4 -4
  193. package/dist/insights/domain.d.cts +12 -0
  194. package/dist/insights/domain.d.mts +12 -0
  195. package/dist/insights/errors.cjs +34 -0
  196. package/dist/insights/errors.mjs +34 -1
  197. package/dist/insights/eventInput.cjs +14 -19
  198. package/dist/insights/eventInput.mjs +15 -20
  199. package/dist/insights/provider.cjs +47 -23
  200. package/dist/insights/provider.mjs +47 -24
  201. package/dist/insights/routes.cjs +79 -14
  202. package/dist/insights/routes.mjs +77 -14
  203. package/dist/node.d.cts +1 -1
  204. package/dist/node.d.mts +1 -1
  205. package/dist/package.cjs +1 -1
  206. package/dist/package.mjs +1 -1
  207. package/dist/plugins/api-keys/index.cjs +50 -0
  208. package/dist/plugins/api-keys/index.d.cts +85 -0
  209. package/dist/plugins/api-keys/index.d.mts +85 -0
  210. package/dist/plugins/api-keys/index.mjs +47 -0
  211. package/dist/plugins/api-keys/model.cjs +58 -0
  212. package/dist/plugins/api-keys/model.d.cts +8 -0
  213. package/dist/plugins/api-keys/model.d.mts +8 -0
  214. package/dist/plugins/api-keys/model.mjs +58 -0
  215. package/dist/plugins/api-keys/schema.cjs +38 -0
  216. package/dist/plugins/api-keys/schema.d.cts +44 -0
  217. package/dist/plugins/api-keys/schema.d.mts +44 -0
  218. package/dist/plugins/api-keys/schema.mjs +39 -0
  219. package/dist/plugins/builtIn.cjs +7 -0
  220. package/dist/plugins/builtIn.mjs +6 -0
  221. package/dist/plugins/definePlugin.cjs +5 -0
  222. package/dist/plugins/definePlugin.d.cts +73 -0
  223. package/dist/plugins/definePlugin.d.mts +73 -0
  224. package/dist/plugins/definePlugin.mjs +5 -0
  225. package/dist/plugins/index.cjs +17 -0
  226. package/dist/plugins/index.d.cts +9 -0
  227. package/dist/plugins/index.d.mts +9 -0
  228. package/dist/plugins/index.mjs +7 -0
  229. package/dist/plugins/insights/index.cjs +48 -0
  230. package/dist/plugins/insights/index.d.cts +295 -0
  231. package/dist/plugins/insights/index.d.mts +295 -0
  232. package/dist/plugins/insights/index.mjs +44 -0
  233. package/dist/plugins/insights/model.cjs +17 -0
  234. package/dist/plugins/insights/model.d.cts +10 -0
  235. package/dist/plugins/insights/model.d.mts +10 -0
  236. package/dist/plugins/insights/model.mjs +17 -0
  237. package/dist/plugins/insights/reads.cjs +471 -0
  238. package/dist/plugins/insights/reads.mjs +466 -0
  239. package/dist/plugins/insights/recordEvent.cjs +135 -0
  240. package/dist/plugins/insights/recordEvent.d.cts +13 -0
  241. package/dist/plugins/insights/recordEvent.d.mts +13 -0
  242. package/dist/plugins/insights/recordEvent.mjs +132 -0
  243. package/dist/plugins/insights/schema.cjs +347 -0
  244. package/dist/plugins/insights/schema.d.cts +258 -0
  245. package/dist/plugins/insights/schema.d.mts +258 -0
  246. package/dist/plugins/insights/schema.mjs +344 -0
  247. package/dist/types/index.d.cts +2 -28
  248. package/dist/types/index.d.mts +2 -28
  249. package/package.json +32 -5
  250. package/src/adapters/drizzle.conformance.integration.spec.ts +34 -0
  251. package/src/adapters/drizzle.readBudgets.integration.spec.ts +41 -0
  252. package/src/adapters/drizzle.spec.ts +270 -399
  253. package/src/adapters/drizzle.ts +48 -140
  254. package/src/adapters/drizzleExecutor.ts +166 -0
  255. package/src/adapters/kysely.conformance.integration.spec.ts +36 -0
  256. package/src/adapters/kysely.readBudgets.integration.spec.ts +42 -0
  257. package/src/adapters/kysely.spec.ts +204 -171
  258. package/src/adapters/kysely.ts +32 -93
  259. package/src/adapters/kyselyExecutor.ts +53 -0
  260. package/src/adapters/mongodb.integration.spec.ts +143 -446
  261. package/src/adapters/mongodb.readBudgets.integration.spec.ts +61 -0
  262. package/src/adapters/mongodb.ts +36 -123
  263. package/src/adapters/mongodbAdapter.ts +293 -0
  264. package/src/adapters/prisma.conformance.integration.spec.ts +36 -0
  265. package/src/adapters/prisma.integration.spec.ts +138 -0
  266. package/src/adapters/prisma.readBudgets.integration.spec.ts +40 -0
  267. package/src/adapters/prisma.spec.ts +216 -433
  268. package/src/adapters/prisma.ts +60 -524
  269. package/src/adapters/prismaExecutor.ts +107 -0
  270. package/src/adapters/prismaTestClients.ts +175 -0
  271. package/src/adapters/sqlProviders.ts +14 -0
  272. package/src/apiKeys.integration.spec.ts +19 -119
  273. package/src/apiKeys.spec.ts +39 -35
  274. package/src/apiKeys.ts +2 -8
  275. package/src/assembly/assemblePlugins.ts +269 -0
  276. package/src/assembly/assembly.spec.ts +325 -0
  277. package/src/assembly/assembly.types.spec.ts +155 -0
  278. package/src/assembly/builtInRoutes.spec.ts +213 -0
  279. package/src/assembly/databasePlugins.spec.ts +71 -0
  280. package/src/assembly/databasePlugins.ts +96 -0
  281. package/src/core/api.ts +139 -0
  282. package/src/core/baseCandidates.spec.ts +378 -0
  283. package/src/core/baseCandidates.ts +136 -0
  284. package/src/core/index.ts +44 -0
  285. package/src/core/operations.spec.ts +415 -0
  286. package/src/core/operations.ts +551 -0
  287. package/src/core/reads.spec.ts +300 -0
  288. package/src/core/reads.ts +417 -0
  289. package/src/core/releases.spec.ts +308 -0
  290. package/src/core/releases.ts +345 -0
  291. package/src/core/schema.ts +173 -0
  292. package/src/core/writes.ts +160 -0
  293. package/src/createHotUpdaterCore.ts +191 -181
  294. package/src/database/cursor.ts +65 -0
  295. package/src/database/database.ts +335 -0
  296. package/src/database/database.types.spec.ts +135 -0
  297. package/src/database/definitions.ts +72 -0
  298. package/src/database/engine.ts +62 -0
  299. package/src/database/engineAggregates.spec.ts +539 -0
  300. package/src/database/engineAggregates.ts +193 -0
  301. package/src/database/engineReads.spec.ts +219 -0
  302. package/src/database/engineReads.ts +302 -0
  303. package/src/database/engineTransaction.spec.ts +710 -0
  304. package/src/database/engineTransaction.ts +588 -0
  305. package/src/database/errors.ts +30 -0
  306. package/src/database/fence.spec.ts +223 -0
  307. package/src/database/fence.ts +171 -0
  308. package/src/database/index.ts +154 -0
  309. package/src/database/kv/kvAdapter.conformance.integration.spec.ts +17 -0
  310. package/src/database/kv/kvAdapter.readBudgets.integration.spec.ts +17 -0
  311. package/src/database/kv/kvAdapter.spec.ts +468 -0
  312. package/src/database/kv/kvAdapter.ts +450 -0
  313. package/src/database/kv/kvTestStore.ts +91 -0
  314. package/src/database/memory.readBudgets.integration.spec.ts +13 -0
  315. package/src/database/resolveSchema.spec.ts +230 -0
  316. package/src/database/resolveSchema.ts +372 -0
  317. package/src/database/schema.ts +169 -0
  318. package/src/database/schema.types.spec.ts +94 -0
  319. package/src/database/sql/docker-compose.yml +36 -0
  320. package/src/database/sql/sqlAdapter.integration.spec.ts +148 -0
  321. package/src/database/sql/sqlAdapter.readBudgets.integration.spec.ts +109 -0
  322. package/src/database/sql/sqlAdapter.spec.ts +255 -0
  323. package/src/database/sql/sqlAdapter.ts +532 -0
  324. package/src/database/sql/sqlSchema.ts +205 -0
  325. package/src/database/sql/sqlTestExecutors.ts +183 -0
  326. package/src/databaseTestSuite.spec.ts +39 -0
  327. package/src/db/builtInDatabase.ts +149 -0
  328. package/src/db/bundleRows.spec.ts +3 -3
  329. package/src/db/createBundleDiff.spec.ts +43 -29
  330. package/src/db/createBundleDiff.ts +13 -7
  331. package/src/db/engineDrizzleSchema.ts +72 -0
  332. package/src/db/engineMigrator.ts +105 -0
  333. package/src/db/enginePrismaSchema.ts +147 -0
  334. package/src/db/engineSql.spec.ts +129 -0
  335. package/src/db/engineSql.ts +48 -0
  336. package/src/db/engineSqlMigrator.ts +116 -0
  337. package/src/db/fixedMigratorShared.ts +1 -20
  338. package/src/db/index.spec.ts +116 -829
  339. package/src/db/index.ts +43 -15
  340. package/src/db/pluginTables.spec.ts +218 -0
  341. package/src/db/releaseCatalog.ts +48 -90
  342. package/src/db/schemaSettings.ts +104 -0
  343. package/src/db/settingsMigrator.spec.ts +65 -0
  344. package/src/db/settingsMigrator.ts +152 -0
  345. package/src/db/types.ts +25 -171
  346. package/src/db/updateArtifacts.spec.ts +170 -294
  347. package/src/db/updateArtifacts.ts +74 -142
  348. package/src/db/updateCheck.bench.ts +47 -0
  349. package/src/diff.ts +6 -0
  350. package/src/handler-standalone.integration.spec.ts +204 -410
  351. package/src/handler.spec.ts +134 -51
  352. package/src/handler.testFixtures.ts +14 -19
  353. package/src/handler.ts +163 -75
  354. package/src/handlerAdminRoutes.spec.ts +183 -0
  355. package/src/handlerAdminRoutes.ts +536 -0
  356. package/src/handlerAuth.integration.spec.ts +3 -3
  357. package/src/handlerManagement.spec.ts +136 -196
  358. package/src/handlerReleaseCatalogRoutes.ts +15 -17
  359. package/src/handlerTypes.ts +3 -80
  360. package/src/handlerVersionRoutes.ts +20 -7
  361. package/src/index.ts +5 -12
  362. package/src/insights/domain.ts +12 -0
  363. package/src/insights/errors.spec.ts +48 -0
  364. package/src/insights/errors.ts +51 -0
  365. package/src/insights/eventInput.ts +27 -24
  366. package/src/insights/insights.integration.spec.ts +228 -78
  367. package/src/insights/provider.spec.ts +203 -25
  368. package/src/insights/provider.ts +88 -32
  369. package/src/insights/routes.ts +95 -20
  370. package/src/lintRules.spec.ts +76 -0
  371. package/src/plugins/api-keys/apiKeysPlugin.spec.ts +172 -0
  372. package/src/plugins/api-keys/index.ts +66 -0
  373. package/src/plugins/api-keys/model.ts +69 -0
  374. package/src/plugins/api-keys/schema.ts +22 -0
  375. package/src/plugins/builtIn.ts +5 -0
  376. package/src/plugins/definePlugin.ts +100 -0
  377. package/src/plugins/index.ts +55 -0
  378. package/src/plugins/insights/index.ts +86 -0
  379. package/src/plugins/insights/insightsRollout.integration.spec.ts +187 -0
  380. package/src/plugins/insights/model.spec.ts +66 -0
  381. package/src/plugins/insights/model.ts +19 -0
  382. package/src/plugins/insights/reads.spec.ts +725 -0
  383. package/src/plugins/insights/reads.ts +707 -0
  384. package/src/plugins/insights/recordEvent.spec.ts +443 -0
  385. package/src/plugins/insights/recordEvent.ts +238 -0
  386. package/src/plugins/insights/schema.ts +229 -0
  387. package/src/plugins/pluginTestHarness.spec.ts +56 -0
  388. package/src/readBudgets.testFixtures.ts +15 -0
  389. package/src/releaseCatalogRoutes.integration.spec.ts +47 -92
  390. package/src/runtime.spec.ts +91 -77
  391. package/src/runtime.testFixtures.ts +28 -44
  392. package/src/runtimeBundles.integration.spec.ts +112 -0
  393. package/src/testUtilsMutation.integration.spec.ts +215 -0
  394. package/src/testUtilsPackage.integration.spec.ts +176 -0
  395. package/src/types/index.ts +0 -32
  396. package/dist/adapters/databaseConstraintErrors.cjs +0 -22
  397. package/dist/adapters/databaseConstraintErrors.mjs +0 -21
  398. package/dist/adapters/databasePluginUtils.cjs +0 -130
  399. package/dist/adapters/databasePluginUtils.mjs +0 -118
  400. package/dist/adapters/drizzleCrud.cjs +0 -340
  401. package/dist/adapters/drizzleCrud.mjs +0 -337
  402. package/dist/adapters/drizzleLazyDB.cjs +0 -103
  403. package/dist/adapters/drizzleLazyDB.mjs +0 -103
  404. package/dist/adapters/drizzleQuery.cjs +0 -69
  405. package/dist/adapters/drizzleQuery.mjs +0 -69
  406. package/dist/adapters/kyselyCrud.cjs +0 -293
  407. package/dist/adapters/kyselyCrud.mjs +0 -292
  408. package/dist/adapters/kyselyQuery.cjs +0 -56
  409. package/dist/adapters/kyselyQuery.mjs +0 -56
  410. package/dist/adapters/mongodbCollections.cjs +0 -38
  411. package/dist/adapters/mongodbCollections.mjs +0 -32
  412. package/dist/adapters/mongodbQuery.cjs +0 -90
  413. package/dist/adapters/mongodbQuery.mjs +0 -83
  414. package/dist/adapters/mongodbReads.cjs +0 -206
  415. package/dist/adapters/mongodbReads.mjs +0 -206
  416. package/dist/adapters/mongodbWrites.cjs +0 -133
  417. package/dist/adapters/mongodbWrites.mjs +0 -133
  418. package/dist/adapters/prismaInsights.cjs +0 -99
  419. package/dist/adapters/prismaInsights.mjs +0 -97
  420. package/dist/adapters/prismaQuery.cjs +0 -57
  421. package/dist/adapters/prismaQuery.mjs +0 -56
  422. package/dist/adapters/prismaRows.cjs +0 -197
  423. package/dist/adapters/prismaRows.mjs +0 -188
  424. package/dist/db/databasePluginCore.cjs +0 -137
  425. package/dist/db/databasePluginCore.mjs +0 -137
  426. package/dist/db/fixedMigrator.cjs +0 -79
  427. package/dist/db/fixedMigrator.mjs +0 -78
  428. package/dist/db/fixedMigratorMongo.cjs +0 -321
  429. package/dist/db/fixedMigratorMongo.mjs +0 -321
  430. package/dist/db/mongoMigrationExecution.cjs +0 -11
  431. package/dist/db/mongoMigrationExecution.mjs +0 -11
  432. package/dist/db/schema/insightsCollation.cjs +0 -14
  433. package/dist/db/schema/insightsCollation.mjs +0 -14
  434. package/dist/db/schema/mongodb.cjs +0 -25
  435. package/dist/db/schema/mongodb.mjs +0 -25
  436. package/dist/db/schema/registry.cjs +0 -21
  437. package/dist/db/schema/registry.mjs +0 -17
  438. package/dist/db/schema/sql.cjs +0 -105
  439. package/dist/db/schema/sql.mjs +0 -97
  440. package/dist/db/schema/sqlOperations.cjs +0 -27
  441. package/dist/db/schema/sqlOperations.mjs +0 -26
  442. package/dist/db/schemaGenerators.cjs +0 -276
  443. package/dist/db/schemaGenerators.mjs +0 -274
  444. package/dist/db/schemaReadiness.cjs +0 -26
  445. package/dist/db/schemaReadiness.d.cts +0 -9
  446. package/dist/db/schemaReadiness.d.mts +0 -9
  447. package/dist/db/schemaReadiness.mjs +0 -25
  448. package/dist/db/sqlMigrationExecution.cjs +0 -67
  449. package/dist/db/sqlMigrationExecution.mjs +0 -67
  450. package/dist/handlerBundleRoutes.cjs +0 -155
  451. package/dist/handlerBundleRoutes.mjs +0 -155
  452. package/dist/handlerReleaseManagementRoutes.cjs +0 -124
  453. package/dist/handlerReleaseManagementRoutes.mjs +0 -124
  454. package/dist/schema/dsl.cjs +0 -103
  455. package/dist/schema/dsl.mjs +0 -87
  456. package/dist/schema/index.cjs +0 -20
  457. package/dist/schema/index.mjs +0 -7
  458. package/dist/schema/settings.cjs +0 -9
  459. package/dist/schema/settings.mjs +0 -9
  460. package/dist/schema/types.cjs +0 -8
  461. package/dist/schema/types.mjs +0 -6
  462. package/dist/schema/v1_0_0.cjs +0 -393
  463. package/dist/schema/v1_0_0.mjs +0 -385
  464. package/src/adapters/databaseConstraintErrors.ts +0 -25
  465. package/src/adapters/databasePluginTestDatabase.ts +0 -116
  466. package/src/adapters/databasePluginUtils.spec.ts +0 -29
  467. package/src/adapters/databasePluginUtils.ts +0 -238
  468. package/src/adapters/drizzleCrud.ts +0 -610
  469. package/src/adapters/drizzleLazyDB.ts +0 -284
  470. package/src/adapters/drizzleQuery.ts +0 -164
  471. package/src/adapters/kyselyCrud.ts +0 -696
  472. package/src/adapters/kyselyInsights.spec.ts +0 -168
  473. package/src/adapters/kyselyQuery.ts +0 -128
  474. package/src/adapters/mongodb.spec.ts +0 -230
  475. package/src/adapters/mongodbCollections.ts +0 -78
  476. package/src/adapters/mongodbQuery.ts +0 -245
  477. package/src/adapters/mongodbReads.ts +0 -387
  478. package/src/adapters/mongodbRows.spec.ts +0 -64
  479. package/src/adapters/mongodbRows.ts +0 -118
  480. package/src/adapters/mongodbTestClient.ts +0 -443
  481. package/src/adapters/mongodbTestFilter.ts +0 -170
  482. package/src/adapters/mongodbWrites.ts +0 -261
  483. package/src/adapters/prismaInsights.ts +0 -190
  484. package/src/adapters/prismaQuery.ts +0 -129
  485. package/src/adapters/prismaRows.spec.ts +0 -98
  486. package/src/adapters/prismaRows.ts +0 -308
  487. package/src/adapters/prismaTestClient.ts +0 -478
  488. package/src/calculatePagination.ts +0 -34
  489. package/src/db/databasePluginCore.spec.ts +0 -62
  490. package/src/db/databasePluginCore.testFixtures.ts +0 -76
  491. package/src/db/databasePluginCore.ts +0 -185
  492. package/src/db/databasePluginUpdateCheck.bench.ts +0 -117
  493. package/src/db/fixedMigrator.spec.ts +0 -294
  494. package/src/db/fixedMigrator.ts +0 -147
  495. package/src/db/fixedMigratorMongo.spec.ts +0 -253
  496. package/src/db/fixedMigratorMongo.ts +0 -425
  497. package/src/db/hotUpdaterSchema.ts +0 -5
  498. package/src/db/mongoMigrationExecution.ts +0 -23
  499. package/src/db/schema/definitions.ts +0 -1
  500. package/src/db/schema/insightsCollation.ts +0 -21
  501. package/src/db/schema/mongodb.ts +0 -40
  502. package/src/db/schema/registry.ts +0 -55
  503. package/src/db/schema/sql.ts +0 -244
  504. package/src/db/schema/sqlOperations.ts +0 -63
  505. package/src/db/schema/types.ts +0 -1
  506. package/src/db/schemaGenerators.ts +0 -495
  507. package/src/db/schemaReadiness.ts +0 -34
  508. package/src/db/sqlMigrationExecution.spec.ts +0 -65
  509. package/src/db/sqlMigrationExecution.ts +0 -108
  510. package/src/db/types.spec.ts +0 -63
  511. package/src/handlerBundleRoutes.ts +0 -259
  512. package/src/handlerReleaseManagementRoutes.ts +0 -213
  513. package/src/schema/dsl-all-versions.spec.ts +0 -35
  514. package/src/schema/dsl.ts +0 -187
  515. package/src/schema/index.ts +0 -10
  516. package/src/schema/settings.ts +0 -15
  517. package/src/schema/types.ts +0 -79
  518. package/src/schema/v1_0_0.spec.ts +0 -220
  519. package/src/schema/v1_0_0.ts +0 -511
@@ -0,0 +1,269 @@
1
+ import type { DatabaseAdapter } from "@hot-updater/plugin-core/internal";
2
+
3
+ import { createCoreApi, type CoreApi } from "../core/api";
4
+ import { createCoreReads, type CoreStorage } from "../core/reads";
5
+ import { coreModule } from "../core/schema";
6
+ import { createDatabaseEngine } from "../database/database";
7
+ import type { ReadMeasurement } from "../database/engine";
8
+ import { fencedName, withSchemaFence } from "../database/fence";
9
+ import {
10
+ resolveSchema,
11
+ validateSchema,
12
+ type SchemaModule,
13
+ } from "../database/resolveSchema";
14
+ import type { ModuleSchema } from "../database/schema";
15
+ import { addedSettings, builtInModules } from "../db/builtInDatabase";
16
+ import { builtInPlugin } from "../plugins/builtIn";
17
+ import type {
18
+ ClientAuth,
19
+ PluginEndpoint,
20
+ PluginInstance,
21
+ } from "../plugins/definePlugin";
22
+
23
+ /** A misconfigured `createHotUpdater` call, reported at startup. */
24
+ export class HotUpdaterConfigError extends Error {
25
+ readonly name = "HotUpdaterConfigError";
26
+ }
27
+
28
+ export interface MountedEndpoint extends PluginEndpoint {
29
+ readonly plugin: string;
30
+ }
31
+
32
+ export interface AssembledPlugins {
33
+ /** Core's reads and typed writes, on the same engine as the plugins, which get only the reads. */
34
+ readonly core: CoreApi;
35
+ readonly api: Readonly<Record<string, unknown>>;
36
+ readonly endpoints: readonly MountedEndpoint[];
37
+ readonly clientAuth?: ClientAuth & { readonly plugin: string };
38
+ /** With `verify`: runs `read` and reports what it read at both boundaries. */
39
+ readonly measureReads?: <T>(
40
+ read: () => Promise<T>,
41
+ ) => Promise<ReadMeasurement<T>>;
42
+ }
43
+
44
+ interface PluginShape {
45
+ readonly id: string;
46
+ readonly provides?: { readonly clientAuth?: true };
47
+ readonly schemaVersion: string;
48
+ readonly schema: ModuleSchema;
49
+ init(context: unknown): PluginInstance;
50
+ readonly [builtInPlugin]?: true;
51
+ }
52
+
53
+ const PLUGIN_KEYS = new Set([
54
+ "id",
55
+ "provides",
56
+ "schemaVersion",
57
+ "schema",
58
+ "init",
59
+ ]);
60
+ const INSTANCE_KEYS = new Set(["api", "endpoints", "clientAuth"]);
61
+ const METHODS = new Set(["GET", "POST", "PUT", "PATCH", "DELETE"]);
62
+ const BUILT_IN_ID = /^[a-z][A-Za-z0-9]*$/u;
63
+ const PLUGIN_ID = /^[a-z][a-z0-9_]*$/u;
64
+ const PATH = /^(\/(:?[A-Za-z0-9_.~-]+))+$/u;
65
+
66
+ const fail = (message: string): never => {
67
+ throw new HotUpdaterConfigError(message);
68
+ };
69
+
70
+ const isRecord = (value: unknown): value is Record<string, unknown> =>
71
+ typeof value === "object" && value !== null && !Array.isArray(value);
72
+
73
+ const checkPlugin = (value: unknown, at: string): PluginShape => {
74
+ if (!isRecord(value)) return fail(`${at} is not a plugin.`);
75
+ if ("kind" in value) {
76
+ fail(`${at} has a kind; core is built in and is never passed as a plugin.`);
77
+ }
78
+ const unknown = Object.keys(value).find((key) => !PLUGIN_KEYS.has(key));
79
+ if (unknown !== undefined) fail(`${at} has an unknown key "${unknown}".`);
80
+ const plugin = value as unknown as PluginShape;
81
+ const pattern = plugin[builtInPlugin] ? BUILT_IN_ID : PLUGIN_ID;
82
+ if (typeof plugin.id !== "string" || !pattern.test(plugin.id)) {
83
+ fail(`${at} needs an id matching ${pattern.source}.`);
84
+ }
85
+ if (plugin.id === coreModule.id) {
86
+ fail(`${at} uses the id "core", which is core's own.`);
87
+ }
88
+ if (
89
+ typeof plugin.schemaVersion !== "string" ||
90
+ !isRecord(plugin.schema) ||
91
+ typeof plugin.init !== "function"
92
+ ) {
93
+ fail(`Plugin "${plugin.id}" needs a schemaVersion, a schema, and init.`);
94
+ }
95
+ const provides = plugin.provides as unknown;
96
+ if (
97
+ provides !== undefined &&
98
+ (!isRecord(provides) ||
99
+ Object.entries(provides).some(
100
+ ([key, flag]) => key !== "clientAuth" || flag !== true,
101
+ ))
102
+ ) {
103
+ fail(
104
+ `Plugin "${plugin.id}" may only declare provides: { clientAuth: true }.`,
105
+ );
106
+ }
107
+ return plugin;
108
+ };
109
+
110
+ const checkEndpoint = (id: string, value: unknown): MountedEndpoint => {
111
+ const endpoint = (isRecord(value) ? value : {}) as Partial<PluginEndpoint>;
112
+ if (
113
+ !METHODS.has(endpoint.method as string) ||
114
+ typeof endpoint.path !== "string" ||
115
+ !PATH.test(endpoint.path) ||
116
+ (endpoint.access !== "client" && endpoint.access !== "admin") ||
117
+ typeof endpoint.handler !== "function"
118
+ ) {
119
+ fail(
120
+ `Plugin "${id}" has an endpoint that needs a method, a path like /name/:param, access "client" or "admin", and a handler.`,
121
+ );
122
+ }
123
+ return { ...(endpoint as PluginEndpoint), plugin: id };
124
+ };
125
+
126
+ const checkInstance = (plugin: PluginShape, instance: unknown) => {
127
+ const { id } = plugin;
128
+ if (!isRecord(instance))
129
+ return fail(`Plugin "${id}" init returned no instance.`);
130
+ if (typeof instance.then === "function") {
131
+ fail(`Plugin "${id}" init returned a promise; init must be synchronous.`);
132
+ }
133
+ const unknown = Object.keys(instance).find((key) => !INSTANCE_KEYS.has(key));
134
+ if (unknown !== undefined || !("api" in instance)) {
135
+ fail(
136
+ `Plugin "${id}" init must return { api, endpoints?, clientAuth? }${unknown === undefined ? "" : `, not "${unknown}"`}.`,
137
+ );
138
+ }
139
+ const declared = plugin.provides?.clientAuth === true;
140
+ const clientAuth = instance.clientAuth as ClientAuth | undefined;
141
+ if (declared !== (clientAuth !== undefined)) {
142
+ fail(
143
+ declared
144
+ ? `Plugin "${id}" declares provides: { clientAuth: true } but its instance has no clientAuth.`
145
+ : `Plugin "${id}" returns clientAuth without declaring provides: { clientAuth: true }.`,
146
+ );
147
+ }
148
+ if (
149
+ clientAuth !== undefined &&
150
+ (typeof clientAuth.authenticate !== "function" ||
151
+ !Array.isArray(clientAuth.varyHeaders) ||
152
+ !clientAuth.varyHeaders.every((header) => typeof header === "string"))
153
+ ) {
154
+ fail(`Plugin "${id}" clientAuth needs varyHeaders and authenticate.`);
155
+ }
156
+ const endpoints = instance.endpoints ?? [];
157
+ if (!Array.isArray(endpoints))
158
+ fail(`Plugin "${id}" endpoints must be an array.`);
159
+ return {
160
+ api: instance.api,
161
+ clientAuth,
162
+ endpoints: (endpoints as unknown[]).map((endpoint) =>
163
+ checkEndpoint(id, endpoint),
164
+ ),
165
+ };
166
+ };
167
+
168
+ /**
169
+ * Checks every plugin, runs each `init` once against one engine over the
170
+ * database's storage adapter, and collects APIs, endpoints, and clientAuth.
171
+ * Core's reads run on the same engine, so plugins read core through `ctx.core`.
172
+ */
173
+ export const assemblePlugins = (
174
+ value: unknown,
175
+ adapter: DatabaseAdapter,
176
+ {
177
+ now = Date.now,
178
+ storage = { resolveFileUrl: async () => null },
179
+ verify = false,
180
+ onCachedRoutesChange,
181
+ }: {
182
+ readonly now?: () => number;
183
+ readonly storage?: CoreStorage;
184
+ /** Runs the engine in verify mode, which meters reads for `measureReads`. */
185
+ readonly verify?: boolean;
186
+ /** The database's CDN purge, which core calls after a catalog write. */
187
+ readonly onCachedRoutesChange?: () => Promise<void>;
188
+ } = {},
189
+ ): AssembledPlugins => {
190
+ if (!Array.isArray(value))
191
+ return fail("plugins must be an array of plugins.");
192
+ const plugins = value.map((plugin, position) =>
193
+ checkPlugin(plugin, `plugins[${position}]`),
194
+ );
195
+ const ids = new Set<string>();
196
+ for (const { id } of plugins) {
197
+ if (ids.has(id)) fail(`Plugin "${id}" is registered twice.`);
198
+ ids.add(id);
199
+ }
200
+ const modules: (SchemaModule & { readonly schema: ModuleSchema })[] =
201
+ plugins.map((plugin) => ({
202
+ id: plugin.id,
203
+ schema: plugin.schema,
204
+ ...(plugin[builtInPlugin] ? {} : { namespace: plugin.id }),
205
+ }));
206
+ const added = modules.filter(({ namespace }) => namespace !== undefined);
207
+ if (added.length > 0) {
208
+ // Tooling creates the built-in tables and settings rows whichever plugins
209
+ // a server runs, so a third-party plugin takes none of their names.
210
+ const taken = added.find(({ id }) =>
211
+ builtInModules.some((module) => module.id === id),
212
+ );
213
+ if (taken !== undefined) {
214
+ fail(`Plugin "${taken.id}" uses a built-in plugin's id.`);
215
+ }
216
+ validateSchema([...builtInModules, ...added]);
217
+ }
218
+ // A fenced database also waits for each third-party plugin's settings row.
219
+ const name = fencedName(adapter);
220
+ const engine = createDatabaseEngine({
221
+ adapter:
222
+ name === undefined || added.length === 0
223
+ ? adapter
224
+ : withSchemaFence(adapter, name, addedSettings(plugins)),
225
+ schema: resolveSchema([coreModule, ...modules]),
226
+ verify,
227
+ });
228
+ const coreDatabase = engine.database(coreModule);
229
+ const core = createCoreApi(coreDatabase, storage, {
230
+ now,
231
+ ...(onCachedRoutesChange === undefined ? {} : { onCachedRoutesChange }),
232
+ });
233
+ const reads = createCoreReads(coreDatabase, storage);
234
+ const api: Record<string, unknown> = {};
235
+ const endpoints: MountedEndpoint[] = [];
236
+ let clientAuth: AssembledPlugins["clientAuth"];
237
+ plugins.forEach((plugin, position) => {
238
+ const instance = checkInstance(
239
+ plugin,
240
+ plugin.init({
241
+ db: engine.database(modules[position]!),
242
+ core: reads,
243
+ now,
244
+ }),
245
+ );
246
+ if (instance.clientAuth !== undefined) {
247
+ if (clientAuth !== undefined) {
248
+ fail(
249
+ `Plugins "${clientAuth.plugin}" and "${plugin.id}" both provide clientAuth; keep one.`,
250
+ );
251
+ }
252
+ const provided = instance.clientAuth;
253
+ clientAuth = {
254
+ plugin: plugin.id,
255
+ varyHeaders: provided.varyHeaders,
256
+ authenticate: (headers) => provided.authenticate(headers),
257
+ };
258
+ }
259
+ endpoints.push(...instance.endpoints);
260
+ api[plugin.id] = instance.api;
261
+ });
262
+ return {
263
+ core,
264
+ api,
265
+ endpoints,
266
+ ...(clientAuth === undefined ? {} : { clientAuth }),
267
+ ...(verify ? { measureReads: engine.measureReads } : {}),
268
+ };
269
+ };
@@ -0,0 +1,325 @@
1
+ import { createMemoryAdapter } from "@hot-updater/plugin-core/internal";
2
+ import { describe, expect, it, vi } from "vitest";
3
+
4
+ import { createBundleFixture } from "../../../test-utils/src/databaseTestFixtures";
5
+ import { createHotUpdater } from "../createHotUpdaterCore";
6
+ import { defineTable } from "../database/schema";
7
+ import { listHotUpdaterRoutes } from "../handler";
8
+ import { definePlugin } from "../plugins/definePlugin";
9
+ import { HotUpdaterConfigError } from "./assemblePlugins";
10
+
11
+ const database = () => ({ name: "memory", adapter: createMemoryAdapter() });
12
+
13
+ const notes = definePlugin({
14
+ id: "notes",
15
+ schemaVersion: "1",
16
+ schema: {
17
+ notes: defineTable(
18
+ { id: { type: "string" }, text: { type: "string" } },
19
+ { key: ["id"] },
20
+ ),
21
+ },
22
+ init: ({ db, now }) => ({
23
+ api: {
24
+ add: (id: string, text: string) =>
25
+ db.transaction(async (tx) => {
26
+ tx.create("notes", { id, text });
27
+ }),
28
+ read: (id: string) => db.findOne("notes", { id }),
29
+ now,
30
+ },
31
+ endpoints: [
32
+ {
33
+ method: "GET",
34
+ path: "/notes/:id",
35
+ access: "client",
36
+ handler: async (_request, params) =>
37
+ Response.json(await db.findOne("notes", { id: params.id! }), {
38
+ headers: { "cache-control": "public, max-age=60" },
39
+ }),
40
+ },
41
+ {
42
+ method: "DELETE",
43
+ path: "/notes/:id",
44
+ access: "admin",
45
+ handler: async () => new Response(null, { status: 204 }),
46
+ },
47
+ ],
48
+ }),
49
+ });
50
+
51
+ const keys = (
52
+ authenticate = async (headers: Headers) => headers.get("x-key") === "valid",
53
+ ) =>
54
+ definePlugin({
55
+ id: "keys",
56
+ provides: { clientAuth: true },
57
+ schemaVersion: "1",
58
+ schema: {},
59
+ init: () => ({
60
+ api: {},
61
+ clientAuth: { varyHeaders: ["X-Key"], authenticate },
62
+ }),
63
+ });
64
+
65
+ const startup = (options: Record<string, unknown>) => () =>
66
+ createHotUpdater({ database: database(), ...options } as never);
67
+
68
+ describe("createHotUpdater with plugins", () => {
69
+ it("gives each plugin its own tables on the engine and exposes its API by id", async () => {
70
+ const hotUpdater = createHotUpdater({
71
+ database: database(),
72
+ plugins: [notes],
73
+ clientAccess: "public",
74
+ });
75
+ await hotUpdater.api.notes.add("n1", "hello");
76
+ await expect(hotUpdater.api.notes.read("n1")).resolves.toEqual({
77
+ id: "n1",
78
+ text: "hello",
79
+ });
80
+ expect(hotUpdater.api.notes.now()).toBeTypeOf("number");
81
+ });
82
+
83
+ it("mounts endpoints by access and lists every route with its access", () => {
84
+ const { handlers } = createHotUpdater({
85
+ database: database(),
86
+ plugins: [notes, keys()],
87
+ });
88
+ expect(listHotUpdaterRoutes(handlers)).toEqual([
89
+ { method: "GET", path: "/version", access: "public" },
90
+ {
91
+ method: "GET",
92
+ path: "/release-catalogs/app-version/:platform/:channelKey/:appVersion",
93
+ access: "client",
94
+ },
95
+ {
96
+ method: "GET",
97
+ path: "/release-catalogs/fingerprint/:platform/:channelKey/:fingerprintHash",
98
+ access: "client",
99
+ },
100
+ {
101
+ method: "GET",
102
+ path: "/artifacts/v1/:targetBundleId/from/:currentBundleId",
103
+ access: "client",
104
+ },
105
+ { method: "POST", path: "/events", access: "client" },
106
+ { method: "GET", path: "/version", access: "admin" },
107
+ { method: "POST", path: "/releases", access: "admin" },
108
+ { method: "POST", path: "/releases/:id/promote", access: "admin" },
109
+ { method: "GET", path: "/releases/:id", access: "admin" },
110
+ { method: "GET", path: "/releases", access: "admin" },
111
+ { method: "PATCH", path: "/releases/:id", access: "admin" },
112
+ { method: "POST", path: "/releases/:id/preflight", access: "admin" },
113
+ { method: "DELETE", path: "/releases/:id", access: "admin" },
114
+ { method: "GET", path: "/release-catalogs/:scopeKey", access: "admin" },
115
+ { method: "GET", path: "/release-catalogs", access: "admin" },
116
+ {
117
+ method: "POST",
118
+ path: "/release-catalogs/:scopeKey/rebuild",
119
+ access: "admin",
120
+ },
121
+ {
122
+ method: "POST",
123
+ path: "/release-catalogs/:scopeKey/preflight",
124
+ access: "admin",
125
+ },
126
+ { method: "GET", path: "/channels", access: "admin" },
127
+ { method: "POST", path: "/channels", access: "admin" },
128
+ { method: "DELETE", path: "/channels/:id", access: "admin" },
129
+ { method: "GET", path: "/bundles/count", access: "admin" },
130
+ { method: "GET", path: "/bundles/child-counts", access: "admin" },
131
+ { method: "GET", path: "/bundles/:id", access: "admin" },
132
+ { method: "GET", path: "/bundles", access: "admin" },
133
+ { method: "PATCH", path: "/bundles/:id", access: "admin" },
134
+ { method: "POST", path: "/bundles/delete", access: "admin" },
135
+ { method: "GET", path: "/bundles/:id/children", access: "admin" },
136
+ {
137
+ method: "GET",
138
+ path: "/base-candidates/:candidateKey",
139
+ access: "admin",
140
+ },
141
+ { method: "GET", path: "/events", access: "admin" },
142
+ { method: "GET", path: "/overview", access: "admin" },
143
+ { method: "GET", path: "/installations", access: "admin" },
144
+ {
145
+ method: "GET",
146
+ path: "/installations/:installId/events",
147
+ access: "admin",
148
+ },
149
+ { method: "GET", path: "/installations/:installId", access: "admin" },
150
+ { method: "GET", path: "/notes/:id", access: "client" },
151
+ { method: "DELETE", path: "/notes/:id", access: "admin" },
152
+ ]);
153
+ });
154
+
155
+ it("puts client routes and client endpoints behind clientAuth, never /version, and varies cacheable answers", async () => {
156
+ const authenticate = vi.fn(async (headers: Headers) => {
157
+ if (headers.get("x-key") === "down") throw new Error("unavailable");
158
+ return headers.get("x-key") === "valid";
159
+ });
160
+ const hotUpdater = createHotUpdater({
161
+ database: database(),
162
+ plugins: [notes, keys(authenticate)],
163
+ });
164
+ await hotUpdater.api.notes.add("n1", "hello");
165
+ const client = (path: string, key?: string) =>
166
+ hotUpdater.handlers.client(
167
+ new Request(`https://updates.example.com${path}`, {
168
+ headers: key === undefined ? {} : { "x-key": key },
169
+ }),
170
+ );
171
+
172
+ expect((await client("/version")).status).toBe(200);
173
+ expect(authenticate).not.toHaveBeenCalled();
174
+ expect((await client("/notes/n1")).status).toBe(401);
175
+ expect((await client("/notes/n1", "down")).status).toBe(503);
176
+ const allowed = await client("/notes/n1", "valid");
177
+ expect(allowed.status).toBe(200);
178
+ await expect(allowed.json()).resolves.toMatchObject({ text: "hello" });
179
+ expect(allowed.headers.get("vary")).toBe("x-key");
180
+ expect(
181
+ (
182
+ await hotUpdater.handlers.admin(
183
+ new Request("https://updates.example.com/notes/n1", {
184
+ method: "DELETE",
185
+ }),
186
+ )
187
+ ).status,
188
+ ).toBe(204);
189
+ });
190
+
191
+ it("leaves client routes open with clientAccess: public", async () => {
192
+ const hotUpdater = createHotUpdater({
193
+ database: database(),
194
+ plugins: [notes],
195
+ clientAccess: "public",
196
+ });
197
+ await hotUpdater.api.notes.add("n1", "hello");
198
+ const response = await hotUpdater.handlers.client(
199
+ new Request("https://updates.example.com/notes/n1"),
200
+ );
201
+ expect(response.status).toBe(200);
202
+ expect(response.headers.get("vary")).toBeNull();
203
+ });
204
+
205
+ it("purges the database's cached client routes after core writes a Release Catalog, not after a plugin write", async () => {
206
+ const onCachedRoutesChange = vi.fn(async () => undefined);
207
+ const hotUpdater = createHotUpdater({
208
+ database: { ...database(), onCachedRoutesChange },
209
+ plugins: [notes],
210
+ clientAccess: "public",
211
+ });
212
+
213
+ await hotUpdater.api.notes.add("n1", "hello");
214
+ expect(onCachedRoutesChange).not.toHaveBeenCalled();
215
+ await hotUpdater.core.deploy([
216
+ {
217
+ bundle: createBundleFixture("801"),
218
+ release: {
219
+ channel: "production",
220
+ enabled: true,
221
+ fingerprintHash: null,
222
+ message: null,
223
+ shouldForceUpdate: false,
224
+ targetAppVersion: "1.0.0",
225
+ },
226
+ },
227
+ ]);
228
+
229
+ expect(onCachedRoutesChange).toHaveBeenCalledTimes(1);
230
+ });
231
+
232
+ it("rejects every misconfiguration at startup", () => {
233
+ const valid = {
234
+ id: "valid",
235
+ schemaVersion: "1",
236
+ schema: {},
237
+ init: () => ({ api: {} }),
238
+ };
239
+ const cases: [Record<string, unknown>, string][] = [
240
+ [{ plugins: [notes] }, 'Set clientAccess to "public"'],
241
+ [
242
+ { plugins: [keys()], clientAccess: "public" },
243
+ 'Plugin "keys" provides clientAuth, so remove clientAccess.',
244
+ ],
245
+ [
246
+ {
247
+ plugins: [keys(), { ...keys(), id: "sso" }],
248
+ },
249
+ 'Plugins "keys" and "sso" both provide clientAuth; keep one.',
250
+ ],
251
+ [
252
+ { plugins: [valid, valid], clientAccess: "public" },
253
+ 'Plugin "valid" is registered twice.',
254
+ ],
255
+ [
256
+ { plugins: [{ ...valid, kind: "core" }], clientAccess: "public" },
257
+ "plugins[0] has a kind; core is built in and is never passed as a plugin.",
258
+ ],
259
+ [
260
+ { plugins: [{ ...valid, hooks: {} }], clientAccess: "public" },
261
+ 'plugins[0] has an unknown key "hooks".',
262
+ ],
263
+ [
264
+ {
265
+ plugins: [{ ...valid, init: async () => ({ api: {} }) }],
266
+ clientAccess: "public",
267
+ },
268
+ 'Plugin "valid" init returned a promise; init must be synchronous.',
269
+ ],
270
+ [
271
+ {
272
+ plugins: [{ ...valid, provides: { clientAuth: true } }],
273
+ clientAccess: "public",
274
+ },
275
+ 'Plugin "valid" declares provides: { clientAuth: true } but its instance has no clientAuth.',
276
+ ],
277
+ [
278
+ {
279
+ plugins: [
280
+ {
281
+ ...valid,
282
+ init: () => ({
283
+ api: {},
284
+ clientAuth: { varyHeaders: [], authenticate: async () => true },
285
+ }),
286
+ },
287
+ ],
288
+ clientAccess: "public",
289
+ },
290
+ 'Plugin "valid" returns clientAuth without declaring provides: { clientAuth: true }.',
291
+ ],
292
+ [
293
+ {
294
+ plugins: [
295
+ {
296
+ ...valid,
297
+ init: () => ({
298
+ api: {},
299
+ endpoints: [
300
+ {
301
+ method: "GET",
302
+ path: "/version",
303
+ access: "client",
304
+ handler: async () => new Response(),
305
+ },
306
+ ],
307
+ }),
308
+ },
309
+ ],
310
+ clientAccess: "public",
311
+ },
312
+ "plugin valid: GET /version (GET /version) collides with version on handlers.client.",
313
+ ],
314
+ [
315
+ { plugins: [{ ...valid, id: "Valid" }], clientAccess: "public" },
316
+ "plugins[0] needs an id matching ^[a-z][a-z0-9_]*$.",
317
+ ],
318
+ ];
319
+ for (const [options, message] of cases) {
320
+ const run = startup(options);
321
+ expect(run).toThrow(HotUpdaterConfigError);
322
+ expect(run).toThrow(message);
323
+ }
324
+ });
325
+ });