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

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (514) hide show
  1. package/dist/adapters/drizzle.cjs +35 -74
  2. package/dist/adapters/drizzle.d.cts +13 -5
  3. package/dist/adapters/drizzle.d.mts +13 -5
  4. package/dist/adapters/drizzle.mjs +34 -75
  5. package/dist/adapters/drizzleExecutor.cjs +114 -0
  6. package/dist/adapters/drizzleExecutor.d.cts +9 -0
  7. package/dist/adapters/drizzleExecutor.d.mts +9 -0
  8. package/dist/adapters/drizzleExecutor.mjs +112 -0
  9. package/dist/adapters/kysely.cjs +25 -31
  10. package/dist/adapters/kysely.d.cts +10 -6
  11. package/dist/adapters/kysely.d.mts +10 -6
  12. package/dist/adapters/kysely.mjs +25 -32
  13. package/dist/adapters/kyselyExecutor.cjs +32 -0
  14. package/dist/adapters/kyselyExecutor.d.cts +12 -0
  15. package/dist/adapters/kyselyExecutor.d.mts +12 -0
  16. package/dist/adapters/kyselyExecutor.mjs +32 -0
  17. package/dist/adapters/mongodb.cjs +28 -62
  18. package/dist/adapters/mongodb.d.cts +10 -5
  19. package/dist/adapters/mongodb.d.mts +10 -5
  20. package/dist/adapters/mongodb.mjs +28 -63
  21. package/dist/adapters/mongodbAdapter.cjs +174 -0
  22. package/dist/adapters/mongodbAdapter.d.cts +9 -0
  23. package/dist/adapters/mongodbAdapter.d.mts +9 -0
  24. package/dist/adapters/mongodbAdapter.mjs +173 -0
  25. package/dist/adapters/prisma.cjs +38 -257
  26. package/dist/adapters/prisma.d.cts +12 -7
  27. package/dist/adapters/prisma.d.mts +12 -7
  28. package/dist/adapters/prisma.mjs +38 -257
  29. package/dist/adapters/prismaExecutor.cjs +64 -0
  30. package/dist/adapters/prismaExecutor.mjs +64 -0
  31. package/dist/adapters/sqlProviders.cjs +9 -0
  32. package/dist/adapters/sqlProviders.mjs +9 -0
  33. package/dist/apiKeys.cjs +2 -6
  34. package/dist/apiKeys.d.cts +1 -23
  35. package/dist/apiKeys.d.mts +1 -23
  36. package/dist/apiKeys.mjs +2 -6
  37. package/dist/assembly/assemblePlugins.cjs +147 -0
  38. package/dist/assembly/assemblePlugins.d.cts +12 -0
  39. package/dist/assembly/assemblePlugins.d.mts +12 -0
  40. package/dist/assembly/assemblePlugins.mjs +146 -0
  41. package/dist/assembly/databasePlugins.cjs +23 -0
  42. package/dist/assembly/databasePlugins.d.cts +43 -0
  43. package/dist/assembly/databasePlugins.d.mts +43 -0
  44. package/dist/assembly/databasePlugins.mjs +22 -0
  45. package/dist/core/api.cjs +91 -0
  46. package/dist/core/api.d.cts +65 -0
  47. package/dist/core/api.d.mts +65 -0
  48. package/dist/core/api.mjs +87 -0
  49. package/dist/core/baseCandidates.cjs +71 -0
  50. package/dist/core/baseCandidates.d.cts +17 -0
  51. package/dist/core/baseCandidates.d.mts +17 -0
  52. package/dist/core/baseCandidates.mjs +69 -0
  53. package/dist/core/operations.cjs +350 -0
  54. package/dist/core/operations.mjs +350 -0
  55. package/dist/core/reads.cjs +273 -0
  56. package/dist/core/reads.d.cts +48 -0
  57. package/dist/core/reads.d.mts +48 -0
  58. package/dist/core/reads.mjs +267 -0
  59. package/dist/core/releases.cjs +193 -0
  60. package/dist/core/releases.mjs +190 -0
  61. package/dist/core/schema.cjs +279 -0
  62. package/dist/core/schema.d.cts +307 -0
  63. package/dist/core/schema.d.mts +307 -0
  64. package/dist/core/schema.mjs +277 -0
  65. package/dist/core/writes.cjs +96 -0
  66. package/dist/core/writes.mjs +91 -0
  67. package/dist/createHotUpdaterCore.cjs +58 -75
  68. package/dist/createHotUpdaterCore.d.cts +52 -44
  69. package/dist/createHotUpdaterCore.d.mts +52 -44
  70. package/dist/createHotUpdaterCore.mjs +59 -75
  71. package/dist/database/cursor.cjs +44 -0
  72. package/dist/database/cursor.d.cts +7 -0
  73. package/dist/database/cursor.d.mts +7 -0
  74. package/dist/database/cursor.mjs +40 -0
  75. package/dist/database/database.cjs +44 -0
  76. package/dist/database/database.d.cts +123 -0
  77. package/dist/database/database.d.mts +123 -0
  78. package/dist/database/database.mjs +44 -0
  79. package/dist/database/definitions.d.cts +68 -0
  80. package/dist/database/definitions.d.mts +68 -0
  81. package/dist/database/engine.cjs +37 -0
  82. package/dist/database/engine.d.cts +40 -0
  83. package/dist/database/engine.d.mts +40 -0
  84. package/dist/database/engine.mjs +37 -0
  85. package/dist/database/engineAggregates.cjs +115 -0
  86. package/dist/database/engineAggregates.mjs +112 -0
  87. package/dist/database/engineReads.cjs +180 -0
  88. package/dist/database/engineReads.d.cts +35 -0
  89. package/dist/database/engineReads.d.mts +35 -0
  90. package/dist/database/engineReads.mjs +179 -0
  91. package/dist/database/engineTransaction.cjs +403 -0
  92. package/dist/database/engineTransaction.d.cts +26 -0
  93. package/dist/database/engineTransaction.d.mts +26 -0
  94. package/dist/database/engineTransaction.mjs +402 -0
  95. package/dist/database/errors.cjs +27 -0
  96. package/dist/database/errors.d.cts +21 -0
  97. package/dist/database/errors.d.mts +21 -0
  98. package/dist/database/errors.mjs +24 -0
  99. package/dist/database/fence.cjs +124 -0
  100. package/dist/database/fence.d.cts +42 -0
  101. package/dist/database/fence.d.mts +42 -0
  102. package/dist/database/fence.mjs +116 -0
  103. package/dist/database/index.cjs +127 -0
  104. package/dist/database/index.d.cts +17 -0
  105. package/dist/database/index.d.mts +17 -0
  106. package/dist/database/index.mjs +15 -0
  107. package/dist/database/kv/kvAdapter.cjs +273 -0
  108. package/dist/database/kv/kvAdapter.d.cts +101 -0
  109. package/dist/database/kv/kvAdapter.d.mts +101 -0
  110. package/dist/database/kv/kvAdapter.mjs +272 -0
  111. package/dist/database/resolveSchema.cjs +196 -0
  112. package/dist/database/resolveSchema.d.cts +42 -0
  113. package/dist/database/resolveSchema.d.mts +42 -0
  114. package/dist/database/resolveSchema.mjs +193 -0
  115. package/dist/database/schema.cjs +21 -0
  116. package/dist/database/schema.d.cts +61 -0
  117. package/dist/database/schema.d.mts +61 -0
  118. package/dist/database/schema.mjs +20 -0
  119. package/dist/database/sql/sqlAdapter.cjs +282 -0
  120. package/dist/database/sql/sqlAdapter.d.cts +46 -0
  121. package/dist/database/sql/sqlAdapter.d.mts +46 -0
  122. package/dist/database/sql/sqlAdapter.mjs +279 -0
  123. package/dist/database/sql/sqlSchema.cjs +115 -0
  124. package/dist/database/sql/sqlSchema.d.cts +8 -0
  125. package/dist/database/sql/sqlSchema.d.mts +8 -0
  126. package/dist/database/sql/sqlSchema.mjs +111 -0
  127. package/dist/db/builtInDatabase.cjs +104 -0
  128. package/dist/db/builtInDatabase.d.cts +38 -0
  129. package/dist/db/builtInDatabase.d.mts +38 -0
  130. package/dist/db/builtInDatabase.mjs +97 -0
  131. package/dist/db/createBundleDiff.cjs +4 -4
  132. package/dist/db/createBundleDiff.d.cts +3 -2
  133. package/dist/db/createBundleDiff.d.mts +3 -2
  134. package/dist/db/createBundleDiff.mjs +5 -5
  135. package/dist/db/engineDrizzleSchema.cjs +54 -0
  136. package/dist/db/engineDrizzleSchema.mjs +54 -0
  137. package/dist/db/engineMigrator.cjs +53 -0
  138. package/dist/db/engineMigrator.mjs +53 -0
  139. package/dist/db/enginePrismaSchema.cjs +85 -0
  140. package/dist/db/enginePrismaSchema.d.cts +5 -0
  141. package/dist/db/enginePrismaSchema.d.mts +5 -0
  142. package/dist/db/enginePrismaSchema.mjs +84 -0
  143. package/dist/db/engineSql.cjs +26 -0
  144. package/dist/db/engineSql.d.cts +17 -0
  145. package/dist/db/engineSql.d.mts +17 -0
  146. package/dist/db/engineSql.mjs +25 -0
  147. package/dist/db/engineSqlMigrator.cjs +66 -0
  148. package/dist/db/engineSqlMigrator.mjs +66 -0
  149. package/dist/db/fixedMigratorShared.cjs +0 -11
  150. package/dist/db/fixedMigratorShared.mjs +1 -8
  151. package/dist/db/index.cjs +23 -8
  152. package/dist/db/index.d.cts +10 -3
  153. package/dist/db/index.d.mts +10 -3
  154. package/dist/db/index.mjs +16 -8
  155. package/dist/db/releaseCatalog.cjs +20 -43
  156. package/dist/db/releaseCatalog.d.cts +2 -2
  157. package/dist/db/releaseCatalog.d.mts +2 -2
  158. package/dist/db/releaseCatalog.mjs +20 -44
  159. package/dist/db/schemaSettings.cjs +63 -0
  160. package/dist/db/schemaSettings.d.cts +12 -0
  161. package/dist/db/schemaSettings.d.mts +12 -0
  162. package/dist/db/schemaSettings.mjs +62 -0
  163. package/dist/db/settingsMigrator.cjs +92 -0
  164. package/dist/db/settingsMigrator.mjs +89 -0
  165. package/dist/db/types.cjs +1 -12
  166. package/dist/db/types.d.cts +26 -66
  167. package/dist/db/types.d.mts +26 -66
  168. package/dist/db/types.mjs +2 -11
  169. package/dist/db/updateArtifacts.cjs +38 -67
  170. package/dist/db/updateArtifacts.mjs +40 -69
  171. package/dist/handler.cjs +72 -43
  172. package/dist/handler.d.cts +3 -5
  173. package/dist/handler.d.mts +3 -5
  174. package/dist/handler.mjs +73 -43
  175. package/dist/handlerAdminRoutes.cjs +375 -0
  176. package/dist/handlerAdminRoutes.mjs +373 -0
  177. package/dist/handlerParameters.cjs +6 -11
  178. package/dist/handlerParameters.mjs +6 -10
  179. package/dist/handlerReleaseCatalogRoutes.cjs +11 -13
  180. package/dist/handlerReleaseCatalogRoutes.mjs +11 -13
  181. package/dist/handlerTypes.d.cts +2 -55
  182. package/dist/handlerTypes.d.mts +2 -55
  183. package/dist/handlerVersionRoutes.cjs +20 -4
  184. package/dist/handlerVersionRoutes.mjs +20 -4
  185. package/dist/index.cjs +4 -7
  186. package/dist/index.d.cts +8 -7
  187. package/dist/index.d.mts +8 -7
  188. package/dist/index.mjs +4 -4
  189. package/dist/insights/domain.d.cts +12 -0
  190. package/dist/insights/domain.d.mts +12 -0
  191. package/dist/insights/errors.cjs +34 -0
  192. package/dist/insights/errors.mjs +34 -1
  193. package/dist/insights/eventInput.cjs +14 -19
  194. package/dist/insights/eventInput.mjs +15 -20
  195. package/dist/insights/provider.cjs +47 -23
  196. package/dist/insights/provider.mjs +47 -24
  197. package/dist/insights/routes.cjs +79 -14
  198. package/dist/insights/routes.mjs +77 -14
  199. package/dist/node.d.cts +1 -1
  200. package/dist/node.d.mts +1 -1
  201. package/dist/package.cjs +1 -1
  202. package/dist/package.mjs +1 -1
  203. package/dist/plugins/api-keys/index.cjs +50 -0
  204. package/dist/plugins/api-keys/index.d.cts +85 -0
  205. package/dist/plugins/api-keys/index.d.mts +85 -0
  206. package/dist/plugins/api-keys/index.mjs +47 -0
  207. package/dist/plugins/api-keys/model.cjs +58 -0
  208. package/dist/plugins/api-keys/model.d.cts +8 -0
  209. package/dist/plugins/api-keys/model.d.mts +8 -0
  210. package/dist/plugins/api-keys/model.mjs +58 -0
  211. package/dist/plugins/api-keys/schema.cjs +38 -0
  212. package/dist/plugins/api-keys/schema.d.cts +44 -0
  213. package/dist/plugins/api-keys/schema.d.mts +44 -0
  214. package/dist/plugins/api-keys/schema.mjs +39 -0
  215. package/dist/plugins/builtIn.cjs +7 -0
  216. package/dist/plugins/builtIn.mjs +6 -0
  217. package/dist/plugins/definePlugin.cjs +5 -0
  218. package/dist/plugins/definePlugin.d.cts +73 -0
  219. package/dist/plugins/definePlugin.d.mts +73 -0
  220. package/dist/plugins/definePlugin.mjs +5 -0
  221. package/dist/plugins/index.cjs +17 -0
  222. package/dist/plugins/index.d.cts +9 -0
  223. package/dist/plugins/index.d.mts +9 -0
  224. package/dist/plugins/index.mjs +7 -0
  225. package/dist/plugins/insights/index.cjs +48 -0
  226. package/dist/plugins/insights/index.d.cts +295 -0
  227. package/dist/plugins/insights/index.d.mts +295 -0
  228. package/dist/plugins/insights/index.mjs +44 -0
  229. package/dist/plugins/insights/model.cjs +17 -0
  230. package/dist/plugins/insights/model.d.cts +10 -0
  231. package/dist/plugins/insights/model.d.mts +10 -0
  232. package/dist/plugins/insights/model.mjs +17 -0
  233. package/dist/plugins/insights/reads.cjs +471 -0
  234. package/dist/plugins/insights/reads.mjs +466 -0
  235. package/dist/plugins/insights/recordEvent.cjs +135 -0
  236. package/dist/plugins/insights/recordEvent.d.cts +13 -0
  237. package/dist/plugins/insights/recordEvent.d.mts +13 -0
  238. package/dist/plugins/insights/recordEvent.mjs +132 -0
  239. package/dist/plugins/insights/schema.cjs +347 -0
  240. package/dist/plugins/insights/schema.d.cts +258 -0
  241. package/dist/plugins/insights/schema.d.mts +258 -0
  242. package/dist/plugins/insights/schema.mjs +344 -0
  243. package/dist/types/index.d.cts +2 -28
  244. package/dist/types/index.d.mts +2 -28
  245. package/package.json +28 -5
  246. package/src/adapters/drizzle.conformance.integration.spec.ts +34 -0
  247. package/src/adapters/drizzle.readBudgets.integration.spec.ts +41 -0
  248. package/src/adapters/drizzle.spec.ts +270 -399
  249. package/src/adapters/drizzle.ts +48 -140
  250. package/src/adapters/drizzleExecutor.ts +166 -0
  251. package/src/adapters/kysely.conformance.integration.spec.ts +36 -0
  252. package/src/adapters/kysely.readBudgets.integration.spec.ts +42 -0
  253. package/src/adapters/kysely.spec.ts +204 -171
  254. package/src/adapters/kysely.ts +32 -93
  255. package/src/adapters/kyselyExecutor.ts +53 -0
  256. package/src/adapters/mongodb.integration.spec.ts +143 -446
  257. package/src/adapters/mongodb.readBudgets.integration.spec.ts +61 -0
  258. package/src/adapters/mongodb.ts +36 -123
  259. package/src/adapters/mongodbAdapter.ts +293 -0
  260. package/src/adapters/prisma.conformance.integration.spec.ts +36 -0
  261. package/src/adapters/prisma.integration.spec.ts +138 -0
  262. package/src/adapters/prisma.readBudgets.integration.spec.ts +40 -0
  263. package/src/adapters/prisma.spec.ts +216 -433
  264. package/src/adapters/prisma.ts +60 -524
  265. package/src/adapters/prismaExecutor.ts +107 -0
  266. package/src/adapters/prismaTestClients.ts +175 -0
  267. package/src/adapters/sqlProviders.ts +14 -0
  268. package/src/apiKeys.integration.spec.ts +19 -119
  269. package/src/apiKeys.spec.ts +39 -35
  270. package/src/apiKeys.ts +2 -8
  271. package/src/assembly/assemblePlugins.ts +269 -0
  272. package/src/assembly/assembly.spec.ts +325 -0
  273. package/src/assembly/assembly.types.spec.ts +155 -0
  274. package/src/assembly/builtInRoutes.spec.ts +213 -0
  275. package/src/assembly/databasePlugins.spec.ts +71 -0
  276. package/src/assembly/databasePlugins.ts +96 -0
  277. package/src/core/api.ts +139 -0
  278. package/src/core/baseCandidates.spec.ts +378 -0
  279. package/src/core/baseCandidates.ts +136 -0
  280. package/src/core/index.ts +44 -0
  281. package/src/core/operations.spec.ts +415 -0
  282. package/src/core/operations.ts +551 -0
  283. package/src/core/reads.spec.ts +300 -0
  284. package/src/core/reads.ts +417 -0
  285. package/src/core/releases.spec.ts +308 -0
  286. package/src/core/releases.ts +345 -0
  287. package/src/core/schema.ts +173 -0
  288. package/src/core/writes.ts +160 -0
  289. package/src/createHotUpdaterCore.ts +191 -181
  290. package/src/database/cursor.ts +65 -0
  291. package/src/database/database.ts +335 -0
  292. package/src/database/database.types.spec.ts +135 -0
  293. package/src/database/definitions.ts +72 -0
  294. package/src/database/engine.ts +62 -0
  295. package/src/database/engineAggregates.spec.ts +539 -0
  296. package/src/database/engineAggregates.ts +193 -0
  297. package/src/database/engineReads.spec.ts +219 -0
  298. package/src/database/engineReads.ts +302 -0
  299. package/src/database/engineTransaction.spec.ts +710 -0
  300. package/src/database/engineTransaction.ts +588 -0
  301. package/src/database/errors.ts +30 -0
  302. package/src/database/fence.spec.ts +223 -0
  303. package/src/database/fence.ts +171 -0
  304. package/src/database/index.ts +154 -0
  305. package/src/database/kv/kvAdapter.conformance.integration.spec.ts +17 -0
  306. package/src/database/kv/kvAdapter.readBudgets.integration.spec.ts +17 -0
  307. package/src/database/kv/kvAdapter.spec.ts +468 -0
  308. package/src/database/kv/kvAdapter.ts +450 -0
  309. package/src/database/kv/kvTestStore.ts +91 -0
  310. package/src/database/memory.readBudgets.integration.spec.ts +13 -0
  311. package/src/database/resolveSchema.spec.ts +230 -0
  312. package/src/database/resolveSchema.ts +372 -0
  313. package/src/database/schema.ts +169 -0
  314. package/src/database/schema.types.spec.ts +94 -0
  315. package/src/database/sql/docker-compose.yml +36 -0
  316. package/src/database/sql/sqlAdapter.integration.spec.ts +148 -0
  317. package/src/database/sql/sqlAdapter.readBudgets.integration.spec.ts +109 -0
  318. package/src/database/sql/sqlAdapter.spec.ts +255 -0
  319. package/src/database/sql/sqlAdapter.ts +532 -0
  320. package/src/database/sql/sqlSchema.ts +205 -0
  321. package/src/database/sql/sqlTestExecutors.ts +183 -0
  322. package/src/databaseTestSuite.spec.ts +39 -0
  323. package/src/db/builtInDatabase.ts +149 -0
  324. package/src/db/bundleRows.spec.ts +3 -3
  325. package/src/db/createBundleDiff.spec.ts +43 -29
  326. package/src/db/createBundleDiff.ts +13 -7
  327. package/src/db/engineDrizzleSchema.ts +72 -0
  328. package/src/db/engineMigrator.ts +105 -0
  329. package/src/db/enginePrismaSchema.ts +147 -0
  330. package/src/db/engineSql.spec.ts +129 -0
  331. package/src/db/engineSql.ts +48 -0
  332. package/src/db/engineSqlMigrator.ts +116 -0
  333. package/src/db/fixedMigratorShared.ts +1 -20
  334. package/src/db/index.spec.ts +116 -829
  335. package/src/db/index.ts +43 -14
  336. package/src/db/pluginTables.spec.ts +218 -0
  337. package/src/db/releaseCatalog.ts +48 -90
  338. package/src/db/schemaSettings.ts +104 -0
  339. package/src/db/settingsMigrator.spec.ts +65 -0
  340. package/src/db/settingsMigrator.ts +152 -0
  341. package/src/db/types.ts +25 -171
  342. package/src/db/updateArtifacts.spec.ts +170 -294
  343. package/src/db/updateArtifacts.ts +74 -142
  344. package/src/db/updateCheck.bench.ts +47 -0
  345. package/src/handler-standalone.integration.spec.ts +204 -410
  346. package/src/handler.spec.ts +134 -51
  347. package/src/handler.testFixtures.ts +14 -19
  348. package/src/handler.ts +163 -75
  349. package/src/handlerAdminRoutes.spec.ts +183 -0
  350. package/src/handlerAdminRoutes.ts +536 -0
  351. package/src/handlerAuth.integration.spec.ts +3 -3
  352. package/src/handlerManagement.spec.ts +136 -196
  353. package/src/handlerReleaseCatalogRoutes.ts +15 -17
  354. package/src/handlerTypes.ts +3 -80
  355. package/src/handlerVersionRoutes.ts +20 -7
  356. package/src/index.ts +5 -12
  357. package/src/insights/domain.ts +12 -0
  358. package/src/insights/errors.spec.ts +48 -0
  359. package/src/insights/errors.ts +51 -0
  360. package/src/insights/eventInput.ts +27 -24
  361. package/src/insights/insights.integration.spec.ts +228 -78
  362. package/src/insights/provider.spec.ts +203 -25
  363. package/src/insights/provider.ts +88 -32
  364. package/src/insights/routes.ts +95 -20
  365. package/src/lintRules.spec.ts +76 -0
  366. package/src/plugins/api-keys/apiKeysPlugin.spec.ts +172 -0
  367. package/src/plugins/api-keys/index.ts +66 -0
  368. package/src/plugins/api-keys/model.ts +69 -0
  369. package/src/plugins/api-keys/schema.ts +22 -0
  370. package/src/plugins/builtIn.ts +5 -0
  371. package/src/plugins/definePlugin.ts +100 -0
  372. package/src/plugins/index.ts +55 -0
  373. package/src/plugins/insights/index.ts +86 -0
  374. package/src/plugins/insights/insightsRollout.integration.spec.ts +187 -0
  375. package/src/plugins/insights/model.spec.ts +66 -0
  376. package/src/plugins/insights/model.ts +19 -0
  377. package/src/plugins/insights/reads.spec.ts +725 -0
  378. package/src/plugins/insights/reads.ts +707 -0
  379. package/src/plugins/insights/recordEvent.spec.ts +443 -0
  380. package/src/plugins/insights/recordEvent.ts +238 -0
  381. package/src/plugins/insights/schema.ts +229 -0
  382. package/src/plugins/pluginTestHarness.spec.ts +56 -0
  383. package/src/readBudgets.testFixtures.ts +15 -0
  384. package/src/releaseCatalogRoutes.integration.spec.ts +47 -92
  385. package/src/runtime.spec.ts +91 -77
  386. package/src/runtime.testFixtures.ts +28 -44
  387. package/src/runtimeBundles.integration.spec.ts +112 -0
  388. package/src/testUtilsMutation.integration.spec.ts +215 -0
  389. package/src/testUtilsPackage.integration.spec.ts +176 -0
  390. package/src/types/index.ts +0 -32
  391. package/dist/adapters/databaseConstraintErrors.cjs +0 -22
  392. package/dist/adapters/databaseConstraintErrors.mjs +0 -21
  393. package/dist/adapters/databasePluginUtils.cjs +0 -130
  394. package/dist/adapters/databasePluginUtils.mjs +0 -118
  395. package/dist/adapters/drizzleCrud.cjs +0 -340
  396. package/dist/adapters/drizzleCrud.mjs +0 -337
  397. package/dist/adapters/drizzleLazyDB.cjs +0 -103
  398. package/dist/adapters/drizzleLazyDB.mjs +0 -103
  399. package/dist/adapters/drizzleQuery.cjs +0 -69
  400. package/dist/adapters/drizzleQuery.mjs +0 -69
  401. package/dist/adapters/kyselyCrud.cjs +0 -293
  402. package/dist/adapters/kyselyCrud.mjs +0 -292
  403. package/dist/adapters/kyselyQuery.cjs +0 -56
  404. package/dist/adapters/kyselyQuery.mjs +0 -56
  405. package/dist/adapters/mongodbCollections.cjs +0 -38
  406. package/dist/adapters/mongodbCollections.mjs +0 -32
  407. package/dist/adapters/mongodbQuery.cjs +0 -90
  408. package/dist/adapters/mongodbQuery.mjs +0 -83
  409. package/dist/adapters/mongodbReads.cjs +0 -206
  410. package/dist/adapters/mongodbReads.mjs +0 -206
  411. package/dist/adapters/mongodbWrites.cjs +0 -133
  412. package/dist/adapters/mongodbWrites.mjs +0 -133
  413. package/dist/adapters/prismaInsights.cjs +0 -99
  414. package/dist/adapters/prismaInsights.mjs +0 -97
  415. package/dist/adapters/prismaQuery.cjs +0 -57
  416. package/dist/adapters/prismaQuery.mjs +0 -56
  417. package/dist/adapters/prismaRows.cjs +0 -197
  418. package/dist/adapters/prismaRows.mjs +0 -188
  419. package/dist/db/databasePluginCore.cjs +0 -137
  420. package/dist/db/databasePluginCore.mjs +0 -137
  421. package/dist/db/fixedMigrator.cjs +0 -79
  422. package/dist/db/fixedMigrator.mjs +0 -78
  423. package/dist/db/fixedMigratorMongo.cjs +0 -321
  424. package/dist/db/fixedMigratorMongo.mjs +0 -321
  425. package/dist/db/mongoMigrationExecution.cjs +0 -11
  426. package/dist/db/mongoMigrationExecution.mjs +0 -11
  427. package/dist/db/schema/insightsCollation.cjs +0 -14
  428. package/dist/db/schema/insightsCollation.mjs +0 -14
  429. package/dist/db/schema/mongodb.cjs +0 -25
  430. package/dist/db/schema/mongodb.mjs +0 -25
  431. package/dist/db/schema/registry.cjs +0 -21
  432. package/dist/db/schema/registry.mjs +0 -17
  433. package/dist/db/schema/sql.cjs +0 -105
  434. package/dist/db/schema/sql.mjs +0 -97
  435. package/dist/db/schema/sqlOperations.cjs +0 -27
  436. package/dist/db/schema/sqlOperations.mjs +0 -26
  437. package/dist/db/schemaGenerators.cjs +0 -276
  438. package/dist/db/schemaGenerators.mjs +0 -274
  439. package/dist/db/schemaReadiness.cjs +0 -26
  440. package/dist/db/schemaReadiness.d.cts +0 -9
  441. package/dist/db/schemaReadiness.d.mts +0 -9
  442. package/dist/db/schemaReadiness.mjs +0 -25
  443. package/dist/db/sqlMigrationExecution.cjs +0 -67
  444. package/dist/db/sqlMigrationExecution.mjs +0 -67
  445. package/dist/handlerBundleRoutes.cjs +0 -155
  446. package/dist/handlerBundleRoutes.mjs +0 -155
  447. package/dist/handlerReleaseManagementRoutes.cjs +0 -124
  448. package/dist/handlerReleaseManagementRoutes.mjs +0 -124
  449. package/dist/schema/dsl.cjs +0 -103
  450. package/dist/schema/dsl.mjs +0 -87
  451. package/dist/schema/index.cjs +0 -20
  452. package/dist/schema/index.mjs +0 -7
  453. package/dist/schema/settings.cjs +0 -9
  454. package/dist/schema/settings.mjs +0 -9
  455. package/dist/schema/types.cjs +0 -8
  456. package/dist/schema/types.mjs +0 -6
  457. package/dist/schema/v1_0_0.cjs +0 -393
  458. package/dist/schema/v1_0_0.mjs +0 -385
  459. package/src/adapters/databaseConstraintErrors.ts +0 -25
  460. package/src/adapters/databasePluginTestDatabase.ts +0 -116
  461. package/src/adapters/databasePluginUtils.spec.ts +0 -29
  462. package/src/adapters/databasePluginUtils.ts +0 -238
  463. package/src/adapters/drizzleCrud.ts +0 -610
  464. package/src/adapters/drizzleLazyDB.ts +0 -284
  465. package/src/adapters/drizzleQuery.ts +0 -164
  466. package/src/adapters/kyselyCrud.ts +0 -696
  467. package/src/adapters/kyselyInsights.spec.ts +0 -168
  468. package/src/adapters/kyselyQuery.ts +0 -128
  469. package/src/adapters/mongodb.spec.ts +0 -230
  470. package/src/adapters/mongodbCollections.ts +0 -78
  471. package/src/adapters/mongodbQuery.ts +0 -245
  472. package/src/adapters/mongodbReads.ts +0 -387
  473. package/src/adapters/mongodbRows.spec.ts +0 -64
  474. package/src/adapters/mongodbRows.ts +0 -118
  475. package/src/adapters/mongodbTestClient.ts +0 -443
  476. package/src/adapters/mongodbTestFilter.ts +0 -170
  477. package/src/adapters/mongodbWrites.ts +0 -261
  478. package/src/adapters/prismaInsights.ts +0 -190
  479. package/src/adapters/prismaQuery.ts +0 -129
  480. package/src/adapters/prismaRows.spec.ts +0 -98
  481. package/src/adapters/prismaRows.ts +0 -308
  482. package/src/adapters/prismaTestClient.ts +0 -478
  483. package/src/calculatePagination.ts +0 -34
  484. package/src/db/databasePluginCore.spec.ts +0 -62
  485. package/src/db/databasePluginCore.testFixtures.ts +0 -76
  486. package/src/db/databasePluginCore.ts +0 -185
  487. package/src/db/databasePluginUpdateCheck.bench.ts +0 -117
  488. package/src/db/fixedMigrator.spec.ts +0 -294
  489. package/src/db/fixedMigrator.ts +0 -147
  490. package/src/db/fixedMigratorMongo.spec.ts +0 -253
  491. package/src/db/fixedMigratorMongo.ts +0 -425
  492. package/src/db/hotUpdaterSchema.ts +0 -5
  493. package/src/db/mongoMigrationExecution.ts +0 -23
  494. package/src/db/schema/definitions.ts +0 -1
  495. package/src/db/schema/insightsCollation.ts +0 -21
  496. package/src/db/schema/mongodb.ts +0 -40
  497. package/src/db/schema/registry.ts +0 -55
  498. package/src/db/schema/sql.ts +0 -244
  499. package/src/db/schema/sqlOperations.ts +0 -63
  500. package/src/db/schema/types.ts +0 -1
  501. package/src/db/schemaGenerators.ts +0 -495
  502. package/src/db/schemaReadiness.ts +0 -34
  503. package/src/db/sqlMigrationExecution.spec.ts +0 -65
  504. package/src/db/sqlMigrationExecution.ts +0 -108
  505. package/src/db/types.spec.ts +0 -63
  506. package/src/handlerBundleRoutes.ts +0 -259
  507. package/src/handlerReleaseManagementRoutes.ts +0 -213
  508. package/src/schema/dsl-all-versions.spec.ts +0 -35
  509. package/src/schema/dsl.ts +0 -187
  510. package/src/schema/index.ts +0 -10
  511. package/src/schema/settings.ts +0 -15
  512. package/src/schema/types.ts +0 -79
  513. package/src/schema/v1_0_0.spec.ts +0 -220
  514. package/src/schema/v1_0_0.ts +0 -511
