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

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (542) hide show
  1. package/dist/_virtual/_rolldown/runtime.cjs +1 -1
  2. package/dist/adapters/drizzle.cjs +35 -69
  3. package/dist/adapters/drizzle.d.cts +13 -6
  4. package/dist/adapters/drizzle.d.mts +13 -6
  5. package/dist/adapters/drizzle.mjs +34 -69
  6. package/dist/adapters/drizzleExecutor.cjs +114 -0
  7. package/dist/adapters/drizzleExecutor.d.cts +9 -0
  8. package/dist/adapters/drizzleExecutor.d.mts +9 -0
  9. package/dist/adapters/drizzleExecutor.mjs +112 -0
  10. package/dist/adapters/kysely.cjs +25 -31
  11. package/dist/adapters/kysely.d.cts +10 -7
  12. package/dist/adapters/kysely.d.mts +10 -7
  13. package/dist/adapters/kysely.mjs +25 -31
  14. package/dist/adapters/kyselyExecutor.cjs +32 -0
  15. package/dist/adapters/kyselyExecutor.d.cts +12 -0
  16. package/dist/adapters/kyselyExecutor.d.mts +12 -0
  17. package/dist/adapters/kyselyExecutor.mjs +32 -0
  18. package/dist/adapters/mongodb.cjs +28 -27
  19. package/dist/adapters/mongodb.d.cts +10 -5
  20. package/dist/adapters/mongodb.d.mts +10 -5
  21. package/dist/adapters/mongodb.mjs +28 -27
  22. package/dist/adapters/mongodbAdapter.cjs +174 -0
  23. package/dist/adapters/mongodbAdapter.d.cts +9 -0
  24. package/dist/adapters/mongodbAdapter.d.mts +9 -0
  25. package/dist/adapters/mongodbAdapter.mjs +173 -0
  26. package/dist/adapters/prisma.cjs +38 -220
  27. package/dist/adapters/prisma.d.cts +12 -8
  28. package/dist/adapters/prisma.d.mts +12 -8
  29. package/dist/adapters/prisma.mjs +38 -219
  30. package/dist/adapters/prismaExecutor.cjs +64 -0
  31. package/dist/adapters/prismaExecutor.mjs +64 -0
  32. package/dist/adapters/sqlProviders.cjs +9 -0
  33. package/dist/adapters/sqlProviders.mjs +9 -0
  34. package/dist/apiKeys.cjs +8 -8
  35. package/dist/apiKeys.d.cts +1 -24
  36. package/dist/apiKeys.d.mts +1 -24
  37. package/dist/apiKeys.mjs +5 -9
  38. package/dist/assembly/assemblePlugins.cjs +147 -0
  39. package/dist/assembly/assemblePlugins.d.cts +12 -0
  40. package/dist/assembly/assemblePlugins.d.mts +12 -0
  41. package/dist/assembly/assemblePlugins.mjs +146 -0
  42. package/dist/assembly/databasePlugins.cjs +23 -0
  43. package/dist/assembly/databasePlugins.d.cts +43 -0
  44. package/dist/assembly/databasePlugins.d.mts +43 -0
  45. package/dist/assembly/databasePlugins.mjs +22 -0
  46. package/dist/core/api.cjs +91 -0
  47. package/dist/core/api.d.cts +65 -0
  48. package/dist/core/api.d.mts +65 -0
  49. package/dist/core/api.mjs +87 -0
  50. package/dist/core/baseCandidates.cjs +71 -0
  51. package/dist/core/baseCandidates.d.cts +17 -0
  52. package/dist/core/baseCandidates.d.mts +17 -0
  53. package/dist/core/baseCandidates.mjs +69 -0
  54. package/dist/core/operations.cjs +350 -0
  55. package/dist/core/operations.mjs +350 -0
  56. package/dist/core/reads.cjs +273 -0
  57. package/dist/core/reads.d.cts +48 -0
  58. package/dist/core/reads.d.mts +48 -0
  59. package/dist/core/reads.mjs +267 -0
  60. package/dist/core/releases.cjs +193 -0
  61. package/dist/core/releases.mjs +190 -0
  62. package/dist/core/schema.cjs +279 -0
  63. package/dist/core/schema.d.cts +307 -0
  64. package/dist/core/schema.d.mts +307 -0
  65. package/dist/core/schema.mjs +277 -0
  66. package/dist/core/writes.cjs +96 -0
  67. package/dist/core/writes.mjs +91 -0
  68. package/dist/createHotUpdaterCore.cjs +61 -63
  69. package/dist/createHotUpdaterCore.d.cts +53 -45
  70. package/dist/createHotUpdaterCore.d.mts +53 -45
  71. package/dist/createHotUpdaterCore.mjs +61 -63
  72. package/dist/database/cursor.cjs +44 -0
  73. package/dist/database/cursor.d.cts +7 -0
  74. package/dist/database/cursor.d.mts +7 -0
  75. package/dist/database/cursor.mjs +40 -0
  76. package/dist/database/database.cjs +44 -0
  77. package/dist/database/database.d.cts +123 -0
  78. package/dist/database/database.d.mts +123 -0
  79. package/dist/database/database.mjs +44 -0
  80. package/dist/database/definitions.d.cts +68 -0
  81. package/dist/database/definitions.d.mts +68 -0
  82. package/dist/database/engine.cjs +37 -0
  83. package/dist/database/engine.d.cts +40 -0
  84. package/dist/database/engine.d.mts +40 -0
  85. package/dist/database/engine.mjs +37 -0
  86. package/dist/database/engineAggregates.cjs +115 -0
  87. package/dist/database/engineAggregates.mjs +112 -0
  88. package/dist/database/engineReads.cjs +180 -0
  89. package/dist/database/engineReads.d.cts +35 -0
  90. package/dist/database/engineReads.d.mts +35 -0
  91. package/dist/database/engineReads.mjs +179 -0
  92. package/dist/database/engineTransaction.cjs +403 -0
  93. package/dist/database/engineTransaction.d.cts +26 -0
  94. package/dist/database/engineTransaction.d.mts +26 -0
  95. package/dist/database/engineTransaction.mjs +402 -0
  96. package/dist/database/errors.cjs +27 -0
  97. package/dist/database/errors.d.cts +21 -0
  98. package/dist/database/errors.d.mts +21 -0
  99. package/dist/database/errors.mjs +24 -0
  100. package/dist/database/fence.cjs +124 -0
  101. package/dist/database/fence.d.cts +42 -0
  102. package/dist/database/fence.d.mts +42 -0
  103. package/dist/database/fence.mjs +116 -0
  104. package/dist/database/index.cjs +127 -0
  105. package/dist/database/index.d.cts +17 -0
  106. package/dist/database/index.d.mts +17 -0
  107. package/dist/database/index.mjs +15 -0
  108. package/dist/database/kv/kvAdapter.cjs +273 -0
  109. package/dist/database/kv/kvAdapter.d.cts +101 -0
  110. package/dist/database/kv/kvAdapter.d.mts +101 -0
  111. package/dist/database/kv/kvAdapter.mjs +272 -0
  112. package/dist/database/resolveSchema.cjs +196 -0
  113. package/dist/database/resolveSchema.d.cts +42 -0
  114. package/dist/database/resolveSchema.d.mts +42 -0
  115. package/dist/database/resolveSchema.mjs +193 -0
  116. package/dist/database/schema.cjs +21 -0
  117. package/dist/database/schema.d.cts +61 -0
  118. package/dist/database/schema.d.mts +61 -0
  119. package/dist/database/schema.mjs +20 -0
  120. package/dist/database/sql/sqlAdapter.cjs +282 -0
  121. package/dist/database/sql/sqlAdapter.d.cts +46 -0
  122. package/dist/database/sql/sqlAdapter.d.mts +46 -0
  123. package/dist/database/sql/sqlAdapter.mjs +279 -0
  124. package/dist/database/sql/sqlSchema.cjs +115 -0
  125. package/dist/database/sql/sqlSchema.d.cts +8 -0
  126. package/dist/database/sql/sqlSchema.d.mts +8 -0
  127. package/dist/database/sql/sqlSchema.mjs +111 -0
  128. package/dist/db/builtInDatabase.cjs +104 -0
  129. package/dist/db/builtInDatabase.d.cts +38 -0
  130. package/dist/db/builtInDatabase.d.mts +38 -0
  131. package/dist/db/builtInDatabase.mjs +97 -0
  132. package/dist/db/createBundleDiff.cjs +6 -6
  133. package/dist/db/createBundleDiff.d.cts +4 -7
  134. package/dist/db/createBundleDiff.d.mts +4 -7
  135. package/dist/db/createBundleDiff.mjs +5 -5
  136. package/dist/db/engineDrizzleSchema.cjs +54 -0
  137. package/dist/db/engineDrizzleSchema.mjs +54 -0
  138. package/dist/db/engineMigrator.cjs +53 -0
  139. package/dist/db/engineMigrator.mjs +53 -0
  140. package/dist/db/enginePrismaSchema.cjs +85 -0
  141. package/dist/db/enginePrismaSchema.d.cts +5 -0
  142. package/dist/db/enginePrismaSchema.d.mts +5 -0
  143. package/dist/db/enginePrismaSchema.mjs +84 -0
  144. package/dist/db/engineSql.cjs +26 -0
  145. package/dist/db/engineSql.d.cts +17 -0
  146. package/dist/db/engineSql.d.mts +17 -0
  147. package/dist/db/engineSql.mjs +25 -0
  148. package/dist/db/engineSqlMigrator.cjs +66 -0
  149. package/dist/db/engineSqlMigrator.mjs +66 -0
  150. package/dist/db/fixedMigratorShared.cjs +0 -11
  151. package/dist/db/fixedMigratorShared.mjs +1 -8
  152. package/dist/db/index.cjs +23 -8
  153. package/dist/db/index.d.cts +10 -4
  154. package/dist/db/index.d.mts +10 -4
  155. package/dist/db/index.mjs +16 -8
  156. package/dist/db/releaseCatalog.cjs +20 -44
  157. package/dist/db/releaseCatalog.d.cts +2 -3
  158. package/dist/db/releaseCatalog.d.mts +2 -3
  159. package/dist/db/releaseCatalog.mjs +20 -44
  160. package/dist/db/schemaSettings.cjs +63 -0
  161. package/dist/db/schemaSettings.d.cts +12 -0
  162. package/dist/db/schemaSettings.d.mts +12 -0
  163. package/dist/db/schemaSettings.mjs +62 -0
  164. package/dist/db/settingsMigrator.cjs +92 -0
  165. package/dist/db/settingsMigrator.mjs +89 -0
  166. package/dist/db/types.cjs +3 -12
  167. package/dist/db/types.d.cts +26 -69
  168. package/dist/db/types.d.mts +26 -69
  169. package/dist/db/types.mjs +2 -11
  170. package/dist/db/updateArtifacts.cjs +38 -68
  171. package/dist/db/updateArtifacts.mjs +40 -69
  172. package/dist/handler.cjs +72 -43
  173. package/dist/handler.d.cts +3 -6
  174. package/dist/handler.d.mts +3 -6
  175. package/dist/handler.mjs +73 -43
  176. package/dist/handlerAdminRoutes.cjs +375 -0
  177. package/dist/handlerAdminRoutes.mjs +373 -0
  178. package/dist/handlerParameters.cjs +6 -11
  179. package/dist/handlerParameters.mjs +6 -10
  180. package/dist/handlerReleaseCatalogRoutes.cjs +11 -14
  181. package/dist/handlerReleaseCatalogRoutes.mjs +11 -13
  182. package/dist/handlerTypes.d.cts +2 -56
  183. package/dist/handlerTypes.d.mts +2 -56
  184. package/dist/handlerVersionRoutes.cjs +20 -4
  185. package/dist/handlerVersionRoutes.d.cts +1 -0
  186. package/dist/handlerVersionRoutes.d.mts +1 -0
  187. package/dist/handlerVersionRoutes.mjs +20 -4
  188. package/dist/index.cjs +4 -7
  189. package/dist/index.d.cts +10 -9
  190. package/dist/index.d.mts +10 -9
  191. package/dist/index.mjs +4 -4
  192. package/dist/insights/domain.d.cts +53 -70
  193. package/dist/insights/domain.d.mts +53 -70
  194. package/dist/insights/errors.cjs +35 -8
  195. package/dist/insights/errors.mjs +35 -8
  196. package/dist/insights/eventInput.cjs +64 -24
  197. package/dist/insights/eventInput.mjs +63 -25
  198. package/dist/insights/provider.cjs +356 -0
  199. package/dist/insights/provider.d.cts +6 -0
  200. package/dist/insights/provider.d.mts +6 -0
  201. package/dist/insights/provider.mjs +355 -0
  202. package/dist/insights/queryInput.cjs +78 -43
  203. package/dist/insights/queryInput.mjs +76 -40
  204. package/dist/insights/routes.cjs +94 -34
  205. package/dist/insights/routes.mjs +93 -35
  206. package/dist/insights/types.d.cts +27 -12
  207. package/dist/insights/types.d.mts +27 -12
  208. package/dist/node.d.cts +1 -2
  209. package/dist/node.d.mts +1 -2
  210. package/dist/package.cjs +1 -1
  211. package/dist/package.mjs +1 -1
  212. package/dist/plugins/api-keys/index.cjs +50 -0
  213. package/dist/plugins/api-keys/index.d.cts +85 -0
  214. package/dist/plugins/api-keys/index.d.mts +85 -0
  215. package/dist/plugins/api-keys/index.mjs +47 -0
  216. package/dist/plugins/api-keys/model.cjs +58 -0
  217. package/dist/plugins/api-keys/model.d.cts +8 -0
  218. package/dist/plugins/api-keys/model.d.mts +8 -0
  219. package/dist/plugins/api-keys/model.mjs +58 -0
  220. package/dist/plugins/api-keys/schema.cjs +38 -0
  221. package/dist/plugins/api-keys/schema.d.cts +44 -0
  222. package/dist/plugins/api-keys/schema.d.mts +44 -0
  223. package/dist/plugins/api-keys/schema.mjs +39 -0
  224. package/dist/plugins/builtIn.cjs +7 -0
  225. package/dist/plugins/builtIn.mjs +6 -0
  226. package/dist/plugins/definePlugin.cjs +5 -0
  227. package/dist/plugins/definePlugin.d.cts +73 -0
  228. package/dist/plugins/definePlugin.d.mts +73 -0
  229. package/dist/plugins/definePlugin.mjs +5 -0
  230. package/dist/plugins/index.cjs +17 -0
  231. package/dist/plugins/index.d.cts +9 -0
  232. package/dist/plugins/index.d.mts +9 -0
  233. package/dist/plugins/index.mjs +7 -0
  234. package/dist/plugins/insights/index.cjs +48 -0
  235. package/dist/plugins/insights/index.d.cts +295 -0
  236. package/dist/plugins/insights/index.d.mts +295 -0
  237. package/dist/plugins/insights/index.mjs +44 -0
  238. package/dist/plugins/insights/model.cjs +17 -0
  239. package/dist/plugins/insights/model.d.cts +10 -0
  240. package/dist/plugins/insights/model.d.mts +10 -0
  241. package/dist/plugins/insights/model.mjs +17 -0
  242. package/dist/plugins/insights/reads.cjs +471 -0
  243. package/dist/plugins/insights/reads.mjs +466 -0
  244. package/dist/plugins/insights/recordEvent.cjs +135 -0
  245. package/dist/plugins/insights/recordEvent.d.cts +13 -0
  246. package/dist/plugins/insights/recordEvent.d.mts +13 -0
  247. package/dist/plugins/insights/recordEvent.mjs +132 -0
  248. package/dist/plugins/insights/schema.cjs +347 -0
  249. package/dist/plugins/insights/schema.d.cts +258 -0
  250. package/dist/plugins/insights/schema.d.mts +258 -0
  251. package/dist/plugins/insights/schema.mjs +344 -0
  252. package/dist/storageAccess.cjs +0 -1
  253. package/dist/types/index.d.cts +2 -29
  254. package/dist/types/index.d.mts +2 -29
  255. package/package.json +30 -7
  256. package/src/adapters/drizzle.conformance.integration.spec.ts +34 -0
  257. package/src/adapters/drizzle.readBudgets.integration.spec.ts +41 -0
  258. package/src/adapters/drizzle.spec.ts +277 -208
  259. package/src/adapters/drizzle.ts +48 -128
  260. package/src/adapters/drizzleExecutor.ts +166 -0
  261. package/src/adapters/kysely.conformance.integration.spec.ts +36 -0
  262. package/src/adapters/kysely.readBudgets.integration.spec.ts +42 -0
  263. package/src/adapters/kysely.spec.ts +212 -117
  264. package/src/adapters/kysely.ts +32 -87
  265. package/src/adapters/kyselyExecutor.ts +53 -0
  266. package/src/adapters/mongodb.integration.spec.ts +180 -0
  267. package/src/adapters/mongodb.readBudgets.integration.spec.ts +61 -0
  268. package/src/adapters/mongodb.ts +36 -65
  269. package/src/adapters/mongodbAdapter.ts +293 -0
  270. package/src/adapters/prisma.conformance.integration.spec.ts +36 -0
  271. package/src/adapters/prisma.integration.spec.ts +138 -0
  272. package/src/adapters/prisma.readBudgets.integration.spec.ts +40 -0
  273. package/src/adapters/prisma.spec.ts +226 -173
  274. package/src/adapters/prisma.ts +60 -451
  275. package/src/adapters/prismaExecutor.ts +107 -0
  276. package/src/adapters/prismaTestClients.ts +175 -0
  277. package/src/adapters/sqlProviders.ts +14 -0
  278. package/src/apiKeys.integration.spec.ts +19 -119
  279. package/src/apiKeys.spec.ts +39 -35
  280. package/src/apiKeys.ts +2 -8
  281. package/src/assembly/assemblePlugins.ts +269 -0
  282. package/src/assembly/assembly.spec.ts +325 -0
  283. package/src/assembly/assembly.types.spec.ts +155 -0
  284. package/src/assembly/builtInRoutes.spec.ts +213 -0
  285. package/src/assembly/databasePlugins.spec.ts +71 -0
  286. package/src/assembly/databasePlugins.ts +96 -0
  287. package/src/core/api.ts +139 -0
  288. package/src/core/baseCandidates.spec.ts +378 -0
  289. package/src/core/baseCandidates.ts +136 -0
  290. package/src/core/index.ts +44 -0
  291. package/src/core/operations.spec.ts +415 -0
  292. package/src/core/operations.ts +551 -0
  293. package/src/core/reads.spec.ts +300 -0
  294. package/src/core/reads.ts +417 -0
  295. package/src/core/releases.spec.ts +308 -0
  296. package/src/core/releases.ts +345 -0
  297. package/src/core/schema.ts +173 -0
  298. package/src/core/writes.ts +160 -0
  299. package/src/createHotUpdaterCore.ts +191 -167
  300. package/src/database/cursor.ts +65 -0
  301. package/src/database/database.ts +335 -0
  302. package/src/database/database.types.spec.ts +135 -0
  303. package/src/database/definitions.ts +72 -0
  304. package/src/database/engine.ts +62 -0
  305. package/src/database/engineAggregates.spec.ts +539 -0
  306. package/src/database/engineAggregates.ts +193 -0
  307. package/src/database/engineReads.spec.ts +219 -0
  308. package/src/database/engineReads.ts +302 -0
  309. package/src/database/engineTransaction.spec.ts +710 -0
  310. package/src/database/engineTransaction.ts +588 -0
  311. package/src/database/errors.ts +30 -0
  312. package/src/database/fence.spec.ts +223 -0
  313. package/src/database/fence.ts +171 -0
  314. package/src/database/index.ts +154 -0
  315. package/src/database/kv/kvAdapter.conformance.integration.spec.ts +17 -0
  316. package/src/database/kv/kvAdapter.readBudgets.integration.spec.ts +17 -0
  317. package/src/database/kv/kvAdapter.spec.ts +468 -0
  318. package/src/database/kv/kvAdapter.ts +450 -0
  319. package/src/database/kv/kvTestStore.ts +91 -0
  320. package/src/database/memory.readBudgets.integration.spec.ts +13 -0
  321. package/src/database/resolveSchema.spec.ts +230 -0
  322. package/src/database/resolveSchema.ts +372 -0
  323. package/src/database/schema.ts +169 -0
  324. package/src/database/schema.types.spec.ts +94 -0
  325. package/src/database/sql/docker-compose.yml +36 -0
  326. package/src/database/sql/sqlAdapter.integration.spec.ts +148 -0
  327. package/src/database/sql/sqlAdapter.readBudgets.integration.spec.ts +109 -0
  328. package/src/database/sql/sqlAdapter.spec.ts +255 -0
  329. package/src/database/sql/sqlAdapter.ts +532 -0
  330. package/src/database/sql/sqlSchema.ts +205 -0
  331. package/src/database/sql/sqlTestExecutors.ts +183 -0
  332. package/src/databaseTestSuite.spec.ts +39 -0
  333. package/src/db/builtInDatabase.ts +149 -0
  334. package/src/db/bundleRows.spec.ts +3 -3
  335. package/src/db/createBundleDiff.spec.ts +43 -29
  336. package/src/db/createBundleDiff.ts +13 -7
  337. package/src/db/engineDrizzleSchema.ts +72 -0
  338. package/src/db/engineMigrator.ts +105 -0
  339. package/src/db/enginePrismaSchema.ts +147 -0
  340. package/src/db/engineSql.spec.ts +129 -0
  341. package/src/db/engineSql.ts +48 -0
  342. package/src/db/engineSqlMigrator.ts +116 -0
  343. package/src/db/fixedMigratorShared.ts +1 -20
  344. package/src/db/index.spec.ts +116 -824
  345. package/src/db/index.ts +43 -14
  346. package/src/db/pluginTables.spec.ts +218 -0
  347. package/src/db/releaseCatalog.ts +48 -90
  348. package/src/db/schemaSettings.ts +104 -0
  349. package/src/db/settingsMigrator.spec.ts +65 -0
  350. package/src/db/settingsMigrator.ts +152 -0
  351. package/src/db/types.ts +25 -165
  352. package/src/db/updateArtifacts.spec.ts +170 -294
  353. package/src/db/updateArtifacts.ts +74 -142
  354. package/src/db/updateCheck.bench.ts +47 -0
  355. package/src/handler-standalone.integration.spec.ts +204 -412
  356. package/src/handler.spec.ts +134 -51
  357. package/src/handler.testFixtures.ts +14 -19
  358. package/src/handler.ts +163 -75
  359. package/src/handlerAdminRoutes.spec.ts +183 -0
  360. package/src/handlerAdminRoutes.ts +536 -0
  361. package/src/handlerAuth.integration.spec.ts +3 -3
  362. package/src/handlerManagement.spec.ts +136 -196
  363. package/src/handlerReleaseCatalogRoutes.ts +15 -17
  364. package/src/handlerTypes.ts +3 -80
  365. package/src/handlerVersionRoutes.ts +20 -7
  366. package/src/index.ts +7 -14
  367. package/src/insights/domain.ts +56 -77
  368. package/src/insights/errors.spec.ts +48 -0
  369. package/src/insights/errors.ts +50 -6
  370. package/src/insights/eventInput.ts +80 -27
  371. package/src/insights/insights.integration.spec.ts +525 -44
  372. package/src/insights/provider.spec.ts +574 -0
  373. package/src/insights/provider.ts +667 -0
  374. package/src/insights/queryInput.ts +113 -73
  375. package/src/insights/routes.ts +125 -69
  376. package/src/insights/types.ts +47 -36
  377. package/src/lintRules.spec.ts +76 -0
  378. package/src/plugins/api-keys/apiKeysPlugin.spec.ts +172 -0
  379. package/src/plugins/api-keys/index.ts +66 -0
  380. package/src/plugins/api-keys/model.ts +69 -0
  381. package/src/plugins/api-keys/schema.ts +22 -0
  382. package/src/plugins/builtIn.ts +5 -0
  383. package/src/plugins/definePlugin.ts +100 -0
  384. package/src/plugins/index.ts +55 -0
  385. package/src/plugins/insights/index.ts +86 -0
  386. package/src/plugins/insights/insightsRollout.integration.spec.ts +187 -0
  387. package/src/plugins/insights/model.spec.ts +66 -0
  388. package/src/plugins/insights/model.ts +19 -0
  389. package/src/plugins/insights/reads.spec.ts +725 -0
  390. package/src/plugins/insights/reads.ts +707 -0
  391. package/src/plugins/insights/recordEvent.spec.ts +443 -0
  392. package/src/plugins/insights/recordEvent.ts +238 -0
  393. package/src/plugins/insights/schema.ts +229 -0
  394. package/src/plugins/pluginTestHarness.spec.ts +56 -0
  395. package/src/readBudgets.testFixtures.ts +15 -0
  396. package/src/releaseCatalogRoutes.integration.spec.ts +47 -92
  397. package/src/runtime.spec.ts +91 -77
  398. package/src/runtime.testFixtures.ts +28 -44
  399. package/src/runtimeBundles.integration.spec.ts +112 -0
  400. package/src/testUtilsMutation.integration.spec.ts +215 -0
  401. package/src/testUtilsPackage.integration.spec.ts +176 -0
  402. package/src/types/index.ts +0 -32
  403. package/dist/adapters/databaseConstraintErrors.cjs +0 -23
  404. package/dist/adapters/databaseConstraintErrors.mjs +0 -21
  405. package/dist/adapters/databasePluginUtils.cjs +0 -117
  406. package/dist/adapters/databasePluginUtils.mjs +0 -106
  407. package/dist/adapters/drizzleCrud.cjs +0 -250
  408. package/dist/adapters/drizzleCrud.mjs +0 -249
  409. package/dist/adapters/drizzleLazyDB.cjs +0 -101
  410. package/dist/adapters/drizzleLazyDB.mjs +0 -101
  411. package/dist/adapters/drizzleQuery.cjs +0 -68
  412. package/dist/adapters/drizzleQuery.mjs +0 -67
  413. package/dist/adapters/kyselyCrud.cjs +0 -254
  414. package/dist/adapters/kyselyCrud.mjs +0 -253
  415. package/dist/adapters/kyselyQuery.cjs +0 -56
  416. package/dist/adapters/kyselyQuery.mjs +0 -55
  417. package/dist/adapters/mongodbCollections.cjs +0 -36
  418. package/dist/adapters/mongodbCollections.mjs +0 -30
  419. package/dist/adapters/mongodbQuery.cjs +0 -77
  420. package/dist/adapters/mongodbQuery.mjs +0 -70
  421. package/dist/adapters/mongodbReads.cjs +0 -148
  422. package/dist/adapters/mongodbReads.mjs +0 -147
  423. package/dist/adapters/mongodbWrites.cjs +0 -134
  424. package/dist/adapters/mongodbWrites.mjs +0 -133
  425. package/dist/adapters/prismaQuery.cjs +0 -58
  426. package/dist/adapters/prismaQuery.mjs +0 -56
  427. package/dist/adapters/prismaRows.cjs +0 -198
  428. package/dist/adapters/prismaRows.mjs +0 -188
  429. package/dist/db/databasePluginCore.cjs +0 -138
  430. package/dist/db/databasePluginCore.mjs +0 -137
  431. package/dist/db/fixedMigrator.cjs +0 -79
  432. package/dist/db/fixedMigrator.mjs +0 -78
  433. package/dist/db/fixedMigratorMongo.cjs +0 -319
  434. package/dist/db/fixedMigratorMongo.mjs +0 -319
  435. package/dist/db/mongoMigrationExecution.cjs +0 -11
  436. package/dist/db/mongoMigrationExecution.mjs +0 -11
  437. package/dist/db/schema/mongodb.cjs +0 -25
  438. package/dist/db/schema/mongodb.mjs +0 -25
  439. package/dist/db/schema/registry.cjs +0 -21
  440. package/dist/db/schema/registry.mjs +0 -17
  441. package/dist/db/schema/sql.cjs +0 -101
  442. package/dist/db/schema/sql.mjs +0 -97
  443. package/dist/db/schema/sqlOperations.cjs +0 -27
  444. package/dist/db/schema/sqlOperations.mjs +0 -26
  445. package/dist/db/schemaGenerators.cjs +0 -256
  446. package/dist/db/schemaGenerators.mjs +0 -254
  447. package/dist/db/schemaReadiness.cjs +0 -24
  448. package/dist/db/schemaReadiness.d.cts +0 -8
  449. package/dist/db/schemaReadiness.d.mts +0 -8
  450. package/dist/db/schemaReadiness.mjs +0 -23
  451. package/dist/db/sqlMigrationExecution.cjs +0 -67
  452. package/dist/db/sqlMigrationExecution.mjs +0 -66
  453. package/dist/handlerBundleRoutes.cjs +0 -155
  454. package/dist/handlerBundleRoutes.mjs +0 -155
  455. package/dist/handlerReleaseManagementRoutes.cjs +0 -125
  456. package/dist/handlerReleaseManagementRoutes.mjs +0 -124
  457. package/dist/insights/bounded/activeOverview.cjs +0 -87
  458. package/dist/insights/bounded/activeOverview.mjs +0 -85
  459. package/dist/insights/bounded/installationSearch.cjs +0 -42
  460. package/dist/insights/bounded/installationSearch.mjs +0 -42
  461. package/dist/insights/bounded/persistence.cjs +0 -39
  462. package/dist/insights/bounded/persistence.mjs +0 -38
  463. package/dist/insights/bounded/provider.cjs +0 -170
  464. package/dist/insights/bounded/provider.d.cts +0 -7
  465. package/dist/insights/bounded/provider.d.mts +0 -7
  466. package/dist/insights/bounded/provider.mjs +0 -170
  467. package/dist/insights/bounded/scan.cjs +0 -144
  468. package/dist/insights/bounded/scan.mjs +0 -138
  469. package/dist/insights/persistence.d.cts +0 -6
  470. package/dist/insights/persistence.d.mts +0 -6
  471. package/dist/schema/dsl.cjs +0 -103
  472. package/dist/schema/dsl.mjs +0 -87
  473. package/dist/schema/index.cjs +0 -6
  474. package/dist/schema/index.mjs +0 -7
  475. package/dist/schema/settings.cjs +0 -9
  476. package/dist/schema/settings.mjs +0 -9
  477. package/dist/schema/types.cjs +0 -8
  478. package/dist/schema/types.mjs +0 -6
  479. package/dist/schema/v1_0_0.cjs +0 -364
  480. package/dist/schema/v1_0_0.mjs +0 -357
  481. package/src/adapters/databaseConstraintErrors.ts +0 -25
  482. package/src/adapters/databasePluginTestDatabase.ts +0 -106
  483. package/src/adapters/databasePluginUtils.spec.ts +0 -29
  484. package/src/adapters/databasePluginUtils.ts +0 -214
  485. package/src/adapters/drizzleCrud.ts +0 -419
  486. package/src/adapters/drizzleLazyDB.ts +0 -257
  487. package/src/adapters/drizzleQuery.ts +0 -164
  488. package/src/adapters/kyselyCrud.ts +0 -588
  489. package/src/adapters/kyselyQuery.ts +0 -128
  490. package/src/adapters/mongodb.spec.ts +0 -141
  491. package/src/adapters/mongodbCollections.ts +0 -62
  492. package/src/adapters/mongodbQuery.ts +0 -226
  493. package/src/adapters/mongodbReads.ts +0 -311
  494. package/src/adapters/mongodbRows.spec.ts +0 -64
  495. package/src/adapters/mongodbRows.ts +0 -118
  496. package/src/adapters/mongodbTestClient.ts +0 -342
  497. package/src/adapters/mongodbTestFilter.ts +0 -166
  498. package/src/adapters/mongodbWrites.ts +0 -260
  499. package/src/adapters/prismaQuery.ts +0 -129
  500. package/src/adapters/prismaRows.spec.ts +0 -98
  501. package/src/adapters/prismaRows.ts +0 -301
  502. package/src/adapters/prismaTestClient.ts +0 -396
  503. package/src/calculatePagination.ts +0 -34
  504. package/src/db/databasePluginCore.spec.ts +0 -62
  505. package/src/db/databasePluginCore.testFixtures.ts +0 -76
  506. package/src/db/databasePluginCore.ts +0 -185
  507. package/src/db/databasePluginUpdateCheck.bench.ts +0 -107
  508. package/src/db/fixedMigrator.spec.ts +0 -231
  509. package/src/db/fixedMigrator.ts +0 -147
  510. package/src/db/fixedMigratorMongo.spec.ts +0 -192
  511. package/src/db/fixedMigratorMongo.ts +0 -425
  512. package/src/db/hotUpdaterSchema.ts +0 -5
  513. package/src/db/mongoMigrationExecution.ts +0 -23
  514. package/src/db/schema/definitions.ts +0 -1
  515. package/src/db/schema/mongodb.ts +0 -40
  516. package/src/db/schema/registry.ts +0 -55
  517. package/src/db/schema/sql.ts +0 -241
  518. package/src/db/schema/sqlOperations.ts +0 -63
  519. package/src/db/schema/types.ts +0 -1
  520. package/src/db/schemaGenerators.ts +0 -466
  521. package/src/db/schemaReadiness.ts +0 -34
  522. package/src/db/sqlMigrationExecution.spec.ts +0 -65
  523. package/src/db/sqlMigrationExecution.ts +0 -108
  524. package/src/db/types.spec.ts +0 -55
  525. package/src/handlerBundleRoutes.ts +0 -259
  526. package/src/handlerReleaseManagementRoutes.ts +0 -213
  527. package/src/insights/bounded/activeOverview.spec.ts +0 -189
  528. package/src/insights/bounded/activeOverview.ts +0 -148
  529. package/src/insights/bounded/installationSearch.spec.ts +0 -130
  530. package/src/insights/bounded/installationSearch.ts +0 -69
  531. package/src/insights/bounded/persistence.ts +0 -43
  532. package/src/insights/bounded/provider.spec.ts +0 -219
  533. package/src/insights/bounded/provider.ts +0 -229
  534. package/src/insights/bounded/scan.ts +0 -235
  535. package/src/insights/persistence.ts +0 -10
  536. package/src/schema/dsl-all-versions.spec.ts +0 -35
  537. package/src/schema/dsl.ts +0 -187
  538. package/src/schema/index.ts +0 -10
  539. package/src/schema/settings.ts +0 -15
  540. package/src/schema/types.ts +0 -79
  541. package/src/schema/v1_0_0.spec.ts +0 -146
  542. package/src/schema/v1_0_0.ts +0 -465
