@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,539 @@
1
+ import {
2
+ addInsightsDistinct,
3
+ countInsightsDistinct,
4
+ createMemoryAdapter,
5
+ type DatabaseAdapter,
6
+ type WriteOp,
7
+ type WriteResult,
8
+ } from "@hot-updater/plugin-core/internal";
9
+ import {
10
+ runContentionHarness,
11
+ withAdapterLatency,
12
+ } from "@hot-updater/test-utils";
13
+ import { describe, expect, it } from "vitest";
14
+
15
+ import { createDatabaseEngine } from "./database";
16
+ import { shardOf } from "./engineAggregates";
17
+ import { DatabaseQueryError } from "./engineReads";
18
+ import type { RetryOptions } from "./engineTransaction";
19
+ import { DatabaseTransactionError } from "./errors";
20
+ import { resolveSchema } from "./resolveSchema";
21
+ import { defineAggregate, defineTable } from "./schema";
22
+
23
+ const installs = defineTable(
24
+ {
25
+ id: { type: "string", maxLength: 64 },
26
+ release: { type: "string", maxLength: 16 },
27
+ },
28
+ { key: ["id"] },
29
+ );
30
+
31
+ const distribution = defineAggregate(
32
+ { release: { type: "string", maxLength: 16 }, bucket: { type: "integer" } },
33
+ {
34
+ key: ["release", "bucket"],
35
+ gauges: ["installations"],
36
+ shards: 64,
37
+ indexes: { byRelease: { eq: ["release"], sort: ["bucket"] } },
38
+ },
39
+ );
40
+
41
+ const overview = defineAggregate(
42
+ { bucket: { type: "integer" } },
43
+ {
44
+ key: ["bucket"],
45
+ counters: ["events", "failures"],
46
+ shards: 4,
47
+ indexes: { all: { eq: [], sort: ["bucket"] } },
48
+ },
49
+ );
50
+
51
+ const users = defineAggregate(
52
+ { bucket: { type: "integer" } },
53
+ {
54
+ key: ["bucket"],
55
+ distinct: ["users"],
56
+ shards: 64,
57
+ indexes: { all: { eq: [], sort: ["bucket"] } },
58
+ },
59
+ );
60
+
61
+ const totals = defineAggregate(
62
+ { scope: { type: "string", maxLength: 16 } },
63
+ {
64
+ key: ["scope"],
65
+ counters: ["hits"],
66
+ gauges: ["open"],
67
+ indexes: { all: { eq: [], sort: ["scope"] } },
68
+ },
69
+ );
70
+
71
+ const module = {
72
+ id: "stats",
73
+ schema: { installs, distribution, overview, users, totals },
74
+ } as const;
75
+ const schema = resolveSchema([module]);
76
+ const table = (name: string) => schema.models.get(name)!.table;
77
+
78
+ const setup = async (
79
+ options: { readonly retry?: RetryOptions; readonly latencyMs?: number } = {},
80
+ ) => {
81
+ const memory = createMemoryAdapter();
82
+ await memory.migrations?.apply(schema.tables);
83
+ const faults: { inject?: () => WriteResult | undefined } = {};
84
+ const writes: (readonly WriteOp[])[] = [];
85
+ const retries = { rerun: 0, resend: 0 };
86
+ const faulty: DatabaseAdapter = {
87
+ ...memory,
88
+ async write(ops) {
89
+ writes.push(ops);
90
+ return faults.inject?.() ?? memory.write(ops);
91
+ },
92
+ };
93
+ const engine = createDatabaseEngine({
94
+ adapter: options.latencyMs
95
+ ? withAdapterLatency(faulty, options.latencyMs)
96
+ : faulty,
97
+ schema,
98
+ verify: true,
99
+ retry: {
100
+ attempts: 8,
101
+ baseDelayMs: 0,
102
+ maxDelayMs: 1,
103
+ onRetry: (kind) => {
104
+ retries[kind] += 1;
105
+ },
106
+ ...options.retry,
107
+ },
108
+ });
109
+ return { memory, faults, writes, retries, db: engine.database(module) };
110
+ };
111
+
112
+ const failOnce = (failedOp: number) => {
113
+ let used = false;
114
+ return (): WriteResult | undefined => {
115
+ if (used) return undefined;
116
+ used = true;
117
+ return { ok: false, failedOp };
118
+ };
119
+ };
120
+
121
+ const sketchOf = (...ids: string[]) =>
122
+ ids.reduce<string | null>(
123
+ (sketch, id) => addInsightsDistinct(sketch, id),
124
+ null,
125
+ )!;
126
+
127
+ describe("engine aggregates", () => {
128
+ it("keeps shards on a stable FNV-1a hash", () => {
129
+ expect(shardOf("a", 2 ** 32)).toBe(0xe40c292c);
130
+ expect(shardOf("foobar", 2 ** 32)).toBe(0xbf9cf968);
131
+ expect(shardOf("install-1", 64)).toBe(50);
132
+ });
133
+
134
+ it("counts with blind increments that create the row, one op per shard row", async () => {
135
+ const { db, writes, memory } = await setup();
136
+ await db.transaction(async (tx) => {
137
+ tx.aggregate("overview", { bucket: 1 }, { events: 2 }, { shardBy: "a" });
138
+ tx.aggregate(
139
+ "overview",
140
+ { bucket: 1 },
141
+ { events: 1, failures: 1 },
142
+ { shardBy: "a" },
143
+ );
144
+ });
145
+ const key = [1, shardOf("a", 4)];
146
+ expect(writes).toEqual([
147
+ [
148
+ expect.objectContaining({
149
+ type: "increment",
150
+ key,
151
+ by: { events: 3, failures: 1 },
152
+ }),
153
+ ],
154
+ ]);
155
+ expect(writes[0]![0]).not.toHaveProperty("guard");
156
+ await db.transaction(async (tx) => {
157
+ tx.aggregate("overview", { bucket: 1 }, { events: 4 }, { shardBy: "a" });
158
+ tx.aggregate("overview", { bucket: 1 }, { events: 5 }, { shardBy: "b" });
159
+ });
160
+ const [row] = await memory.get(table("overview"), [key]);
161
+ expect(row).toMatchObject({ events: 7, failures: 1, _v: 2 });
162
+ await expect(
163
+ db.findAggregates("overview", { index: "all", where: {}, limit: 10 }),
164
+ ).resolves.toEqual({ rows: [{ bucket: 1, events: 12, failures: 1 }] });
165
+ });
166
+
167
+ it("reads, merges, and writes back gauges per shard, deleting a row at zero", async () => {
168
+ const { db, writes } = await setup();
169
+ const change = (id: string, release: string, installations: number) =>
170
+ db.transaction(async (tx) => {
171
+ tx.aggregate(
172
+ "distribution",
173
+ { release, bucket: 1 },
174
+ { installations },
175
+ { shardBy: id },
176
+ );
177
+ });
178
+ await change("i1", "A", 1);
179
+ await change("i2", "A", 1);
180
+ await change("i1", "A", -1);
181
+ expect(writes.map((ops) => ops.map(({ type }) => type))).toEqual([
182
+ ["insert"],
183
+ ["insert"],
184
+ ["delete"],
185
+ ]);
186
+ await expect(
187
+ db.findAggregates("distribution", {
188
+ index: "byRelease",
189
+ where: { release: "A" },
190
+ limit: 64,
191
+ }),
192
+ ).resolves.toEqual({
193
+ rows: [{ release: "A", bucket: 1, installations: 1 }],
194
+ });
195
+
196
+ await expect(change("i1", "A", -1)).rejects.toThrow("a gauge went below 0");
197
+ await expect(
198
+ db.transaction(async (tx) => {
199
+ tx.aggregate(
200
+ "distribution",
201
+ { release: "A", bucket: 1 },
202
+ { installations: 1 },
203
+ );
204
+ }),
205
+ ).rejects.toThrow("gauges of a sharded aggregate need shardBy");
206
+ });
207
+
208
+ it("reruns when another writer moved a gauge after this transaction read its head", async () => {
209
+ const memory = createMemoryAdapter();
210
+ await memory.migrations?.apply(schema.tables);
211
+ const gauge = table("distribution");
212
+ let hold: Promise<void> | undefined;
213
+ const adapter: DatabaseAdapter = {
214
+ ...memory,
215
+ async get(physical, keys) {
216
+ if (physical.name === gauge.name && hold !== undefined) {
217
+ const wait = hold;
218
+ hold = undefined;
219
+ await wait;
220
+ }
221
+ return memory.get(physical, keys);
222
+ },
223
+ };
224
+ let reruns = 0;
225
+ const db = createDatabaseEngine({
226
+ adapter,
227
+ schema,
228
+ retry: {
229
+ baseDelayMs: 0,
230
+ maxDelayMs: 1,
231
+ onRetry: (kind) => {
232
+ if (kind === "rerun") reruns += 1;
233
+ },
234
+ },
235
+ }).database(module);
236
+ const move = (release: string) =>
237
+ db.transaction(async (tx) => {
238
+ const head = await tx.findOne("installs", { id: "i1" });
239
+ if (head === null) {
240
+ tx.create("installs", { id: "i1", release });
241
+ } else {
242
+ tx.update("installs", head, { release });
243
+ tx.aggregate(
244
+ "distribution",
245
+ { release: head.release, bucket: 1 },
246
+ { installations: -1 },
247
+ { shardBy: "i1" },
248
+ );
249
+ }
250
+ tx.aggregate(
251
+ "distribution",
252
+ { release, bucket: 1 },
253
+ { installations: 1 },
254
+ { shardBy: "i1" },
255
+ );
256
+ });
257
+ await move("A");
258
+ let open!: () => void;
259
+ hold = new Promise((resolve) => {
260
+ open = resolve;
261
+ });
262
+ // Reads head A, then waits before reading the gauges it moves.
263
+ const late = move("C");
264
+ // Moves A to B meanwhile, so A's gauge is already at zero.
265
+ await move("B");
266
+ open();
267
+ await late;
268
+ const installations = async (release: string) =>
269
+ (
270
+ await db.findAggregates("distribution", {
271
+ index: "byRelease",
272
+ where: { release },
273
+ limit: 64,
274
+ })
275
+ ).rows.map((row) => row.installations);
276
+ expect(await installations("A")).toEqual([]);
277
+ expect(await installations("B")).toEqual([]);
278
+ expect(await installations("C")).toEqual([1]);
279
+ expect(reruns).toBeGreaterThan(0);
280
+ });
281
+
282
+ it("folds counters into the guarded write when the same row has a gauge change", async () => {
283
+ const { db, writes } = await setup();
284
+ const change = (values: { hits?: number; open?: number }) =>
285
+ db.transaction(async (tx) => {
286
+ tx.aggregate("totals", { scope: "s" }, values);
287
+ });
288
+ await change({ hits: 1, open: 1 });
289
+ await change({ open: -1 });
290
+ await change({ hits: 1 });
291
+ expect(
292
+ writes.map((ops) => ops.map((op) => [op.type, "guard" in op])),
293
+ ).toEqual([[["insert", false]], [["patch", true]], [["increment", false]]]);
294
+ await expect(
295
+ db.findAggregates("totals", { index: "all", where: {}, limit: 10 }),
296
+ ).resolves.toEqual({ rows: [{ scope: "s", hits: 2, open: 0 }] });
297
+ });
298
+
299
+ it("merges sketches into the stored sketch", async () => {
300
+ const { db } = await setup();
301
+ for (const id of ["u1", "u2", "u3", "u1"]) {
302
+ await db.transaction(async (tx) => {
303
+ tx.aggregate(
304
+ "users",
305
+ { bucket: 1 },
306
+ { users: sketchOf(id) },
307
+ { shardBy: id },
308
+ );
309
+ });
310
+ }
311
+ await db.transaction(async (tx) => {
312
+ tx.aggregate(
313
+ "users",
314
+ { bucket: 1 },
315
+ { users: sketchOf("u4", "u5") },
316
+ { shardBy: "u4" },
317
+ );
318
+ });
319
+ const { rows } = await db.findAggregates("users", {
320
+ index: "all",
321
+ where: {},
322
+ limit: 64,
323
+ });
324
+ expect(rows).toHaveLength(1);
325
+ expect(countInsightsDistinct(rows[0]!.users)).toBe(5);
326
+ });
327
+
328
+ it("writes nothing when a merge leaves the stored row unchanged", async () => {
329
+ const { db, writes } = await setup();
330
+ const add = (id: string) =>
331
+ db.transaction(async (tx) => {
332
+ tx.aggregate(
333
+ "users",
334
+ { bucket: 1 },
335
+ { users: sketchOf(id) },
336
+ { shardBy: "u1" },
337
+ );
338
+ });
339
+ await add("u1");
340
+ expect(writes).toHaveLength(1);
341
+ // the sketch already counts u1, so there is nothing to write or guard
342
+ await add("u1");
343
+ expect(writes).toHaveLength(1);
344
+ });
345
+
346
+ it("resends only the aggregate rows when their guard fails", async () => {
347
+ const { db, faults, retries } = await setup();
348
+ await db.transaction(async (tx) => {
349
+ tx.create("installs", { id: "i1", release: "A" });
350
+ });
351
+ faults.inject = failOnce(1);
352
+ let runs = 0;
353
+ await db.transaction(async (tx) => {
354
+ runs += 1;
355
+ const head = (await tx.findOne("installs", { id: "i1" }))!;
356
+ tx.update("installs", head, { release: "B" });
357
+ tx.aggregate(
358
+ "distribution",
359
+ { release: "B", bucket: 1 },
360
+ { installations: 1 },
361
+ { shardBy: "i1" },
362
+ );
363
+ });
364
+ expect(runs).toBe(1);
365
+ expect(retries).toEqual({ rerun: 0, resend: 1 });
366
+
367
+ faults.inject = failOnce(0);
368
+ await db.transaction(async (tx) => {
369
+ runs += 1;
370
+ const head = (await tx.findOne("installs", { id: "i1" }))!;
371
+ tx.update("installs", head, { release: "C" });
372
+ tx.aggregate(
373
+ "distribution",
374
+ { release: "B", bucket: 1 },
375
+ { installations: -1 },
376
+ { shardBy: "i1" },
377
+ );
378
+ });
379
+ expect(runs).toBe(3);
380
+ expect(retries).toEqual({ rerun: 1, resend: 1 });
381
+ await expect(
382
+ db.findAggregates("distribution", {
383
+ index: "byRelease",
384
+ where: { release: "B" },
385
+ limit: 64,
386
+ }),
387
+ ).resolves.toEqual({ rows: [] });
388
+ });
389
+
390
+ it("lets 32 writers on one hot shard row finish by resending, never rerunning fn", async () => {
391
+ const { db, retries } = await setup({
392
+ retry: { attempts: 64, baseDelayMs: 1, maxDelayMs: 4 },
393
+ });
394
+ let runs = 0;
395
+ await Promise.all(
396
+ Array.from({ length: 32 }, () =>
397
+ db.transaction(async (tx) => {
398
+ runs += 1;
399
+ tx.aggregate(
400
+ "distribution",
401
+ { release: "A", bucket: 1 },
402
+ { installations: 1 },
403
+ { shardBy: "hot" },
404
+ );
405
+ }),
406
+ ),
407
+ );
408
+ expect(runs).toBe(32);
409
+ expect(retries.rerun).toBe(0);
410
+ expect(retries.resend).toBeGreaterThan(0);
411
+ await expect(
412
+ db.findAggregates("distribution", {
413
+ index: "byRelease",
414
+ where: { release: "A" },
415
+ limit: 64,
416
+ }),
417
+ ).resolves.toEqual({
418
+ rows: [{ release: "A", bucket: 1, installations: 32 }],
419
+ });
420
+ });
421
+
422
+ it("rejects unknown aggregates, identities, metrics, and fractional deltas", async () => {
423
+ const { db } = await setup();
424
+ await expect(
425
+ db.transaction(async (tx) => {
426
+ // @ts-expect-error installs is a table.
427
+ tx.aggregate("installs", { id: "i" }, {});
428
+ }),
429
+ ).rejects.toThrow(DatabaseQueryError);
430
+ await expect(
431
+ db.transaction(async (tx) => {
432
+ // @ts-expect-error bucket is missing.
433
+ tx.aggregate("overview", {}, { events: 1 });
434
+ }),
435
+ ).rejects.toThrow("aggregate takes exactly its identity fields: bucket");
436
+ await expect(
437
+ db.transaction(async (tx) => {
438
+ // @ts-expect-error nope is not a metric.
439
+ tx.aggregate("overview", { bucket: 1 }, { nope: 1 });
440
+ }),
441
+ ).rejects.toThrow("nope is not a counter, gauge, or sketch");
442
+ await expect(
443
+ db.transaction(async (tx) => {
444
+ tx.aggregate("overview", { bucket: 1 }, { events: 1.5 });
445
+ }),
446
+ ).rejects.toThrow(DatabaseTransactionError);
447
+ });
448
+
449
+ it(
450
+ "stays within B3's contention budget on a rollout from A to B with 5 ms latency",
451
+ { timeout: 30_000 },
452
+ async () => {
453
+ const seeded = await setup();
454
+ const move = (target: typeof seeded.db, index: number, release: string) =>
455
+ target.transaction(async (tx) => {
456
+ const id = `install-${index}`;
457
+ const head = await tx.findOne("installs", { id });
458
+ if (head === null) {
459
+ tx.create("installs", { id, release });
460
+ } else {
461
+ tx.update("installs", head, { release });
462
+ tx.aggregate(
463
+ "distribution",
464
+ { release: head.release, bucket: 1 },
465
+ { installations: -1 },
466
+ { shardBy: id },
467
+ );
468
+ }
469
+ tx.aggregate(
470
+ "distribution",
471
+ { release, bucket: 1 },
472
+ { installations: 1 },
473
+ { shardBy: id },
474
+ );
475
+ tx.aggregate(
476
+ "overview",
477
+ { bucket: 1 },
478
+ { events: 1 },
479
+ { shardBy: id },
480
+ );
481
+ tx.aggregate(
482
+ "users",
483
+ { bucket: 1 },
484
+ { users: sketchOf(id) },
485
+ { shardBy: id },
486
+ );
487
+ });
488
+ for (let index = 0; index < 300; index += 1) {
489
+ await move(seeded.db, index, "A");
490
+ }
491
+ const slow = createDatabaseEngine({
492
+ adapter: withAdapterLatency(seeded.memory, 5),
493
+ schema,
494
+ retry: {
495
+ onRetry: (kind) => {
496
+ seeded.retries[kind] += 1;
497
+ },
498
+ },
499
+ }).database(module);
500
+ seeded.retries.rerun = 0;
501
+ seeded.retries.resend = 0;
502
+ const report = await runContentionHarness({
503
+ transactions: 300,
504
+ ratePerSecond: 100,
505
+ concurrency: 16,
506
+ run: (index) => move(slow, index, "B"),
507
+ });
508
+ expect(report.errors).toEqual({});
509
+ expect(report.committed).toBe(300);
510
+ const retried = seeded.retries.rerun + seeded.retries.resend;
511
+ expect(retried / report.transactions).toBeLessThanOrEqual(0.05);
512
+
513
+ const read = (release: string) =>
514
+ seeded.db.findAggregates("distribution", {
515
+ index: "byRelease",
516
+ where: { release },
517
+ limit: 100,
518
+ });
519
+ await expect(read("A")).resolves.toEqual({ rows: [] });
520
+ await expect(read("B")).resolves.toEqual({
521
+ rows: [{ release: "B", bucket: 1, installations: 300 }],
522
+ });
523
+ await expect(
524
+ seeded.db.findAggregates("overview", {
525
+ index: "all",
526
+ where: {},
527
+ limit: 10,
528
+ }),
529
+ ).resolves.toEqual({ rows: [{ bucket: 1, events: 600, failures: 0 }] });
530
+ const { rows } = await seeded.db.findAggregates("users", {
531
+ index: "all",
532
+ where: {},
533
+ limit: 64,
534
+ });
535
+ const ids = Array.from({ length: 300 }, (_, index) => `install-${index}`);
536
+ expect(rows[0]!.users).toBe(sketchOf(...ids));
537
+ },
538
+ );
539
+ });