@@ -0,0 +1,48 @@
1
+ import { describe, expect, it } from "vitest";
2
+
3
+ import {
4
+ DatabaseConflictError,
5
+ DatabaseTransactionError,
6
+ } from "../database/errors";
7
+ import { isDatabaseBusyError } from "./errors";
8
+
9
+ const failure = (message: string, fields: object) =>
10
+ Object.assign(new Error(message), fields);
11
+
12
+ describe("isDatabaseBusyError", () => {
13
+ it.each([
14
+ [
15
+ "a transaction out of retries",
16
+ new DatabaseConflictError("The transaction conflicted 8 times."),
17
+ ],
18
+ [
19
+ "a throttled DynamoDB read",
20
+ failure("Throughput exceeds the current capacity of your table.", {
21
+ name: "ProvisionedThroughputExceededException",
22
+ }),
23
+ ],
24
+ ["an HTTP 429", failure("Too Many Requests", { status: 429 })],
25
+ [
26
+ "an AWS SDK 429",
27
+ failure("Too Many Requests", { $metadata: { httpStatusCode: 429 } }),
28
+ ],
29
+ [
30
+ "Firestore's RESOURCE_EXHAUSTED",
31
+ failure("8 RESOURCE_EXHAUSTED: Quota exceeded.", { code: 8 }),
32
+ ],
33
+ ])("holds for %s", (_case, error) => {
34
+ expect(isDatabaseBusyError(error)).toBe(true);
35
+ });
36
+
37
+ it.each([
38
+ ["a gauge below zero", new DatabaseTransactionError("gauge below zero")],
39
+ ["MongoDB's unknown error, also code 8", failure("unknown", { code: 8 })],
40
+ [
41
+ "a refused connection",
42
+ failure("connect ECONNREFUSED", { code: "ECONNREFUSED" }),
43
+ ],
44
+ ["a thrown string", "busy"],
45
+ ])("does not hold for %s", (_case, error) => {
46
+ expect(isDatabaseBusyError(error)).toBe(false);
47
+ });
48
+ });
@@ -1,3 +1,5 @@
1
+ import { DatabaseConflictError } from "../database/errors";
2
+
1
3
  export class InsightsBadRequestError extends Error {
2
4
  readonly name = "InsightsBadRequestError";
3
5
  }
