@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,725 @@
1
+ import type { BundleEventRow } from "@hot-updater/plugin-core";
2
+ import {
3
+ addInsightsDistinct,
4
+ countInsightsDistinct,
5
+ createMemoryAdapter,
6
+ type DatabaseAdapter,
7
+ mergeInsightsDistinct,
8
+ } from "@hot-updater/plugin-core/internal";
9
+ import { createPluginTestHarness } from "@hot-updater/test-utils";
10
+ import { describe, expect, it } from "vitest";
11
+
12
+ import * as engine from "../../database";
13
+ import { InsightsBadRequestError } from "../../insights/errors";
14
+ import { createInsightsProvider } from "../../insights/provider";
15
+ import type { InsightsEventPageInput } from "../../insights/types";
16
+ import { createInsightsModel, insights } from "./index";
17
+
18
+ const HOUR = 3_600_000;
19
+ const DAY = 86_400_000;
20
+ const T0 = Date.UTC(2026, 8, 20);
21
+
22
+ const uuid = (n: number) =>
23
+ `00000000-0000-7000-8000-${String(n).padStart(12, "0")}`;
24
+
25
+ const event = (
26
+ n: number,
27
+ overrides: Partial<BundleEventRow> = {},
28
+ ): BundleEventRow =>
29
+ ({
30
+ id: uuid(n),
31
+ type: "UPDATE_APPLIED",
32
+ install_id: `install-${n}`,
33
+ user_id: "user-1",
34
+ from_release_id: "release-a",
35
+ from_bundle_id: "bundle-a",
36
+ to_release_id: "release-b",
37
+ to_bundle_id: "bundle-b",
38
+ platform: "ios",
39
+ app_version: "1.0.0",
40
+ channel: "production",
41
+ metadata: {
42
+ username: null,
43
+ cohort: "1",
44
+ update_strategy: "appVersion",
45
+ fingerprint_hash: null,
46
+ sdk_version: null,
47
+ },
48
+ received_at_ms: T0 + n * 10 * 60_000,
49
+ ...overrides,
50
+ }) as BundleEventRow;
51
+
52
+ /** The HLL estimate for these installs, as the stored sketches merge to. */
53
+ const distinct = (installs: readonly string[]) =>
54
+ countInsightsDistinct(
55
+ mergeInsightsDistinct(installs.map((id) => addInsightsDistinct(null, id))),
56
+ );
57
+ const installs = Array.from({ length: 24 }, (_, n) => `install-${n + 1}`);
58
+
59
+ /** Rows each table returned, and the point reads it served. */
60
+ const metered = (inner: DatabaseAdapter) => {
61
+ const rows = new Map<string, number>();
62
+ const add = (table: string, count: number) =>
63
+ rows.set(table, (rows.get(table) ?? 0) + count);
64
+ const adapter: DatabaseAdapter = {
65
+ ...inner,
66
+ get: async (table, keys) => {
67
+ const found = await inner.get(table, keys);
68
+ add(table.name, found.filter((row) => row !== null).length);
69
+ return found;
70
+ },
71
+ query: async (table, request) => {
72
+ const found = await inner.query(table, request);
73
+ add(table.name, found.length);
74
+ return found;
75
+ },
76
+ };
77
+ return { adapter, rows };
78
+ };
79
+
80
+ describe("insights latest events by bundle", () => {
81
+ const setup = () =>
82
+ createPluginTestHarness(insights(), { engine, now: () => T0 + DAY });
83
+ const halfPast = T0 + 30 * 60_000;
84
+
85
+ it("counts each latest event once for the overview's predicates, even from a bundle to itself", async () => {
86
+ const harness = await setup();
87
+ for (const [n, moved] of [
88
+ [31, { type: "UPDATE_APPLIED", from_bundle_id: "X", to_bundle_id: "X" }],
89
+ [
90
+ 32,
91
+ { type: "UPDATE_DOWNLOADED", from_bundle_id: "X", to_bundle_id: "X" },
92
+ ],
93
+ [33, { type: "RECOVERED", from_bundle_id: "X", to_bundle_id: "X" }],
94
+ [
95
+ 34,
96
+ { type: "UPDATE_DOWNLOADED", from_bundle_id: "X", to_bundle_id: "Y" },
97
+ ],
98
+ ] as const) {
99
+ await harness.api.recordEvent(
100
+ event(n, { ...moved, received_at_ms: halfPast }),
101
+ );
102
+ }
103
+ const bundle = [
104
+ { field: "from_bundle_id", value: "X", types: ["UPDATE_DOWNLOADED"] },
105
+ {
106
+ field: "to_bundle_id",
107
+ value: "X",
108
+ types: ["UNCHANGED", "UPDATE_APPLIED", "RECOVERED"],
109
+ },
110
+ ] as const;
111
+ // Whole hours from gauges, then a partial hour from heads.
112
+ for (const sinceMs of [T0, T0 + 1]) {
113
+ await expect(
114
+ harness.api.countLatestEvents({
115
+ platform: "ios",
116
+ channel: "production",
117
+ sinceMs,
118
+ bundle,
119
+ }),
120
+ ).resolves.toBe(4);
121
+ }
122
+ });
123
+
124
+ it("counts a head once when a from and a to predicate of one type both match it", async () => {
125
+ const harness = await setup();
126
+ for (const [n, moved] of [
127
+ [21, { from_bundle_id: "A", to_bundle_id: "B" }],
128
+ [22, { from_bundle_id: "A", to_bundle_id: "C" }],
129
+ [23, { from_bundle_id: "D", to_bundle_id: "B" }],
130
+ [24, { from_bundle_id: "B", to_bundle_id: "B" }],
131
+ ] as const) {
132
+ await harness.api.recordEvent(
133
+ event(n, {
134
+ ...moved,
135
+ type: "UPDATE_DOWNLOADED",
136
+ received_at_ms: halfPast,
137
+ }),
138
+ );
139
+ }
140
+ const types = ["UPDATE_DOWNLOADED"] as const;
141
+ const count = (
142
+ bundle: readonly {
143
+ readonly field: "from_bundle_id" | "to_bundle_id";
144
+ readonly value: string;
145
+ readonly types: readonly "UPDATE_DOWNLOADED"[];
146
+ }[],
147
+ sinceMs: number,
148
+ ) =>
149
+ harness.api.countLatestEvents({
150
+ platform: "ios",
151
+ channel: "production",
152
+ sinceMs,
153
+ bundle,
154
+ });
155
+ // Whole hours from gauges, then a partial hour from heads.
156
+ for (const sinceMs of [T0, T0 + 1]) {
157
+ // From A or to B: A→B, A→C, D→B, and B→B. The gauges alone say 5,
158
+ // counting A→B under both predicates.
159
+ await expect(
160
+ count(
161
+ [
162
+ { field: "from_bundle_id", value: "A", types },
163
+ { field: "to_bundle_id", value: "B", types },
164
+ ],
165
+ sinceMs,
166
+ ),
167
+ ).resolves.toBe(4);
168
+ // B→B matches from B and to B through one pair: A→B, D→B, B→B.
169
+ await expect(
170
+ count(
171
+ [
172
+ { field: "from_bundle_id", value: "B", types },
173
+ { field: "to_bundle_id", value: "B", types },
174
+ ],
175
+ sinceMs,
176
+ ),
177
+ ).resolves.toBe(3);
178
+ }
179
+ });
180
+ });
181
+
182
+ describe("insights read budgets", () => {
183
+ const setup = async () => {
184
+ const meter = metered(createMemoryAdapter());
185
+ const harness = await createPluginTestHarness(insights(), {
186
+ engine,
187
+ adapter: meter.adapter,
188
+ now: () => T0 + 30 * DAY,
189
+ });
190
+ for (let n = 1; n <= 24; n += 1) await harness.api.recordEvent(event(n));
191
+ await harness.api.recordEvent(
192
+ event(25, { install_id: "install-1", received_at_ms: T0 + 2 * DAY }),
193
+ );
194
+ meter.rows.clear();
195
+ const read = async <T>(call: () => Promise<T>) => {
196
+ meter.rows.clear();
197
+ const measured = await harness.measureReads(call);
198
+ return { ...measured, tables: Object.fromEntries(meter.rows) };
199
+ };
200
+ return { api: harness.api, read };
201
+ };
202
+
203
+ it("lists and finds events reading the rows they return, and one outcome row to cross an empty day", async () => {
204
+ const { api, read } = await setup();
205
+ const listed = await read(() =>
206
+ api.listEvents({
207
+ filter: {
208
+ kind: "bundle",
209
+ platform: "ios",
210
+ channel: "production",
211
+ type: "UPDATE_APPLIED",
212
+ toBundleId: "bundle-b",
213
+ },
214
+ sinceMs: T0,
215
+ beforeReceivedAtMs: T0 + 3 * DAY,
216
+ limit: 5,
217
+ }),
218
+ );
219
+ expect(listed.result.map(({ id }) => id)).toEqual(
220
+ [25, 24, 23, 22, 21].map(uuid),
221
+ );
222
+ // Day 2 holds event 25 and day 1 nothing, so one outcome row, hour 4 of
223
+ // day 0, names the day below it.
224
+ expect(listed.adapter).toMatchObject({ queries: 4, rows: 6 });
225
+ expect(listed.tables).toEqual({ bundle_events: 5, insights_outcomes: 1 });
226
+
227
+ const head = await read(() =>
228
+ api.findLatestEvents({ installId: "install-1" }),
229
+ );
230
+ expect(head.result.map(({ id }) => id)).toEqual([uuid(25)]);
231
+ expect(head.adapter).toMatchObject({ gets: 1, queries: 0 });
232
+
233
+ const user = await read(() =>
234
+ api.findLatestEvents({ userId: "user-1", limit: 3 }),
235
+ );
236
+ expect(user.result.map(({ install_id }) => install_id)).toEqual([
237
+ "install-1",
238
+ "install-10",
239
+ "install-11",
240
+ ]);
241
+ expect(user.tables).toEqual({ bundle_event_heads: 3 });
242
+ });
243
+
244
+ it("counts whole-hour windows from aggregates alone", async () => {
245
+ const { api, read } = await setup();
246
+ const counted = await read(() =>
247
+ api.countEvents({
248
+ filter: {
249
+ platform: "ios",
250
+ channel: "production",
251
+ type: "UPDATE_APPLIED",
252
+ toBundleId: "bundle-b",
253
+ },
254
+ sinceMs: T0,
255
+ beforeReceivedAtMs: T0 + 2 * HOUR,
256
+ }),
257
+ );
258
+ expect(counted.result).toBe(11);
259
+ expect(Object.keys(counted.tables)).toEqual(["insights_outcomes"]);
260
+
261
+ const latest = await read(() =>
262
+ api.countLatestEvents({
263
+ platform: "ios",
264
+ channel: "production",
265
+ sinceMs: T0 + HOUR,
266
+ }),
267
+ );
268
+ // installs 6–24, plus install-1, whose head moved to day 2
269
+ expect(latest.result).toBe(20);
270
+ expect(Object.keys(latest.tables)).toEqual(["insights_distribution"]);
271
+
272
+ const byBundle = await read(() =>
273
+ api.countLatestEvents({
274
+ platform: "ios",
275
+ channel: "production",
276
+ sinceMs: T0,
277
+ bundle: [
278
+ {
279
+ field: "to_bundle_id",
280
+ value: "bundle-b",
281
+ types: ["UPDATE_APPLIED"],
282
+ },
283
+ ],
284
+ }),
285
+ );
286
+ expect(byBundle.result).toBe(24);
287
+ expect(Object.keys(byBundle.tables)).toEqual(["insights_latest_by_bundle"]);
288
+ });
289
+
290
+ it("reads release activity and app usage from counters, sketches, and gauges only", async () => {
291
+ const { api, read } = await setup();
292
+ const lifetime = await read(() =>
293
+ api.getReleaseActivity({
294
+ releases: [
295
+ { releaseId: "release-b", platform: "ios", channel: "production" },
296
+ ],
297
+ }),
298
+ );
299
+ expect(lifetime.result.data[0]!.metrics).toEqual({
300
+ downloads: 0,
301
+ launches: 25,
302
+ failedLaunches: 0,
303
+ });
304
+ expect(Object.keys(lifetime.tables)).toEqual(["insights_overview"]);
305
+
306
+ const scope = await read(() =>
307
+ api.getReleaseActivity({
308
+ scope: { platform: "ios", channel: "production" },
309
+ timeRange: { start: T0, end: T0 + 3 * DAY },
310
+ }),
311
+ );
312
+ expect(scope.result.data[0]!.metrics).toMatchObject({
313
+ launches: 25,
314
+ uniqueUsers: distinct(installs),
315
+ series: [
316
+ { startMs: T0, launches: 24, failedLaunches: 0 },
317
+ { startMs: T0 + 2 * DAY, launches: 1, failedLaunches: 0 },
318
+ ],
319
+ });
320
+ expect(Object.keys(scope.tables).toSorted()).toEqual([
321
+ "insights_overview",
322
+ "insights_sketches",
323
+ ]);
324
+
325
+ const usage = await read(() =>
326
+ api.getAppUsage({
327
+ channel: "production",
328
+ platform: "all",
329
+ timeRange: { start: T0, end: T0 + 3 * DAY },
330
+ intervalMs: DAY,
331
+ }),
332
+ );
333
+ expect(usage.result).toMatchObject({
334
+ activeInstallations: distinct(installs),
335
+ points: [
336
+ { startMs: T0, installations: distinct(installs) },
337
+ { startMs: T0 + DAY, installations: 0 },
338
+ { startMs: T0 + 2 * DAY, installations: 1 },
339
+ ],
340
+ versions: [{ name: "1.0.0", installations: 24 }],
341
+ bundleDistribution: [
342
+ {
343
+ appVersion: "1.0.0",
344
+ platform: "ios",
345
+ releaseId: "release-b",
346
+ installations: 24,
347
+ },
348
+ ],
349
+ });
350
+ expect(Object.keys(usage.tables).toSorted()).toEqual([
351
+ "insights_distribution",
352
+ "insights_sketches",
353
+ ]);
354
+ });
355
+ });
356
+
357
+ /**
358
+ * The reads an event list makes, in order: each UTC day it reads, as days
359
+ * from T0, with the rows it found; and each outcome read, with the day it
360
+ * named.
361
+ */
362
+ const traced = (inner: DatabaseAdapter) => {
363
+ const reads: string[] = [];
364
+ const day = (ms: number) => `day ${(ms - (ms % DAY) - T0) / DAY}`;
365
+ const adapter: DatabaseAdapter = {
366
+ ...inner,
367
+ query: async (table, request) => {
368
+ const found = await inner.query(table, request);
369
+ if (table.name === "bundle_events") {
370
+ reads.push(`${day(Number(request.eq.at(-1)))}: ${found.length}`);
371
+ }
372
+ if (table.name === "insights_outcomes") {
373
+ const newest = found[0]?.bucket_start_ms;
374
+ reads.push(
375
+ `hint: ${newest === undefined ? "none" : day(Number(newest))}`,
376
+ );
377
+ }
378
+ return found;
379
+ },
380
+ };
381
+ return { adapter, reads };
382
+ };
383
+
384
+ const newestFirst = (left: BundleEventRow, right: BundleEventRow) =>
385
+ right.received_at_ms - left.received_at_ms ||
386
+ (right.id < left.id ? -1 : right.id > left.id ? 1 : 0);
387
+
388
+ describe("insights event list ranges", () => {
389
+ /** The cutoff: noon of T0's day, so the range starts at noon 90 days before. */
390
+ const before = T0 + 12 * HOUR;
391
+ const bundleB = {
392
+ kind: "bundle",
393
+ platform: "ios",
394
+ channel: "production",
395
+ type: "UPDATE_APPLIED",
396
+ toBundleId: "bundle-b",
397
+ } as const;
398
+
399
+ const setup = async () => {
400
+ const trace = traced(createMemoryAdapter());
401
+ const harness = await createPluginTestHarness(insights(), {
402
+ engine,
403
+ adapter: trace.adapter,
404
+ now: () => before,
405
+ });
406
+ const provider = createInsightsProvider(createInsightsModel(harness.api));
407
+ const record = async (
408
+ events: readonly (readonly [number, number, Partial<BundleEventRow>?])[],
409
+ ) => {
410
+ for (const [n, receivedAtMs, overrides] of events) {
411
+ await harness.api.recordEvent(
412
+ event(n, { ...overrides, received_at_ms: receivedAtMs }),
413
+ );
414
+ }
415
+ };
416
+ /** Every page of one provider list, with the reads each made. */
417
+ const pages = async (input: InsightsEventPageInput) => {
418
+ const listed: { ids: string[]; reads: string[]; full: boolean }[] = [];
419
+ let cursor: string | undefined;
420
+ do {
421
+ trace.reads.length = 0;
422
+ const page = await provider.listEvents({
423
+ ...input,
424
+ ...(cursor === undefined ? {} : { cursor }),
425
+ });
426
+ listed.push({
427
+ ids: page.data.map(({ id }) => id),
428
+ reads: [...trace.reads],
429
+ full: page.data.length === input.limit,
430
+ });
431
+ cursor = page.nextCursor ?? undefined;
432
+ } while (cursor !== undefined);
433
+ return listed;
434
+ };
435
+ return { harness, provider, record, pages, reads: trace.reads };
436
+ };
437
+
438
+ it("rejects a global or bundle range over 90 days, not installation history", async () => {
439
+ const { harness } = await setup();
440
+ for (const filter of [{ kind: "all" } as const, bundleB]) {
441
+ const input = { filter, beforeReceivedAtMs: before, limit: 5 };
442
+ await expect(
443
+ harness.api.listEvents({ ...input, sinceMs: before - 90 * DAY }),
444
+ ).resolves.toEqual([]);
445
+ for (const sinceMs of [before - 90 * DAY - 1, undefined]) {
446
+ await expect(
447
+ harness.api.listEvents({ ...input, sinceMs }),
448
+ ).rejects.toMatchObject({ code: "invalid-query" });
449
+ }
450
+ }
451
+ await expect(
452
+ harness.api.listEvents({
453
+ filter: { kind: "installationMovement", installId: "install-1" },
454
+ beforeReceivedAtMs: before,
455
+ limit: 5,
456
+ }),
457
+ ).resolves.toEqual([]);
458
+ });
459
+
460
+ it("takes exactly 90 × 24 hours ending mid-day, 91 UTC days, and pages them to the start", async () => {
461
+ const { harness, provider, record, pages } = await setup();
462
+ // As the console's "Last 90 days" asks: the cutoff is not a midnight, so
463
+ // the range starts at noon of its 91st UTC day.
464
+ const since = before - 90 * DAY;
465
+ await record([
466
+ [1, before - 1],
467
+ [2, T0 - 45 * DAY],
468
+ [3, since + 1],
469
+ [4, since],
470
+ [5, since - 1],
471
+ ]);
472
+ const listed = await pages({
473
+ sinceMs: since,
474
+ beforeReceivedAtMs: before,
475
+ limit: 2,
476
+ });
477
+ expect(listed).toEqual([
478
+ {
479
+ ids: [1, 2].map(uuid),
480
+ reads: ["day 0: 1", "day -1: 0", "hint: day -45", "day -45: 1"],
481
+ full: true,
482
+ },
483
+ {
484
+ ids: [3, 4].map(uuid),
485
+ reads: ["day -45: 0", "hint: day -90", "day -90: 2"],
486
+ full: true,
487
+ },
488
+ { ids: [], reads: ["day -90: 0"], full: false },
489
+ ]);
490
+ // One millisecond longer is refused by the plugin and by the provider.
491
+ await expect(
492
+ harness.api.listEvents({
493
+ filter: { kind: "all" },
494
+ sinceMs: since - 1,
495
+ beforeReceivedAtMs: before,
496
+ limit: 2,
497
+ }),
498
+ ).rejects.toMatchObject({ code: "invalid-query" });
499
+ await expect(
500
+ provider.listEvents({ sinceMs: since - 1, beforeReceivedAtMs: before }),
501
+ ).rejects.toBeInstanceOf(InsightsBadRequestError);
502
+ });
503
+
504
+ it("reads an empty range as its top day and one hint, and a dense day as one query", async () => {
505
+ const { harness, record, reads } = await setup();
506
+ // A day below the range, and past the cutoff on its top day.
507
+ await record([
508
+ [1, before - 91 * DAY],
509
+ [2, before],
510
+ ]);
511
+ const list = (filter: typeof bundleB | { readonly kind: "all" }) =>
512
+ harness.measureReads(() =>
513
+ harness.api.listEvents({
514
+ filter,
515
+ sinceMs: before - 90 * DAY,
516
+ beforeReceivedAtMs: before,
517
+ limit: 4,
518
+ }),
519
+ );
520
+ for (const filter of [{ kind: "all" } as const, bundleB]) {
521
+ reads.length = 0;
522
+ const empty = await list(filter);
523
+ expect(empty.result).toEqual([]);
524
+ expect(empty.adapter).toEqual({ gets: 0, keys: 0, queries: 2, rows: 0 });
525
+ expect(reads).toEqual(["day 0: 0", "hint: none"]);
526
+ }
527
+ await record([3, 4, 5, 6, 7].map((n) => [n, T0 + n * HOUR] as const));
528
+ for (const filter of [{ kind: "all" } as const, bundleB]) {
529
+ reads.length = 0;
530
+ const dense = await list(filter);
531
+ expect(dense.result.map(({ id }) => id)).toEqual([7, 6, 5, 4].map(uuid));
532
+ expect(dense.adapter).toEqual({ gets: 0, keys: 0, queries: 1, rows: 4 });
533
+ expect(reads).toEqual(["day 0: 4"]);
534
+ }
535
+ });
536
+
537
+ it("crosses gaps of months with one empty day and one hint each, and fills every page down to the range start", async () => {
538
+ const { record, pages } = await setup();
539
+ const since = before - 90 * DAY;
540
+ await record([
541
+ [1, T0 - 40 * DAY + 3 * HOUR],
542
+ [2, T0 - 40 * DAY + 2 * HOUR],
543
+ [3, T0 - 40 * DAY + HOUR],
544
+ [4, T0 - 80 * DAY + 12 * HOUR],
545
+ [5, T0 - 80 * DAY + 11 * HOUR],
546
+ // The range's first day holds events on both sides of its start.
547
+ [6, since + HOUR],
548
+ [7, since - HOUR],
549
+ // Below the range, and past the cutoff on its top day.
550
+ [8, T0 - 100 * DAY],
551
+ [9, before + HOUR],
552
+ ]);
553
+ // Without `sinceMs`, the range is the 90 days before the cutoff.
554
+ const listed = await pages({ beforeReceivedAtMs: before, limit: 4 });
555
+ expect(listed).toEqual([
556
+ {
557
+ ids: [1, 2, 3, 4].map(uuid),
558
+ reads: [
559
+ "day 0: 0",
560
+ "hint: day -40",
561
+ "day -40: 3",
562
+ "day -41: 0",
563
+ "hint: day -80",
564
+ "day -80: 1",
565
+ ],
566
+ full: true,
567
+ },
568
+ {
569
+ // The last page ends at the range's last event, with no cursor.
570
+ ids: [5, 6].map(uuid),
571
+ reads: ["day -80: 1", "day -81: 0", "hint: day -90", "day -90: 1"],
572
+ full: false,
573
+ },
574
+ ]);
575
+ // Only the day read before each hint is empty, however long the gap.
576
+ for (const { reads } of listed) {
577
+ reads.forEach((read, index) => {
578
+ if (read.endsWith(": 0")) expect(reads[index + 1]).toMatch(/^hint/);
579
+ });
580
+ }
581
+ });
582
+
583
+ it("crosses a bundle's gaps on its own outcome rows, whatever other bundles hold", async () => {
584
+ const { record, pages } = await setup();
585
+ const bundleC = { to_bundle_id: "bundle-c" };
586
+ await record([
587
+ [1, T0 - DAY],
588
+ [2, T0 - 2 * DAY, bundleC],
589
+ [3, T0 - 3 * DAY, bundleC],
590
+ [4, T0 - 30 * DAY, bundleC],
591
+ [5, T0 - 50 * DAY + 2 * HOUR],
592
+ [6, T0 - 50 * DAY + HOUR],
593
+ ]);
594
+ const listed = await pages({
595
+ bundle: {
596
+ platform: "ios",
597
+ channel: "production",
598
+ bundleId: "bundle-b",
599
+ outcome: "applied",
600
+ },
601
+ beforeReceivedAtMs: before,
602
+ limit: 5,
603
+ });
604
+ expect(listed).toEqual([
605
+ {
606
+ ids: [1, 5, 6].map(uuid),
607
+ // Days -3 and -30 hold only bundle-c's events and are never read;
608
+ // day -2 is the one empty day before a hint.
609
+ reads: [
610
+ "day 0: 0",
611
+ "hint: day -1",
612
+ "day -1: 1",
613
+ "day -2: 0",
614
+ "hint: day -50",
615
+ "day -50: 2",
616
+ "day -51: 0",
617
+ "hint: none",
618
+ ],
619
+ full: false,
620
+ },
621
+ ]);
622
+ });
623
+
624
+ it("lists every event in the range, alone in a gap or recorded in one while paging", async () => {
625
+ const { harness, provider, record } = await setup();
626
+ await record(
627
+ [0, -1, -17, -53, -54, -88, -89].map(
628
+ (day, index) => [index + 1, T0 + day * DAY + HOUR] as const,
629
+ ),
630
+ );
631
+ const listed: string[] = [];
632
+ let cursor: string | undefined;
633
+ do {
634
+ const page = await provider.listEvents({
635
+ beforeReceivedAtMs: before,
636
+ limit: 2,
637
+ ...(cursor === undefined ? {} : { cursor }),
638
+ });
639
+ if (cursor === undefined) {
640
+ // Below the first page, in the gap between days -17 and -53.
641
+ await harness.api.recordEvent(
642
+ event(8, { received_at_ms: T0 - 30 * DAY }),
643
+ );
644
+ }
645
+ listed.push(...page.data.map(({ id }) => id));
646
+ cursor = page.nextCursor ?? undefined;
647
+ } while (cursor !== undefined);
648
+ expect(listed).toEqual([1, 2, 3, 8, 4, 5, 6, 7].map(uuid));
649
+ });
650
+
651
+ it("pages exactly the events in the range, newest first, whatever the limit", async () => {
652
+ const { harness, pages } = await setup();
653
+ const since = T0 - 80 * DAY + 5 * HOUR;
654
+ let seed = 7;
655
+ const random = () =>
656
+ (seed = (seed * 48_271) % 2_147_483_647) / 2_147_483_647;
657
+ const times = [
658
+ since - 1,
659
+ since,
660
+ before - 1,
661
+ before,
662
+ T0 - 30 * DAY,
663
+ T0 - 30 * DAY - 1,
664
+ ...Array.from(
665
+ { length: 54 },
666
+ () => T0 - 100 * DAY + Math.floor(random() * 101 * DAY),
667
+ ),
668
+ ];
669
+ const events = times.map((receivedAtMs, index) =>
670
+ event(index + 1, {
671
+ received_at_ms: receivedAtMs,
672
+ ...(index % 3 === 0
673
+ ? { type: "RECOVERED", from_bundle_id: "bundle-b" }
674
+ : { to_bundle_id: index % 3 === 1 ? "bundle-b" : "bundle-c" }),
675
+ }),
676
+ );
677
+ for (const row of events) await harness.api.recordEvent(row);
678
+ const selections = [
679
+ [undefined, () => true],
680
+ [
681
+ "applied",
682
+ (row: BundleEventRow) =>
683
+ row.type === "UPDATE_APPLIED" && row.to_bundle_id === "bundle-b",
684
+ ],
685
+ [
686
+ "recovered",
687
+ (row: BundleEventRow) =>
688
+ row.type === "RECOVERED" && row.from_bundle_id === "bundle-b",
689
+ ],
690
+ ] as const;
691
+ for (const [outcome, matches] of selections) {
692
+ const expected = events
693
+ .filter(
694
+ (row) =>
695
+ matches(row) &&
696
+ row.received_at_ms >= since &&
697
+ row.received_at_ms < before,
698
+ )
699
+ .toSorted(newestFirst)
700
+ .map(({ id }) => id);
701
+ for (const limit of [1, 3, 8]) {
702
+ const listed = await pages({
703
+ ...(outcome === undefined
704
+ ? {}
705
+ : {
706
+ bundle: {
707
+ platform: "ios",
708
+ channel: "production",
709
+ bundleId: "bundle-b",
710
+ outcome,
711
+ },
712
+ }),
713
+ sinceMs: since,
714
+ beforeReceivedAtMs: before,
715
+ limit,
716
+ });
717
+ expect(listed.flatMap(({ ids }) => ids)).toEqual(expected);
718
+ // Every page but the last is full; the last is empty only after a
719
+ // full page that ended at the range's last event.
720
+ expect(listed.slice(0, -1).every(({ full }) => full)).toBe(true);
721
+ expect(listed.at(-1)!.ids.length).toBe(expected.length % limit);
722
+ }
723
+ }
724
+ });
725
+ });