@@ -0,0 +1,155 @@
1
+ import { describe, expectTypeOf, it } from "vitest";
2
+
3
+ import {
4
+ type ClientAccessPolicy,
5
+ type ClientAccessRule,
6
+ createHotUpdater,
7
+ type CreateHotUpdaterOptions,
8
+ type RemovedClientAccess,
9
+ } from "../createHotUpdaterCore";
10
+ import { defineTable } from "../database/schema";
11
+ import { definePlugin } from "../plugins/definePlugin";
12
+
13
+ const keys = definePlugin({
14
+ id: "keys",
15
+ provides: { clientAuth: true },
16
+ schemaVersion: "1",
17
+ schema: {},
18
+ init: () => ({
19
+ api: { ping: () => "pong" as const },
20
+ clientAuth: { varyHeaders: ["x-key"], authenticate: async () => true },
21
+ }),
22
+ });
23
+
24
+ const sso = definePlugin({
25
+ id: "sso",
26
+ provides: { clientAuth: true },
27
+ schemaVersion: "1",
28
+ schema: {},
29
+ init: () => ({
30
+ api: {},
31
+ clientAuth: { varyHeaders: [], authenticate: async () => true },
32
+ }),
33
+ });
34
+
35
+ const notes = definePlugin({
36
+ id: "notes",
37
+ schemaVersion: "1",
38
+ schema: {
39
+ notes: defineTable({ id: { type: "string" } }, { key: ["id"] }),
40
+ },
41
+ init: ({ db }) => ({
42
+ api: { read: (id: string) => db.findOne("notes", { id }) },
43
+ }),
44
+ });
45
+
46
+ type Database = CreateHotUpdaterOptions["database"];
47
+
48
+ /** The callback is type-checked and never runs. */
49
+ const typeOnly = (check: (database: Database) => void) => void check;
50
+
51
+ describe("createHotUpdater types", () => {
52
+ it("counts clientAuth plugins in a tuple and names the fix", () => {
53
+ expectTypeOf<ClientAccessRule<readonly []>>().toEqualTypeOf<{
54
+ readonly clientAccess: ClientAccessPolicy;
55
+ }>();
56
+ expectTypeOf<ClientAccessRule<readonly [typeof notes]>>().toEqualTypeOf<{
57
+ readonly clientAccess: ClientAccessPolicy;
58
+ }>();
59
+ expectTypeOf<ClientAccessRule<readonly [typeof keys]>>().toEqualTypeOf<{
60
+ readonly clientAccess?: 'Remove clientAccess: plugin "keys" provides clientAuth';
61
+ }>();
62
+ expectTypeOf<
63
+ ClientAccessRule<readonly [typeof keys, typeof notes, typeof sso]>
64
+ >().toEqualTypeOf<{
65
+ readonly clientAuth: 'Keep one clientAuth plugin: "keys", "sso" all provide it';
66
+ }>();
67
+ expectTypeOf<
68
+ ClientAccessRule<readonly (typeof keys | typeof notes)[]>
69
+ >().toEqualTypeOf<{
70
+ readonly clientAccess?: "Remove clientAccess: a plugin in this list may provide clientAuth";
71
+ }>();
72
+ });
73
+
74
+ it("accepts exactly one policy source", () => {
75
+ typeOnly((database) => {
76
+ createHotUpdater({ database, plugins: [notes, keys] });
77
+ createHotUpdater({ database, plugins: [notes], clientAccess: "public" });
78
+ createHotUpdater({ database, clientAccess: "public" });
79
+ // @ts-expect-error Neither a clientAuth plugin nor "public".
80
+ createHotUpdater({ database, plugins: [notes] });
81
+ createHotUpdater({
82
+ database,
83
+ plugins: [keys],
84
+ // @ts-expect-error clientAuth and "public" together.
85
+ clientAccess: "public",
86
+ });
87
+ // @ts-expect-error Two plugins provide clientAuth.
88
+ createHotUpdater({ database, plugins: [keys, sso] });
89
+ });
90
+ });
91
+
92
+ it("names apiKeys() where a clientAccess object from before 1.0 is written", () => {
93
+ expectTypeOf<ClientAccessPolicy>().toEqualTypeOf<
94
+ "public" | RemovedClientAccess
95
+ >();
96
+ expectTypeOf<
97
+ RemovedClientAccess["type"]
98
+ >().toEqualTypeOf<'clientAccess objects were removed in 1.0: set clientAccess: "public", or add apiKeys() from @hot-updater/server/plugins/api-keys to plugins'>();
99
+ typeOnly((database) => {
100
+ // @ts-expect-error clientAccess objects were removed in 1.0.
101
+ createHotUpdater({ database, clientAccess: { type: "public" } });
102
+ createHotUpdater({
103
+ database,
104
+ // @ts-expect-error clientAccess objects were removed in 1.0.
105
+ clientAccess: { type: "api-key", headerName: "x-client-key" },
106
+ });
107
+ });
108
+ });
109
+
110
+ it("rejects core passed as a plugin and a clientAuth the plugin did not declare", () => {
111
+ const core = {
112
+ kind: "core",
113
+ id: "core",
114
+ schemaVersion: "1",
115
+ schema: {},
116
+ init: () => ({ api: {} }),
117
+ } as const;
118
+ typeOnly((database) => {
119
+ createHotUpdater({
120
+ database,
121
+ // @ts-expect-error Core is built in; it is not a plugin.
122
+ plugins: [core],
123
+ });
124
+ });
125
+ definePlugin({
126
+ id: "sneaky",
127
+ schemaVersion: "1",
128
+ schema: {},
129
+ init: () => ({
130
+ api: {},
131
+ // @ts-expect-error Declare provides: { clientAuth: true } to return clientAuth.
132
+ clientAuth: { varyHeaders: [], authenticate: async () => true },
133
+ }),
134
+ });
135
+ definePlugin({
136
+ id: "promised",
137
+ provides: { clientAuth: true },
138
+ schemaVersion: "1",
139
+ schema: {},
140
+ // @ts-expect-error A plugin that provides clientAuth must return it.
141
+ init: () => ({ api: {} }),
142
+ });
143
+ });
144
+
145
+ it("types each plugin's API by id", () => {
146
+ type Api = ReturnType<
147
+ typeof createHotUpdater<readonly [typeof keys, typeof notes]>
148
+ >["api"];
149
+ expectTypeOf<keyof Api>().toEqualTypeOf<"keys" | "notes">();
150
+ expectTypeOf<ReturnType<Api["keys"]["ping"]>>().toEqualTypeOf<"pong">();
151
+ expectTypeOf<Parameters<Api["notes"]["read"]>>().toEqualTypeOf<
152
+ [id: string]
153
+ >();
154
+ });
155
+ });
@@ -0,0 +1,213 @@
1
+ import { createMemoryAdapter } from "@hot-updater/plugin-core/internal";
2
+ import { afterEach, describe, expect, it, vi } from "vitest";
3
+
4
+ import { createHotUpdater } from "../createHotUpdaterCore";
5
+ import { type HotUpdaterHandlers, listHotUpdaterRoutes } from "../handler";
6
+ import { INSIGHTS_OFF_WARNING, INSIGHTS_ROUTES } from "../insights/routes";
7
+ import { apiKeys } from "../plugins/api-keys";
8
+ import { definePlugin } from "../plugins/definePlugin";
9
+ import { insights } from "../plugins/insights";
10
+ import { HotUpdaterConfigError } from "./assemblePlugins";
11
+
12
+ const database = () => ({ name: "memory", adapter: createMemoryAdapter() });
13
+
14
+ const event = {
15
+ appVersion: "1.0.0",
16
+ channel: "production",
17
+ cohort: "default",
18
+ fingerprintHash: null,
19
+ fromBundleId: null,
20
+ fromReleaseId: null,
21
+ installId: "install-1",
22
+ platform: "ios",
23
+ toBundleId: "bundle-1",
24
+ toReleaseId: null,
25
+ type: "UNCHANGED",
26
+ updateStrategy: null,
27
+ userId: "user-1",
28
+ username: "Jane",
29
+ sdkVersion: "2.0.0",
30
+ } as const;
31
+
32
+ const request = (path: string, init: RequestInit = {}) =>
33
+ new Request(`https://updates.example.com${path}`, init);
34
+
35
+ const insightsRoutes = INSIGHTS_ROUTES.map(({ method, path, access }) => ({
36
+ method,
37
+ path,
38
+ access,
39
+ }));
40
+
41
+ describe("Insights routes with plugins", () => {
42
+ afterEach(() => {
43
+ vi.restoreAllMocks();
44
+ });
45
+
46
+ it("come from the insights plugin when plugins hold it", async () => {
47
+ const warn = vi.spyOn(console, "warn").mockImplementation(() => {});
48
+ const hotUpdater = createHotUpdater({
49
+ database: database(),
50
+ plugins: [insights()],
51
+ clientAccess: "public",
52
+ });
53
+
54
+ const ingested = await hotUpdater.handlers.client(
55
+ request("/events", {
56
+ method: "POST",
57
+ headers: { "content-type": "application/json" },
58
+ body: JSON.stringify(event),
59
+ }),
60
+ );
61
+ expect(ingested.status).toBe(204);
62
+ expect(ingested.headers.get("x-hot-updater-insights")).toBeNull();
63
+ const installation = await hotUpdater.handlers.admin(
64
+ request("/installations/install-1"),
65
+ );
66
+ await expect(installation.json()).resolves.toMatchObject({
67
+ latestStatus: "UNCHANGED",
68
+ lastKnownBundleId: "bundle-1",
69
+ });
70
+ expect(listHotUpdaterRoutes(hotUpdater.handlers)).toEqual(
71
+ expect.arrayContaining(insightsRoutes),
72
+ );
73
+ expect(warn).not.toHaveBeenCalled();
74
+ });
75
+
76
+ it("answer 204 with x-hot-updater-insights: disabled when plugins leave it out", async () => {
77
+ const warn = vi.spyOn(console, "warn").mockImplementation(() => {});
78
+ const hotUpdater = createHotUpdater({
79
+ database: database(),
80
+ plugins: [],
81
+ clientAccess: "public",
82
+ });
83
+
84
+ for (const { access, method, path } of INSIGHTS_ROUTES) {
85
+ const response = await hotUpdater.handlers[access](
86
+ request(path.replace(":installId", "install-1"), {
87
+ method,
88
+ ...(method === "POST" ? { body: JSON.stringify(event) } : {}),
89
+ }),
90
+ );
91
+ expect(response.status, `${method} ${path}`).toBe(204);
92
+ expect(response.headers.get("x-hot-updater-insights")).toBe("disabled");
93
+ expect(response.headers.get("cache-control")).toBe("private, no-store");
94
+ }
95
+ expect(listHotUpdaterRoutes(hotUpdater.handlers)).toEqual(
96
+ expect.arrayContaining(insightsRoutes),
97
+ );
98
+ expect(warn).toHaveBeenCalledOnce();
99
+ expect(warn).toHaveBeenCalledWith(INSIGHTS_OFF_WARNING);
100
+ });
101
+
102
+ it("warn once per server, on the first event dropped without insights()", async () => {
103
+ const warn = vi.spyOn(console, "warn").mockImplementation(() => {});
104
+ const hotUpdater = createHotUpdater({
105
+ database: database(),
106
+ clientAccess: "public",
107
+ });
108
+ const report = () =>
109
+ hotUpdater.handlers.client(
110
+ request("/events", { method: "POST", body: JSON.stringify(event) }),
111
+ );
112
+
113
+ expect(warn).not.toHaveBeenCalled();
114
+ expect((await report()).status).toBe(204);
115
+ expect((await report()).status).toBe(204);
116
+ expect(warn).toHaveBeenCalledOnce();
117
+ expect(warn).toHaveBeenCalledWith(
118
+ expect.stringContaining(
119
+ "Add insights() from @hot-updater/server/plugins/insights to plugins",
120
+ ),
121
+ );
122
+ });
123
+ });
124
+
125
+ describe("admin /version", () => {
126
+ const plugins = async (hotUpdater: { handlers: HotUpdaterHandlers }) =>
127
+ (
128
+ (await (await hotUpdater.handlers.admin(request("/version"))).json()) as {
129
+ plugins: unknown;
130
+ }
131
+ ).plugins;
132
+
133
+ it("lists the built-in plugins the server runs, sorted by id", async () => {
134
+ await expect(
135
+ plugins(
136
+ createHotUpdater({
137
+ database: database(),
138
+ plugins: [insights(), apiKeys()],
139
+ }),
140
+ ),
141
+ ).resolves.toEqual(["apiKeys", "insights"]);
142
+ await expect(
143
+ plugins(
144
+ createHotUpdater({
145
+ database: database(),
146
+ plugins: [insights()],
147
+ clientAccess: "public",
148
+ }),
149
+ ),
150
+ ).resolves.toEqual(["insights"]);
151
+ });
152
+
153
+ it("lists none for a server without plugins, whose Insights routes still say it is off", async () => {
154
+ const hotUpdater = createHotUpdater({
155
+ database: database(),
156
+ clientAccess: "public",
157
+ });
158
+
159
+ await expect(plugins(hotUpdater)).resolves.toEqual([]);
160
+ const events = await hotUpdater.handlers.admin(request("/events"));
161
+ expect(events.status).toBe(204);
162
+ expect(events.headers.get("x-hot-updater-insights")).toBe("disabled");
163
+ });
164
+ });
165
+
166
+ describe("core reads", () => {
167
+ it("reads core through hotUpdater.core and a plugin's ctx.core", async () => {
168
+ const channels = definePlugin({
169
+ id: "channel_names",
170
+ schemaVersion: "1",
171
+ schema: {},
172
+ init: ({ core }) => ({
173
+ api: {
174
+ names: async () =>
175
+ (await core.listChannels()).map((channel) => channel.name),
176
+ },
177
+ }),
178
+ });
179
+ const hotUpdater = createHotUpdater({
180
+ database: database(),
181
+ plugins: [channels],
182
+ clientAccess: "public",
183
+ });
184
+ const channel = await hotUpdater.core.ensureChannel("production");
185
+
186
+ await expect(
187
+ hotUpdater.core.findChannelByName("production"),
188
+ ).resolves.toEqual(channel);
189
+ await expect(hotUpdater.api.channel_names.names()).resolves.toEqual([
190
+ "production",
191
+ ]);
192
+ });
193
+
194
+ it('keeps the plugin id "core" for core', () => {
195
+ const impostor = definePlugin({
196
+ id: "core",
197
+ schemaVersion: "1",
198
+ schema: {},
199
+ init: () => ({ api: {} }),
200
+ });
201
+ const start = () =>
202
+ createHotUpdater({
203
+ database: database(),
204
+ plugins: [impostor],
205
+ clientAccess: "public",
206
+ });
207
+
208
+ expect(start).toThrow(HotUpdaterConfigError);
209
+ expect(start).toThrow(
210
+ 'plugins[0] uses the id "core", which is core\'s own.',
211
+ );
212
+ });
213
+ });
@@ -0,0 +1,71 @@
1
+ import { createMemoryAdapter } from "@hot-updater/plugin-core/internal";
2
+ import { describe, expect, it } from "vitest";
3
+
4
+ import { apiKeys } from "../plugins/api-keys";
5
+ import { insights } from "../plugins/insights";
6
+ import { HotUpdaterConfigError } from "./assemblePlugins";
7
+ import {
8
+ createDatabasePluginApis,
9
+ createMeasuredDatabase,
10
+ } from "./databasePlugins";
11
+
12
+ describe("createDatabasePluginApis", () => {
13
+ it("assembles the listed plugins over the database's engine, on the server's tables", async () => {
14
+ const database = { name: "memory", adapter: createMemoryAdapter() };
15
+
16
+ const api = createDatabasePluginApis(database, [insights(), apiKeys()]);
17
+ const created = await api.apiKeys.create({ name: "Console" });
18
+
19
+ expect(Object.keys(api).sort()).toEqual(["apiKeys", "insights"]);
20
+ // Another assembly over the same database reads the same table.
21
+ await expect(
22
+ createDatabasePluginApis(database, [apiKeys()]).apiKeys.list(),
23
+ ).resolves.toEqual([expect.objectContaining({ id: created.record.id })]);
24
+ });
25
+
26
+ it("gives no APIs for an empty plugin list", () => {
27
+ const database = { name: "memory", adapter: createMemoryAdapter() };
28
+
29
+ expect(createDatabasePluginApis(database, [])).toEqual({});
30
+ });
31
+
32
+ it("refuses a database off the storage engine, and a malformed list", () => {
33
+ expect(() =>
34
+ createDatabasePluginApis({ name: "old", models: {} }, [insights()]),
35
+ ).toThrow("Upgrade its provider package to 1.0.");
36
+ expect(() =>
37
+ createDatabasePluginApis(
38
+ { name: "memory", adapter: createMemoryAdapter() },
39
+ [insights(), insights()],
40
+ ),
41
+ ).toThrow(HotUpdaterConfigError);
42
+ });
43
+ });
44
+
45
+ describe("createMeasuredDatabase", () => {
46
+ it("runs core and the plugins on one engine in verify mode, over the adapter as given", async () => {
47
+ // A bare adapter without settings rows, which the schema fence would refuse.
48
+ const { core, api, clientAuth, measureReads } = createMeasuredDatabase(
49
+ createMemoryAdapter(),
50
+ [insights(), apiKeys()],
51
+ );
52
+ const { apiKey } = await api.apiKeys.create({ name: "Console" });
53
+ await core.ensureChannel("production");
54
+
55
+ const measured = await measureReads(async () => ({
56
+ authenticated: await clientAuth!.authenticate(
57
+ new Headers({ "x-api-key": apiKey }),
58
+ ),
59
+ channel: await core.findChannelByName("production"),
60
+ }));
61
+
62
+ expect(measured).toEqual({
63
+ result: {
64
+ authenticated: true,
65
+ channel: { id: expect.any(String), name: "production" },
66
+ },
67
+ adapter: { gets: 0, keys: 0, queries: 2, rows: 2 },
68
+ engine: { calls: 2, rows: 2 },
69
+ });
70
+ });
71
+ });
@@ -0,0 +1,96 @@
1
+ import type { DatabaseAdapter } from "@hot-updater/plugin-core/internal";
2
+
3
+ import {
4
+ engineAdapterOf,
5
+ OFF_ENGINE_DATABASE,
6
+ type CoreApi,
7
+ } from "../core/api";
8
+ import type { CoreStorage } from "../core/reads";
9
+ import type { ReadMeasurement } from "../database/engine";
10
+ import type {
11
+ AnyHotUpdaterPlugin,
12
+ ClientAuth,
13
+ PluginApis,
14
+ } from "../plugins/definePlugin";
15
+ import { assemblePlugins } from "./assemblePlugins";
16
+
17
+ /**
18
+ * The plugins' APIs by plugin id over a configured database, assembled as
19
+ * `createHotUpdater` assembles them: how the console runs Insights and API
20
+ * keys in process, and how init provisions a key, on the tables the server
21
+ * uses. A database off the storage engine, `standaloneRepository` included,
22
+ * is refused: its server runs the plugins.
23
+ */
24
+ export function createDatabasePluginApis<
25
+ const TPlugins extends readonly AnyHotUpdaterPlugin[],
26
+ >(
27
+ database: unknown,
28
+ plugins: TPlugins,
29
+ options?: { readonly now?: () => number },
30
+ ): PluginApis<TPlugins>;
31
+ export function createDatabasePluginApis(
32
+ database: unknown,
33
+ plugins: readonly unknown[],
34
+ options?: { readonly now?: () => number },
35
+ ): Readonly<Record<string, unknown>>;
36
+ export function createDatabasePluginApis(
37
+ database: unknown,
38
+ plugins: readonly unknown[],
39
+ options: { readonly now?: () => number } = {},
40
+ ): Readonly<Record<string, unknown>> {
41
+ const adapter = engineAdapterOf(database);
42
+ if (adapter === undefined) throw new Error(OFF_ENGINE_DATABASE);
43
+ return assemblePlugins(plugins, adapter, options).api;
44
+ }
45
+
46
+ export interface MeasuredDatabaseOptions {
47
+ readonly now?: () => number;
48
+ /** How core reads bundle manifests and resolves file URLs, for artifact resolution. */
49
+ readonly storage?: CoreStorage;
50
+ }
51
+
52
+ /** Core and the plugins' APIs on one engine in verify mode, and its read meter. */
53
+ export interface MeasuredDatabase<TApi = Readonly<Record<string, unknown>>> {
54
+ readonly core: CoreApi;
55
+ readonly api: TApi;
56
+ /** The client-route policy, when a plugin provides one. */
57
+ readonly clientAuth?: ClientAuth;
58
+ /** Runs `read` and reports what it read at both boundaries. */
59
+ measureReads<T>(read: () => Promise<T>): Promise<ReadMeasurement<T>>;
60
+ }
61
+
62
+ /**
63
+ * Core and the plugins over a storage adapter, assembled as
64
+ * `createHotUpdater` assembles them but on an engine in verify mode, with
65
+ * that engine's `measureReads`: what read-budget suites measure. The adapter
66
+ * runs as given, without the schema fence.
67
+ */
68
+ export function createMeasuredDatabase<
69
+ const TPlugins extends readonly AnyHotUpdaterPlugin[],
70
+ >(
71
+ adapter: DatabaseAdapter,
72
+ plugins: TPlugins,
73
+ options?: MeasuredDatabaseOptions,
74
+ ): MeasuredDatabase<PluginApis<TPlugins>>;
75
+ export function createMeasuredDatabase(
76
+ adapter: DatabaseAdapter,
77
+ plugins: readonly unknown[],
78
+ options?: MeasuredDatabaseOptions,
79
+ ): MeasuredDatabase;
80
+ export function createMeasuredDatabase(
81
+ adapter: DatabaseAdapter,
82
+ plugins: readonly unknown[],
83
+ options: MeasuredDatabaseOptions = {},
84
+ ): MeasuredDatabase {
85
+ const { core, api, clientAuth, measureReads } = assemblePlugins(
86
+ plugins,
87
+ adapter,
88
+ { ...options, verify: true },
89
+ );
90
+ return {
91
+ core,
92
+ api,
93
+ ...(clientAuth === undefined ? {} : { clientAuth }),
94
+ measureReads: measureReads!,
95
+ };
96
+ }
@@ -0,0 +1,139 @@
1
+ import type {
2
+ EngineDatabase,
3
+ HotUpdaterCoreApi,
4
+ } from "@hot-updater/plugin-core";
5
+ import type { DatabaseAdapter } from "@hot-updater/plugin-core/internal";
6
+
7
+ import { createDatabaseEngine } from "../database/database";
8
+ import { resolveSchema } from "../database/resolveSchema";
9
+ import { createCoreOperations } from "./operations";
10
+ import { createCoreReads, type CoreDatabase, type CoreStorage } from "./reads";
11
+ import { coreModule } from "./schema";
12
+
13
+ export interface CoreApiOptions {
14
+ readonly now?: () => number;
15
+ /** The database's CDN purge, called after a write that changes a Release Catalog. */
16
+ readonly onCachedRoutesChange?: () => Promise<void>;
17
+ }
18
+
19
+ /**
20
+ * The update check answers from one Release Catalog row, so a transaction
21
+ * changes what the cacheable client routes answer only when it writes one.
22
+ * The purge runs once, after the attempt that commits.
23
+ */
24
+ const purgingCachedRoutes = (
25
+ db: CoreDatabase,
26
+ onCachedRoutesChange: (() => Promise<void>) | undefined,
27
+ ): CoreDatabase => {
28
+ if (onCachedRoutesChange === undefined) return db;
29
+ return {
30
+ ...db,
31
+ async transaction(fn) {
32
+ let changed = false;
33
+ const result = await db.transaction((tx) => {
34
+ changed = false;
35
+ return fn({
36
+ ...tx,
37
+ create: (model, row) => {
38
+ changed ||= model === "release_catalogs";
39
+ tx.create(model, row);
40
+ },
41
+ update: (model, row, set) => {
42
+ changed ||= model === "release_catalogs";
43
+ tx.update(model, row, set);
44
+ },
45
+ delete: (model, row) => {
46
+ changed ||= model === "release_catalogs";
47
+ return tx.delete(model, row);
48
+ },
49
+ });
50
+ });
51
+ if (changed) await onCachedRoutesChange();
52
+ return result;
53
+ },
54
+ };
55
+ };
56
+
57
+ /** Core's reads and typed writes over one database handle. */
58
+ export const createCoreApi = (
59
+ db: CoreDatabase,
60
+ storage: CoreStorage,
61
+ options: CoreApiOptions = {},
62
+ ) => {
63
+ const reads = createCoreReads(db, storage);
64
+ return {
65
+ ...reads,
66
+ ...createCoreOperations(
67
+ purgingCachedRoutes(db, options.onCachedRoutesChange),
68
+ options,
69
+ ),
70
+ /** One read, which checks the schema settings first. */
71
+ ready: async (): Promise<void> => {
72
+ await reads.listReleaseCatalogs({ limit: 1 });
73
+ },
74
+ };
75
+ };
76
+
77
+ export type CoreApi = ReturnType<typeof createCoreApi>;
78
+
79
+ /**
80
+ * Core's API in process, on a database's storage adapter: how the CLI reads
81
+ * and writes a database that runs on the storage engine.
82
+ */
83
+ export const createInProcessCoreApi = (
84
+ adapter: DatabaseAdapter,
85
+ options: CoreApiOptions = {},
86
+ ): CoreApi =>
87
+ createCoreApi(
88
+ createDatabaseEngine({
89
+ adapter,
90
+ schema: resolveSchema([coreModule]),
91
+ }).database(coreModule),
92
+ { resolveFileUrl: async () => null },
93
+ options,
94
+ );
95
+
96
+ const isRecord = (value: unknown): value is Record<string, unknown> =>
97
+ typeof value === "object" && value !== null;
98
+
99
+ const isAdapter = (value: unknown): value is DatabaseAdapter =>
100
+ isRecord(value) &&
101
+ ["fits", "get", "query", "write"].every(
102
+ (method) => typeof value[method] === "function",
103
+ );
104
+
105
+ /** The storage adapter a configured database runs on, if it is on the engine. */
106
+ export const engineAdapterOf = (
107
+ database: unknown,
108
+ ): DatabaseAdapter | undefined =>
109
+ isRecord(database) && isAdapter(database.adapter)
110
+ ? database.adapter
111
+ : isAdapter(database)
112
+ ? database
113
+ : undefined;
114
+
115
+ export const OFF_ENGINE_DATABASE =
116
+ "This database does not run on Hot Updater's storage engine. Upgrade its provider package to 1.0.";
117
+
118
+ /**
119
+ * Core's API for a configured database, as the CLI uses it: a self-hosted
120
+ * server's admin API when the database is `standaloneRepository`, or the
121
+ * database's own storage adapter, in process.
122
+ */
123
+ export const createDatabaseCoreApi = (
124
+ database: unknown,
125
+ options: { readonly now?: () => number } = {},
126
+ ): HotUpdaterCoreApi => {
127
+ if (isRecord(database) && isRecord(database.core)) {
128
+ return database.core as unknown as HotUpdaterCoreApi;
129
+ }
130
+ const adapter = engineAdapterOf(database);
131
+ if (adapter === undefined) throw new Error(OFF_ENGINE_DATABASE);
132
+ const engineDatabase = database as Partial<EngineDatabase>;
133
+ return createInProcessCoreApi(adapter, {
134
+ ...options,
135
+ ...(typeof engineDatabase.onCachedRoutesChange === "function"
136
+ ? { onCachedRoutesChange: () => engineDatabase.onCachedRoutesChange!() }
137
+ : {}),
138
+ });
139
+ };