@@ -9,3 +11,52 @@ export class InsightsPayloadTooLargeError extends Error {
9
11
  super(`Event payload exceeds ${maximumBytes} bytes`);
10
12
  }
11
13
  }
14
+
15
+ /** Error names the AWS SDKs give a throttled request, as their retry strategy classifies them. */
16
+ const THROTTLING_NAMES = new Set([
17
+ "ProvisionedThroughputExceededException",
18
+ "RequestLimitExceeded",
19
+ "RequestThrottled",
20
+ "RequestThrottledException",
21
+ "SlowDown",
22
+ "ThrottledException",
23
+ "Throttling",
24
+ "ThrottlingException",
25
+ "TooManyRequestsException",
26
+ ]);
27
+
28
+ /** gRPC's RESOURCE_EXHAUSTED, the status Firestore throttles a request with. */
29
+ const RESOURCE_EXHAUSTED = 8;
30
+
31
+ interface ErrorFields {
32
+ readonly name?: unknown;
33
+ readonly code?: unknown;
34
+ readonly message?: unknown;
35
+ readonly status?: unknown;
36
+ readonly statusCode?: unknown;
37
+ readonly $metadata?: { readonly httpStatusCode?: unknown };
38
+ }
39
+
40
+ /**
41
+ * Whether the database is busy rather than broken, so the same request can
42
+ * succeed later: a transaction ran out of retries, or the backend throttled
43
+ * a request. Writes already retry transient failures, throttled ones
44
+ * included, until the budget runs out. A throttled read throws the backend's
45
+ * own error, so it is recognized by what the backends call it: a name the
46
+ * AWS SDKs retry as throttling, HTTP 429, or gRPC's RESOURCE_EXHAUSTED.
47
+ */
48
+ export const isDatabaseBusyError = (error: unknown): boolean => {
49
+ if (error instanceof DatabaseConflictError) return true;
50
+ if (typeof error !== "object" || error === null) return false;
51
+ const { name, code, message, status, statusCode, $metadata } =
52
+ error as ErrorFields;
53
+ return (
54
+ (typeof name === "string" && THROTTLING_NAMES.has(name)) ||
55
+ [status, statusCode, $metadata?.httpStatusCode].includes(429) ||
56
+ // A gRPC error's message starts with its status name; other drivers use
57
+ // numeric codes too, such as MongoDB's 8 for an unknown error.
58
+ (code === RESOURCE_EXHAUSTED &&
59
+ typeof message === "string" &&
60
+ message.includes("RESOURCE_EXHAUSTED"))
61
+ );
62
+ };
@@ -1,4 +1,8 @@
1
- import { createUUIDv7, type BundleEventRow } from "@hot-updater/plugin-core";
1
+ import {
2
+ createUUIDv7,
3
+ isUUIDv7,
4
+ type BundleEventRow,
5
+ } from "@hot-updater/plugin-core";
2
6
 
