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

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