3
7
  import type {
4
8
  CreateBundleEventRequest,
@@ -13,24 +17,6 @@ const MAX_EVENT_STRING_LENGTH = 1_024;
13
17
  const MAX_IDENTITY_LENGTH = 255;
14
18
  export const EVENT_BODY_MAX_BYTES = 16 * 1_024;
15
19
 
16
- const eventKeys = new Set([
17
- "type",
18
- "installId",
19
- "toBundleId",
20
- "userId",
21
- "username",
22
- "platform",
23
- "appVersion",
24
- "channel",
25
- "cohort",
26
- "fingerprintHash",
27
- "fromBundleId",
28
- "fromReleaseId",
29
- "toReleaseId",
30
- "updateStrategy",
31
- "sdkVersion",
32
- ]);
33
-
34
20
  function isRecord(value: unknown): value is Readonly<Record<string, unknown>> {
35
21
  return typeof value === "object" && value !== null && !Array.isArray(value);
36
22
  }
@@ -72,6 +58,21 @@ function requireIdentityField(
72
58
  return value;
73
59
  }
74
60
 
61
+ /**
62
+ * The report's idempotency key, when the client sends one: it creates the
63
+ * UUIDv7 once and repeats it on every retry of that report.
64
+ */
65
+ function readEventId(
66
+ payload: Readonly<Record<string, unknown>>,
67
+ ): string | undefined {
68
+ const value = payload.eventId;
69
+ if (value === undefined) return undefined;
70
+ if (!isUUIDv7(value)) {
71
+ throw new InsightsBadRequestError("Invalid event field: eventId");
72
+ }
73
+ return value;
74
+ }
75
+
75
76
  async function readBoundedText(request: Request): Promise<string> {
76
77
  const contentLength = request.headers.get("content-length");
77
78
  const declaredByteLength = Number(contentLength);
@@ -113,17 +114,18 @@ async function parseJson(request: Request): Promise<unknown> {
113
114
  }
114
115
 
115
116
  function requireEvent(payload: unknown): CreateBundleEventRequest {
116
- if (
117
- !isRecord(payload) ||
118
- Object.keys(payload).some((key) => !eventKeys.has(key))
119
- ) {
117
+ // Fields this server does not know are ignored, not refused, so a report
118
+ // from a newer SDK that adds one still records on an older server.
119
+ if (!isRecord(payload)) {
120
120
  throw new InsightsBadRequestError("Invalid event payload");
121
121
  }
122
122
  const platform = requireStringField(payload, "platform");
123
123
  if (platform !== "ios" && platform !== "android") {
124
124
  throw new InsightsBadRequestError("Invalid event field: platform");
125
125
  }
126
+ const eventId = readEventId(payload);
126
127
  const base: CreateBundleEventRequestBase = {
128
+ ...(eventId === undefined ? {} : { eventId }),
127
129
  installId: requireIdentityField(payload, "installId"),
128
130
  toBundleId: requireStringField(payload, "toBundleId"),
129
131
  ...(payload.userId === undefined
@@ -192,7 +194,8 @@ export function createBundleEventRow(
192
194
  app_version: input.appVersion,
193
195
  channel: input.channel,
194
196
  from_release_id: input.fromReleaseId,
195
- id: createUUIDv7(),
197
+ // The client's ID makes a retried report the same row, which records once.
198
+ id: input.eventId ?? createUUIDv7(),
196
199
  install_id: input.installId,
197
200
  platform: input.platform,
198
201
  received_at_ms: Date.now(),
@@ -1,9 +1,25 @@
1
+ import {
2
+ createMemoryAdapter,
3
+ type DatabaseAdapter,
4
+ } from "@hot-updater/plugin-core/internal";
1
5
  import { afterEach, describe, expect, it, vi } from "vitest";
2
6
 
3
- import { createInMemoryDatabasePlugin } from "../../../test-utils/test/inMemoryDatabasePlugin";
7
+ import { builtInSettings } from "../db/builtInDatabase";
4
8
  import { createHotUpdater } from "../index";
5
- import { createSchemaManagedDatabase } from "../runtime.testFixtures";
6
- import { HOT_UPDATER_SCHEMA_VERSION } from "../schema/types";
9
+ import { insights } from "../plugins/insights";
10
+ import {
11
+ createFencedDatabase,
12
+ createRuntimeDatabase,
13
+ } from "../runtime.testFixtures";
14
+ import { EVENT_BODY_MAX_BYTES } from "./eventInput";
15
+
16
+ /** A server with the Insights plugin on an empty in-memory database. */
17
+ const start = () =>
18
+ createHotUpdater({
19
+ database: createRuntimeDatabase(),
20
+ plugins: [insights()],
21
+ clientAccess: "public",
22
+ });
7
23
 
8
24
  const event = {
9
25
  appVersion: "1.0.0",
@@ -36,10 +52,7 @@ afterEach(() => {
36
52
 
37
53
  describe("createHotUpdater Insights", () => {
38
54
  it("ingests a downloaded bundle and exposes the running and pending state until apply", async () => {
39
- const hotUpdater = createHotUpdater({
40
- database: createInMemoryDatabasePlugin(),
41
- clientAccess: { type: "public" },
42
- });
55
+ const hotUpdater = start();
43
56
  const downloaded = {
44
57
  ...event,
45
58
  type: "UPDATE_DOWNLOADED",
@@ -96,12 +109,8 @@ describe("createHotUpdater Insights", () => {
96
109
  vi.useFakeTimers();
97
110
  vi.setSystemTime(new Date("2026-08-12T00:00:00.000Z"));
98
111
  const receivedAtMs = Date.now();
99
- const database = createInMemoryDatabasePlugin();
100
- const append = vi.spyOn(database.models.insights, "recordEvent");
101
- const hotUpdater = createHotUpdater({
102
- database,
103
- clientAccess: { type: "public" },
104
- });
112
+ const hotUpdater = start();
113
+ const append = vi.spyOn(hotUpdater.api.insights, "recordEvent");
105
114
 
106
115
  const ingestion = await hotUpdater.handlers.client(eventRequest());
107
116
  vi.advanceTimersByTime(1);
@@ -123,12 +132,10 @@ describe("createHotUpdater Insights", () => {
123
132
  expect(ingestion.status).toBe(204);
124
133
  expect(append).toHaveBeenCalledWith(
125
134
  expect.objectContaining({
126
- event: expect.objectContaining({
127
- install_id: "install-1",
128
- metadata: expect.objectContaining({ sdk_version: "2.0.0" }),
129
- to_bundle_id: "bundle-1",
130
- type: "UNCHANGED",
131
- }),
135
+ install_id: "install-1",
136
+ metadata: expect.objectContaining({ sdk_version: "2.0.0" }),
137
+ to_bundle_id: "bundle-1",
138
+ type: "UNCHANGED",
132
139
  }),
133
140
  );
134
141
  expect(events.status).toBe(200);
@@ -157,11 +164,13 @@ describe("createHotUpdater Insights", () => {
157
164
  nextCursor: null,
158
165
  });
159
166
  expect(active.status).toBe(200);
167
+ // Whole hours, ending with the current one.
168
+ const end = Date.parse("2026-08-12T01:00:00.000Z");
160
169
  await expect(active.json()).resolves.toEqual({
161
170
  platform: "ios",
162
171
  channel: "production",
163
- sinceMs: Date.now() - 24 * 60 * 60 * 1_000,
164
- beforeReceivedAtMs: Date.now(),
172
+ sinceMs: end - 24 * 60 * 60 * 1_000,
173
+ beforeReceivedAtMs: end,
165
174
  reportingInstallations: { count: 1, measuredAtMs: Date.now() },
166
175
  window: "24h",
167
176
  });
@@ -169,10 +178,7 @@ describe("createHotUpdater Insights", () => {
169
178
 
170
179
  it("serves scoped bundle counts and the same half-open recovery drill-down", async () => {
171
180
  vi.useFakeTimers();
172
- const hotUpdater = createHotUpdater({
173
- database: createInMemoryDatabasePlugin(),
174
- clientAccess: { type: "public" },
175
- });
181
+ const hotUpdater = start();
176
182
  const report = async (
177
183
  receivedAtMs: number,
178
184
  overrides: Record<string, unknown>,
@@ -216,7 +222,7 @@ describe("createHotUpdater Insights", () => {
216
222
  expect(overview.status).toBe(200);
217
223
  await expect(overview.json()).resolves.toMatchObject({
218
224
  sinceMs: 0,
219
- beforeReceivedAtMs: 500,
225
+ beforeReceivedAtMs: 60 * 60 * 1_000,
220
226
  reportingInstallations: { count: 2 },
221
227
  bundle: {
222
228
  bundleId: "B",
@@ -259,12 +265,11 @@ describe("createHotUpdater Insights", () => {
259
265
  "/events?bundleId=B",
260
266
  "/events?platform=ios&channel=production&bundleId=B&outcome=UNCHANGED",
261
267
  "/events?sinceMs=20&beforeReceivedAtMs=10",
268
+ // 90 days and 1 ms, longer than a bundle list covers.
269
+ "/events?platform=ios&channel=production&bundleId=B&outcome=applied&sinceMs=0&beforeReceivedAtMs=7776000001",
262
270
  "/installations/install-1/events?platform=ios&channel=production&bundleId=B&outcome=applied",
263
271
  ])("rejects ambiguous or invalid Insights query %s", async (path) => {
264
- const hotUpdater = createHotUpdater({
265
- database: createInMemoryDatabasePlugin(),
266
- clientAccess: { type: "public" },
267
- });
272
+ const hotUpdater = start();
268
273
  expect(
269
274
  (
270
275
  await hotUpdater.handlers.admin(
@@ -274,28 +279,46 @@ describe("createHotUpdater Insights", () => {
274
279
  ).toBe(400);
275
280
  });
276
281
 
277
- it("checks the official schema before Insights reads and writes", async () => {
278
- const database = createSchemaManagedDatabase(
279
- "kysely",
280
- HOT_UPDATER_SCHEMA_VERSION,
282
+ it("lists at most 90 days of events, and says so for a longer range", async () => {
283
+ const hotUpdater = start();
284
+ const range = "sinceMs=0&beforeReceivedAtMs=7776000001";
285
+ const events = await hotUpdater.handlers.admin(
286
+ new Request(`https://example.com/events?${range}`),
281
287
  );
282
- const createMigrator = vi.spyOn(database, "createMigrator");
283
- const hotUpdater = createHotUpdater({
284
- database,
285
- clientAccess: { type: "public" },
288
+ expect(events.status).toBe(400);
289
+ await expect(events.json()).resolves.toEqual({
290
+ error:
291
+ "Insights event lists cover at most 90 days: send a sinceMs no more than 90 days before beforeReceivedAtMs.",
286
292
  });
293
+ // An installation's history is one index range, however long.
294
+ const history = await hotUpdater.handlers.admin(
295
+ new Request(
296
+ `https://example.com/installations/install-1/events?${range}`,
297
+ ),
298
+ );
299
+ expect(history.status).toBe(200);
300
+ });
287
301
 
288
- expect((await hotUpdater.handlers.client(eventRequest())).status).toBe(204);
289
- await hotUpdater.insights.listEvents({});
302
+ it("checks the schema settings before Insights reads and writes", async () => {
303
+ const error = vi.spyOn(console, "error").mockImplementation(() => {});
304
+ const unmigrated = createHotUpdater({
305
+ database: await createFencedDatabase("kysely"),
306
+ plugins: [insights()],
307
+ clientAccess: "public",
308
+ });
309
+ const migrated = createHotUpdater({
310
+ database: await createFencedDatabase("kysely", builtInSettings),
311
+ plugins: [insights()],
312
+ clientAccess: "public",
313
+ });
290
314
 
291
- expect(createMigrator).toHaveBeenCalledOnce();
315
+ expect((await unmigrated.handlers.client(eventRequest())).status).toBe(503);
316
+ expect((await migrated.handlers.client(eventRequest())).status).toBe(204);
317
+ error.mockRestore();
292
318
  });
293
319
 
294
320
  it("keeps ingestion and queries on separate handler surfaces", async () => {
295
- const hotUpdater = createHotUpdater({
296
- database: createInMemoryDatabasePlugin(),
297
- clientAccess: { type: "public" },
298
- });
321
+ const hotUpdater = start();
299
322
 
300
323
  expect((await hotUpdater.handlers.client(eventRequest())).status).toBe(204);
301
324
  const clientQuery = await hotUpdater.handlers.client(
@@ -313,12 +336,8 @@ describe("createHotUpdater Insights", () => {
313
336
  });
314
337
 
315
338
  it("records same-file selection as no change and rejects a fourth event type", async () => {
316
- const database = createInMemoryDatabasePlugin();
317
- const recordEvent = vi.spyOn(database.models.insights, "recordEvent");
318
- const hotUpdater = createHotUpdater({
319
- database,
320
- clientAccess: { type: "public" },
321
- });
339
+ const hotUpdater = start();
340
+ const recordEvent = vi.spyOn(hotUpdater.api.insights, "recordEvent");
322
341
  const selection = {
323
342
  ...event,
324
343
  fromReleaseId: "previous-release",
@@ -327,8 +346,8 @@ describe("createHotUpdater Insights", () => {
327
346
  expect(
328
347
  (await hotUpdater.handlers.client(eventRequest(selection))).status,
329
348
  ).toBe(204);
330
- expect(recordEvent).toHaveBeenCalledWith({
331
- event: expect.objectContaining({
349
+ expect(recordEvent).toHaveBeenCalledWith(
350
+ expect.objectContaining({
332
351
  type: "UNCHANGED",
333
352
  from_bundle_id: null,
334
353
  metadata: expect.objectContaining({ update_strategy: null }),
@@ -336,7 +355,7 @@ describe("createHotUpdater Insights", () => {
336
355
  to_release_id: "selected-release",
337
356
  to_bundle_id: event.toBundleId,
338
357
  }),
339
- });
358
+ );
340
359
  const response = await hotUpdater.handlers.client(
341
360
  eventRequest({
342
361
  ...selection,
@@ -350,10 +369,7 @@ describe("createHotUpdater Insights", () => {
350
369
  });
351
370
 
352
371
  it("returns a stable client error for malformed event payloads", async () => {
353
- const hotUpdater = createHotUpdater({
354
- database: createInMemoryDatabasePlugin(),
355
- clientAccess: { type: "public" },
356
- });
372
+ const hotUpdater = start();
357
373
 
358
374
  const response = await hotUpdater.handlers.client(
359
375
  eventRequest({ ...event, platform: "web" }),
@@ -368,10 +384,7 @@ describe("createHotUpdater Insights", () => {
368
384
  it.each(["installId", "userId"] as const)(
369
385
  "rejects a 256-character event %s",
370
386
  async (field) => {
371
- const hotUpdater = createHotUpdater({
372
- database: createInMemoryDatabasePlugin(),
373
- clientAccess: { type: "public" },
374
- });
387
+ const hotUpdater = start();
375
388
 
376
389
  const response = await hotUpdater.handlers.client(
377
390
  eventRequest({ ...event, [field]: "x".repeat(256) }),
@@ -385,10 +398,7 @@ describe("createHotUpdater Insights", () => {
385
398
  );
386
399
 
387
400
  it("preserves a leading Unicode BOM in exact installation and current-user IDs", async () => {
388
- const hotUpdater = createHotUpdater({
389
- database: createInMemoryDatabasePlugin(),
390
- clientAccess: { type: "public" },
391
- });
401
+ const hotUpdater = start();
392
402
  const installId = "\uFEFFinstall";
393
403
  const userId = "\uFEFFuser";
394
404
  expect(
@@ -422,10 +432,7 @@ describe("createHotUpdater Insights", () => {
422
432
  it.each(["\uD800", "\uDC00"])(
423
433
  "rejects an unmatched surrogate identity %j",
424
434
  async (installId) => {
425
- const hotUpdater = createHotUpdater({
426
- database: createInMemoryDatabasePlugin(),
427
- clientAccess: { type: "public" },
428
- });
435
+ const hotUpdater = start();
429
436
  expect(
430
437
  (
431
438
  await hotUpdater.handlers.client(
@@ -437,10 +444,7 @@ describe("createHotUpdater Insights", () => {
437
444
  );
438
445
 
439
446
  it("rejects 256-character installation query identities", async () => {
440
- const hotUpdater = createHotUpdater({
441
- database: createInMemoryDatabasePlugin(),
442
- clientAccess: { type: "public" },
443
- });
447
+ const hotUpdater = start();
444
448
  const tooLong = "x".repeat(256);
445
449
 
446
450
  const user = await hotUpdater.handlers.admin(
@@ -457,10 +461,7 @@ describe("createHotUpdater Insights", () => {
457
461
  it.each(["fromReleaseId", "toReleaseId"] as const)(
458
462
  "rejects an omitted %s instead of treating it as null",
459
463
  async (field) => {
460
- const hotUpdater = createHotUpdater({
461
- database: createInMemoryDatabasePlugin(),
462
- clientAccess: { type: "public" },
463
- });
464
+ const hotUpdater = start();
464
465
  const payload: Record<string, unknown> = { ...event };
465
466
  delete payload[field];
466
467
 
@@ -472,4 +473,153 @@ describe("createHotUpdater Insights", () => {
472
473
  });
473
474
  },
474
475
  );
476
+
477
+ it("records a report with fields it does not know and still checks the ones it does", async () => {
478
+ const hotUpdater = start();
479
+ const newer = { ...event, networkType: "wifi", screen: { width: 390 } };
480
+
481
+ expect((await hotUpdater.handlers.client(eventRequest(newer))).status).toBe(
482
+ 204,
483
+ );
484
+ const installation = await hotUpdater.handlers.admin(
485
+ new Request("https://example.com/installations/install-1"),
486
+ );
487
+ await expect(installation.json()).resolves.toMatchObject({
488
+ installId: "install-1",
489
+ latestStatus: "UNCHANGED",
490
+ });
491
+ const invalid = await hotUpdater.handlers.client(
492
+ eventRequest({ ...newer, channel: 7 }),
493
+ );
494
+ expect(invalid.status).toBe(400);
495
+ await expect(invalid.json()).resolves.toEqual({
496
+ error: "Invalid event field: channel",
497
+ });
498
+ const tooLarge = await hotUpdater.handlers.client(
499
+ eventRequest({ ...newer, padding: "x".repeat(EVENT_BODY_MAX_BYTES) }),
500
+ );
501
+ expect(tooLarge.status).toBe(413);
502
+ });
503
+
504
+ it("counts a retried report once under its client event ID, whichever installation repeats it", async () => {
505
+ const hotUpdater = start();
506
+ const eventId = "01987a6e-4c00-7abc-8def-0123456789ab";
507
+ const report = { ...event, eventId };
508
+ const counts = async () => {
509
+ const overview = await hotUpdater.handlers.admin(
510
+ new Request(
511
+ "https://example.com/overview?platform=ios&channel=production&window=24h&bundleId=bundle-1",
512
+ ),
513
+ );
514
+ return (
515
+ (await overview.json()) as {
516
+ readonly bundle: { readonly unchangedReports: { count: number } };
517
+ }
518
+ ).bundle.unchangedReports.count;
519
+ };
520
+
521
+ for (let attempt = 0; attempt < 2; attempt += 1) {
522
+ expect(
523
+ (await hotUpdater.handlers.client(eventRequest(report))).status,
524
+ ).toBe(204);
525
+ }
526
+ await expect(counts()).resolves.toBe(1);
527
+ const events = await hotUpdater.handlers.admin(
528
+ new Request(
529
+ `https://example.com/events?beforeReceivedAtMs=${Date.now() + 1}`,
530
+ ),
531
+ );
532
+ await expect(events.json()).resolves.toMatchObject({
533
+ data: [{ id: eventId, installId: "install-1" }],
534
+ });
535
+
536
+ // A report under a stored ID changes nothing, as analytics ingestion
537
+ // drops duplicates.
538
+ expect(
539
+ (
540
+ await hotUpdater.handlers.client(
541
+ eventRequest({ ...report, installId: "install-2" }),
542
+ )
543
+ ).status,
544
+ ).toBe(204);
545
+ expect(
546
+ (
547
+ await hotUpdater.handlers.admin(
548
+ new Request("https://example.com/installations/install-2"),
549
+ )
550
+ ).status,
551
+ ).toBe(404);
552
+
553
+ // Without an ID the server creates one, so each report counts.
554
+ for (let attempt = 0; attempt < 2; attempt += 1) {
555
+ expect(
556
+ (await hotUpdater.handlers.client(eventRequest(event))).status,
557
+ ).toBe(204);
558
+ }
559
+ await expect(counts()).resolves.toBe(3);
560
+ });
561
+
562
+ it.each([
563
+ "event-1",
564
+ "01987A6E-4C00-7ABC-8DEF-0123456789AB",
565
+ "01987a6e-4c00-4abc-8def-0123456789ab",
566
+ null,
567
+ ])("rejects the event ID %j", async (eventId) => {
568
+ const hotUpdater = start();
569
+
570
+ const response = await hotUpdater.handlers.client(
571
+ eventRequest({ ...event, eventId }),
572
+ );
573
+
574
+ expect(response.status).toBe(400);
575
+ await expect(response.json()).resolves.toEqual({
576
+ error: "Invalid event field: eventId",
577
+ });
578
+ });
579
+
580
+ it("answers 503 with Retry-After while the database is busy, and 500 when it fails", async () => {
581
+ const error = vi.spyOn(console, "error").mockImplementation(() => {});
582
+ const warn = vi.spyOn(console, "warn").mockImplementation(() => {});
583
+ const on = (overrides: Partial<DatabaseAdapter>) =>
584
+ createHotUpdater({
585
+ database: {
586
+ name: "testDatabase",
587
+ adapter: { ...createMemoryAdapter(), ...overrides },
588
+ },
589
+ plugins: [insights()],
590
+ clientAccess: "public",
591
+ }).handlers.client(eventRequest());
592
+ const throttled = Object.assign(
593
+ new Error("The level of configured provisioned throughput was exceeded."),
594
+ { name: "ProvisionedThroughputExceededException" },
595
+ );
596
+
597
+ // Every write is refused as transient until the engine runs out of retries.
598
+ const busy = await on({ write: async () => ({ ok: false, retry: true }) });
599
+ expect(busy.status).toBe(503);
600
+ expect(busy.headers.get("retry-after")).toBe("5");
601
+ await expect(busy.json()).resolves.toEqual({
602
+ error: "Service unavailable",
603
+ });
604
+ // A throttled read throws the backend's own error.
605
+ const throttledRead = await on({
606
+ get: async () => {
607
+ throw throttled;
608
+ },
609
+ });
610
+ expect(throttledRead.status).toBe(503);
611
+ expect(throttledRead.headers.get("retry-after")).toBe("5");
612
+ const failed = await on({
613
+ get: async () => {
614
+ throw new Error("connection refused");
615
+ },
616
+ });
617
+ expect(failed.status).toBe(500);
618
+ expect(failed.headers.get("retry-after")).toBeNull();
619
+ // Each 503 warns, and only the failure logs as an error.
620
+ expect(warn).toHaveBeenCalledTimes(2);
621
+ expect(error).toHaveBeenCalledTimes(1);
622
+ error.mockRestore();
623
+ warn.mockRestore();
624
+ });
475
625
  });