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

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 (213) hide show
  1. package/dist/_virtual/_rolldown/runtime.cjs +1 -1
  2. package/dist/adapters/databaseConstraintErrors.cjs +0 -1
  3. package/dist/adapters/databasePluginUtils.cjs +14 -1
  4. package/dist/adapters/databasePluginUtils.mjs +14 -2
  5. package/dist/adapters/drizzle.cjs +9 -4
  6. package/dist/adapters/drizzle.d.cts +0 -1
  7. package/dist/adapters/drizzle.d.mts +0 -1
  8. package/dist/adapters/drizzle.mjs +10 -4
  9. package/dist/adapters/drizzleCrud.cjs +93 -3
  10. package/dist/adapters/drizzleCrud.mjs +93 -5
  11. package/dist/adapters/drizzleLazyDB.cjs +2 -0
  12. package/dist/adapters/drizzleLazyDB.mjs +2 -0
  13. package/dist/adapters/drizzleQuery.cjs +3 -2
  14. package/dist/adapters/drizzleQuery.mjs +3 -1
  15. package/dist/adapters/kysely.cjs +1 -1
  16. package/dist/adapters/kysely.d.cts +0 -1
  17. package/dist/adapters/kysely.d.mts +0 -1
  18. package/dist/adapters/kysely.mjs +2 -1
  19. package/dist/adapters/kyselyCrud.cjs +44 -5
  20. package/dist/adapters/kyselyCrud.mjs +45 -6
  21. package/dist/adapters/kyselyQuery.cjs +2 -2
  22. package/dist/adapters/kyselyQuery.mjs +2 -1
  23. package/dist/adapters/mongodb.cjs +36 -1
  24. package/dist/adapters/mongodb.d.cts +1 -1
  25. package/dist/adapters/mongodb.d.mts +1 -1
  26. package/dist/adapters/mongodb.mjs +36 -0
  27. package/dist/adapters/mongodbCollections.cjs +2 -0
  28. package/dist/adapters/mongodbCollections.mjs +2 -0
  29. package/dist/adapters/mongodbQuery.cjs +17 -4
  30. package/dist/adapters/mongodbQuery.mjs +17 -4
  31. package/dist/adapters/mongodbReads.cjs +88 -30
  32. package/dist/adapters/mongodbReads.mjs +88 -29
  33. package/dist/adapters/mongodbWrites.cjs +1 -2
  34. package/dist/adapters/mongodbWrites.mjs +1 -1
  35. package/dist/adapters/prisma.cjs +44 -7
  36. package/dist/adapters/prisma.d.cts +0 -1
  37. package/dist/adapters/prisma.d.mts +0 -1
  38. package/dist/adapters/prisma.mjs +44 -6
  39. package/dist/adapters/prismaInsights.cjs +99 -0
  40. package/dist/adapters/prismaInsights.mjs +97 -0
  41. package/dist/adapters/prismaQuery.cjs +0 -1
  42. package/dist/adapters/prismaRows.cjs +7 -8
  43. package/dist/adapters/prismaRows.mjs +8 -8
  44. package/dist/apiKeys.cjs +6 -2
  45. package/dist/apiKeys.d.cts +0 -1
  46. package/dist/apiKeys.d.mts +0 -1
  47. package/dist/apiKeys.mjs +3 -3
  48. package/dist/createHotUpdaterCore.cjs +27 -12
  49. package/dist/createHotUpdaterCore.d.cts +8 -8
  50. package/dist/createHotUpdaterCore.d.mts +8 -8
  51. package/dist/createHotUpdaterCore.mjs +26 -12
  52. package/dist/db/createBundleDiff.cjs +2 -2
  53. package/dist/db/createBundleDiff.d.cts +1 -5
  54. package/dist/db/createBundleDiff.d.mts +1 -5
  55. package/dist/db/databasePluginCore.cjs +0 -1
  56. package/dist/db/fixedMigrator.cjs +2 -2
  57. package/dist/db/fixedMigrator.mjs +2 -2
  58. package/dist/db/fixedMigratorMongo.cjs +6 -4
  59. package/dist/db/fixedMigratorMongo.mjs +6 -4
  60. package/dist/db/index.d.cts +0 -1
  61. package/dist/db/index.d.mts +0 -1
  62. package/dist/db/releaseCatalog.cjs +0 -1
  63. package/dist/db/releaseCatalog.d.cts +0 -1
  64. package/dist/db/releaseCatalog.d.mts +0 -1
  65. package/dist/db/schema/insightsCollation.cjs +14 -0
  66. package/dist/db/schema/insightsCollation.mjs +14 -0
  67. package/dist/db/schema/sql.cjs +11 -7
  68. package/dist/db/schema/sql.mjs +8 -8
  69. package/dist/db/schemaGenerators.cjs +29 -9
  70. package/dist/db/schemaGenerators.mjs +29 -9
  71. package/dist/db/schemaReadiness.cjs +2 -0
  72. package/dist/db/schemaReadiness.d.cts +1 -0
  73. package/dist/db/schemaReadiness.d.mts +1 -0
  74. package/dist/db/schemaReadiness.mjs +2 -0
  75. package/dist/db/sqlMigrationExecution.cjs +1 -1
  76. package/dist/db/sqlMigrationExecution.mjs +1 -0
  77. package/dist/db/types.cjs +3 -1
  78. package/dist/db/types.d.cts +3 -6
  79. package/dist/db/types.d.mts +3 -6
  80. package/dist/db/types.mjs +2 -2
  81. package/dist/db/updateArtifacts.cjs +0 -1
  82. package/dist/handler.cjs +5 -5
  83. package/dist/handler.d.cts +1 -2
  84. package/dist/handler.d.mts +1 -2
  85. package/dist/handler.mjs +5 -5
  86. package/dist/handlerReleaseCatalogRoutes.cjs +0 -1
  87. package/dist/handlerReleaseManagementRoutes.cjs +0 -1
  88. package/dist/handlerTypes.d.cts +0 -1
  89. package/dist/handlerTypes.d.mts +0 -1
  90. package/dist/handlerVersionRoutes.d.cts +1 -0
  91. package/dist/handlerVersionRoutes.d.mts +1 -0
  92. package/dist/index.cjs +2 -2
  93. package/dist/index.d.cts +4 -4
  94. package/dist/index.d.mts +4 -4
  95. package/dist/index.mjs +2 -2
  96. package/dist/insights/domain.d.cts +92 -0
  97. package/dist/insights/domain.d.mts +92 -0
  98. package/dist/insights/errors.cjs +15 -0
  99. package/dist/insights/errors.mjs +14 -0
  100. package/dist/{analytics → insights}/eventInput.cjs +61 -16
  101. package/dist/{analytics → insights}/eventInput.mjs +61 -18
  102. package/dist/insights/provider.cjs +332 -0
  103. package/dist/insights/provider.d.cts +6 -0
  104. package/dist/insights/provider.d.mts +6 -0
  105. package/dist/insights/provider.mjs +332 -0
  106. package/dist/insights/queryInput.cjs +93 -0
  107. package/dist/insights/queryInput.mjs +91 -0
  108. package/dist/insights/routes.cjs +58 -0
  109. package/dist/insights/routes.mjs +56 -0
  110. package/dist/insights/types.d.cts +32 -0
  111. package/dist/insights/types.d.mts +32 -0
  112. package/dist/node.d.cts +0 -1
  113. package/dist/node.d.mts +0 -1
  114. package/dist/package.cjs +1 -1
  115. package/dist/package.mjs +1 -1
  116. package/dist/schema/index.cjs +17 -3
  117. package/dist/schema/index.mjs +4 -4
  118. package/dist/schema/v1_0_0.cjs +64 -35
  119. package/dist/schema/v1_0_0.mjs +64 -36
  120. package/dist/storageAccess.cjs +0 -1
  121. package/dist/types/index.d.cts +0 -1
  122. package/dist/types/index.d.mts +0 -1
  123. package/package.json +7 -7
  124. package/src/adapters/databasePluginTestDatabase.ts +15 -5
  125. package/src/adapters/databasePluginUtils.ts +24 -0
  126. package/src/adapters/drizzle.spec.ts +203 -5
  127. package/src/adapters/drizzle.ts +16 -4
  128. package/src/adapters/drizzleCrud.ts +200 -9
  129. package/src/adapters/drizzleLazyDB.ts +33 -6
  130. package/src/adapters/kysely.spec.ts +62 -0
  131. package/src/adapters/kysely.ts +7 -1
  132. package/src/adapters/kyselyCrud.ts +115 -7
  133. package/src/adapters/kyselyInsights.spec.ts +168 -0
  134. package/src/adapters/mongodb.integration.spec.ts +483 -0
  135. package/src/adapters/mongodb.spec.ts +89 -0
  136. package/src/adapters/mongodb.ts +59 -1
  137. package/src/adapters/mongodbCollections.ts +16 -0
  138. package/src/adapters/mongodbQuery.ts +22 -3
  139. package/src/adapters/mongodbReads.ts +78 -2
  140. package/src/adapters/mongodbTestClient.ts +107 -6
  141. package/src/adapters/mongodbTestFilter.ts +5 -1
  142. package/src/adapters/mongodbWrites.ts +1 -0
  143. package/src/adapters/prisma.spec.ts +270 -0
  144. package/src/adapters/prisma.ts +75 -2
  145. package/src/adapters/prismaInsights.ts +190 -0
  146. package/src/adapters/prismaRows.ts +17 -10
  147. package/src/adapters/prismaTestClient.ts +89 -7
  148. package/src/apiKeys.integration.spec.ts +3 -3
  149. package/src/createHotUpdaterCore.ts +30 -16
  150. package/src/db/databasePluginUpdateCheck.bench.ts +10 -0
  151. package/src/db/fixedMigrator.spec.ts +63 -0
  152. package/src/db/fixedMigratorMongo.spec.ts +70 -9
  153. package/src/db/fixedMigratorMongo.ts +10 -10
  154. package/src/db/index.spec.ts +6 -1
  155. package/src/db/schema/insightsCollation.ts +21 -0
  156. package/src/db/schema/sql.ts +8 -5
  157. package/src/db/schemaGenerators.ts +42 -13
  158. package/src/db/types.spec.ts +11 -3
  159. package/src/db/types.ts +13 -7
  160. package/src/handler-standalone.integration.spec.ts +6 -8
  161. package/src/handler.ts +12 -12
  162. package/src/index.ts +3 -3
  163. package/src/insights/domain.ts +106 -0
  164. package/src/insights/errors.ts +11 -0
  165. package/src/{analytics → insights}/eventInput.ts +66 -16
  166. package/src/insights/insights.integration.spec.ts +475 -0
  167. package/src/insights/provider.spec.ts +396 -0
  168. package/src/insights/provider.ts +611 -0
  169. package/src/insights/queryInput.ts +142 -0
  170. package/src/insights/routes.ts +104 -0
  171. package/src/insights/types.ts +55 -0
  172. package/src/schema/dsl-all-versions.spec.ts +1 -1
  173. package/src/schema/v1_0_0.spec.ts +77 -3
  174. package/src/schema/v1_0_0.ts +83 -37
  175. package/dist/analytics/bounded/activeOverview.cjs +0 -87
  176. package/dist/analytics/bounded/activeOverview.mjs +0 -85
  177. package/dist/analytics/bounded/installationSearch.cjs +0 -42
  178. package/dist/analytics/bounded/installationSearch.mjs +0 -42
  179. package/dist/analytics/bounded/persistence.cjs +0 -39
  180. package/dist/analytics/bounded/persistence.mjs +0 -38
  181. package/dist/analytics/bounded/provider.cjs +0 -170
  182. package/dist/analytics/bounded/provider.d.cts +0 -7
  183. package/dist/analytics/bounded/provider.d.mts +0 -7
  184. package/dist/analytics/bounded/provider.mjs +0 -170
  185. package/dist/analytics/bounded/scan.cjs +0 -144
  186. package/dist/analytics/bounded/scan.mjs +0 -138
  187. package/dist/analytics/domain.d.cts +0 -121
  188. package/dist/analytics/domain.d.mts +0 -121
  189. package/dist/analytics/errors.cjs +0 -22
  190. package/dist/analytics/errors.mjs +0 -20
  191. package/dist/analytics/persistence.d.cts +0 -6
  192. package/dist/analytics/persistence.d.mts +0 -6
  193. package/dist/analytics/queryInput.cjs +0 -58
  194. package/dist/analytics/queryInput.mjs +0 -55
  195. package/dist/analytics/routes.cjs +0 -63
  196. package/dist/analytics/routes.mjs +0 -61
  197. package/dist/analytics/types.d.cts +0 -17
  198. package/dist/analytics/types.d.mts +0 -17
  199. package/src/analytics/analytics.integration.spec.ts +0 -144
  200. package/src/analytics/bounded/activeOverview.spec.ts +0 -189
  201. package/src/analytics/bounded/activeOverview.ts +0 -148
  202. package/src/analytics/bounded/installationSearch.spec.ts +0 -130
  203. package/src/analytics/bounded/installationSearch.ts +0 -69
  204. package/src/analytics/bounded/persistence.ts +0 -43
  205. package/src/analytics/bounded/provider.spec.ts +0 -219
  206. package/src/analytics/bounded/provider.ts +0 -229
  207. package/src/analytics/bounded/scan.ts +0 -235
  208. package/src/analytics/domain.ts +0 -139
  209. package/src/analytics/errors.ts +0 -18
  210. package/src/analytics/persistence.ts +0 -10
  211. package/src/analytics/queryInput.ts +0 -102
  212. package/src/analytics/routes.ts +0 -123
  213. package/src/analytics/types.ts +0 -44
@@ -0,0 +1,396 @@
1
+ import type { BundleEventRow, InsightsModel } from "@hot-updater/plugin-core";
2
+ import { afterEach, describe, expect, it, vi } from "vitest";
3
+
4
+ import { InsightsBadRequestError } from "./errors";
5
+ import { createInsightsProvider } from "./provider";
6
+
7
+ const eventId = (index: number) =>
8
+ `00000000-0000-7000-8000-${String(index).padStart(12, "0")}`;
9
+
10
+ type TransitionEventRow = Extract<
11
+ BundleEventRow,
12
+ { readonly type: "UPDATE_APPLIED" | "RECOVERED" }
13
+ >;
14
+
15
+ const eventRow = (
16
+ id: string,
17
+ receivedAtMs: number,
18
+ overrides: Partial<TransitionEventRow> = {},
19
+ ): TransitionEventRow => ({
20
+ app_version: "1.0.0",
21
+ channel: "production",
22
+ metadata: {
23
+ cohort: "default",
24
+ fingerprint_hash: null,
25
+ sdk_version: "2.0.0",
26
+ update_strategy: "appVersion",
27
+ username: "Jane",
28
+ },
29
+
30
+ from_bundle_id: "bundle-before",
31
+ from_release_id: null,
32
+ id,
33
+ install_id: "install-1",
34
+ platform: "ios",
35
+ received_at_ms: receivedAtMs,
36
+
37
+ to_bundle_id: "bundle-after",
38
+ to_release_id: null,
39
+ type: "UPDATE_APPLIED",
40
+
41
+ user_id: "user-1",
42
+
43
+ ...overrides,
44
+ });
45
+
46
+ const installationRow = (
47
+ installId: string,
48
+ overrides: Partial<BundleEventRow> = {},
49
+ ): BundleEventRow =>
50
+ ({
51
+ ...eventRow(eventId(1), 1_000),
52
+ type: "UNCHANGED",
53
+ from_bundle_id: null,
54
+ metadata: {
55
+ ...eventRow(eventId(1), 1_000).metadata,
56
+ update_strategy: null,
57
+ },
58
+ install_id: installId,
59
+ to_bundle_id: "bundle-1",
60
+ ...overrides,
61
+ }) as BundleEventRow;
62
+
63
+ const createModel = () => {
64
+ const model = {
65
+ recordEvent: vi.fn<InsightsModel["recordEvent"]>(async () => {}),
66
+ listEvents: vi.fn<InsightsModel["listEvents"]>(async () => []),
67
+ findLatestEvents: vi.fn<InsightsModel["findLatestEvents"]>(async () => []),
68
+ countLatestEvents: vi.fn<InsightsModel["countLatestEvents"]>(async () => 0),
69
+ countEvents: vi.fn<InsightsModel["countEvents"]>(async () => 0),
70
+ } satisfies InsightsModel;
71
+ return { ...model, model };
72
+ };
73
+
74
+ afterEach(() => {
75
+ vi.useRealTimers();
76
+ });
77
+
78
+ describe("createInsightsProvider", () => {
79
+ it("pages all events with one bounded database call and a strict stable cutoff", async () => {
80
+ vi.useFakeTimers();
81
+ vi.setSystemTime(1_000);
82
+ const fixture = createModel();
83
+ fixture.listEvents
84
+ .mockResolvedValueOnce([
85
+ eventRow(eventId(3), 999),
86
+ eventRow(eventId(2), 900),
87
+ eventRow(eventId(1), 800),
88
+ ])
89
+ .mockResolvedValueOnce([eventRow(eventId(1), 800)]);
90
+ const provider = createInsightsProvider(fixture.model);
91
+
92
+ const first = await provider.listEvents({ limit: 2 });
93
+
94
+ expect(first.data.map(({ id }) => id)).toEqual([eventId(3), eventId(2)]);
95
+ expect(first.beforeReceivedAtMs).toBe(1_000);
96
+ expect(first.nextCursor).not.toBeNull();
97
+ expect(fixture.listEvents).toHaveBeenNthCalledWith(1, {
98
+ beforeReceivedAtMs: 1_000,
99
+ limit: 3,
100
+ sinceMs: 0,
101
+ filter: { kind: "all" },
102
+ });
103
+
104
+ const second = await provider.listEvents({
105
+ cursor: first.nextCursor ?? undefined,
106
+ limit: 2,
107
+ });
108
+
109
+ expect(second.beforeReceivedAtMs).toBe(1_000);
110
+ expect(second.nextCursor).toBeNull();
111
+ expect(fixture.listEvents).toHaveBeenNthCalledWith(2, {
112
+ after: { id: eventId(2), receivedAtMs: 900 },
113
+ beforeReceivedAtMs: 1_000,
114
+ limit: 3,
115
+ sinceMs: 0,
116
+ filter: { kind: "all" },
117
+ });
118
+ });
119
+
120
+ it("binds event cursors to their filter", async () => {
121
+ vi.useFakeTimers();
122
+ vi.setSystemTime(1_000);
123
+ const fixture = createModel();
124
+ fixture.listEvents.mockResolvedValue([
125
+ eventRow(eventId(2), 900),
126
+ eventRow(eventId(1), 800),
127
+ ]);
128
+ const provider = createInsightsProvider(fixture.model);
129
+ const allEvents = await provider.listEvents({ limit: 1 });
130
+
131
+ await expect(
132
+ provider.listInstallationEvents({
133
+ cursor: allEvents.nextCursor ?? undefined,
134
+ installId: "install-1",
135
+ limit: 1,
136
+ }),
137
+ ).rejects.toBeInstanceOf(InsightsBadRequestError);
138
+ expect(fixture.listEvents).toHaveBeenCalledOnce();
139
+ });
140
+
141
+ it("rejects installation and user IDs longer than the indexed key limit", async () => {
142
+ const fixture = createModel();
143
+ const provider = createInsightsProvider(fixture.model);
144
+ const tooLong = "x".repeat(256);
145
+
146
+ await expect(
147
+ provider.getInstallation({ installId: tooLong }),
148
+ ).rejects.toBeInstanceOf(InsightsBadRequestError);
149
+ await expect(
150
+ provider.listInstallationEvents({ installId: tooLong }),
151
+ ).rejects.toBeInstanceOf(InsightsBadRequestError);
152
+ await expect(
153
+ provider.pageInstallationsByCurrentUserId({ userId: tooLong }),
154
+ ).rejects.toBeInstanceOf(InsightsBadRequestError);
155
+ expect(fixture.findLatestEvents).not.toHaveBeenCalled();
156
+ expect(fixture.listEvents).not.toHaveBeenCalled();
157
+ });
158
+
159
+ it("requests only movement events for one installation", async () => {
160
+ const fixture = createModel();
161
+ fixture.listEvents.mockResolvedValue([
162
+ eventRow(eventId(1), 900, {
163
+ install_id: "install-2",
164
+ type: "RECOVERED",
165
+ }),
166
+ ]);
167
+ const provider = createInsightsProvider(fixture.model);
168
+
169
+ const result = await provider.listInstallationEvents({
170
+ beforeReceivedAtMs: 1_000,
171
+ installId: "install-2",
172
+ limit: 10,
173
+ });
174
+
175
+ expect(result.data).toEqual([
176
+ expect.objectContaining({
177
+ id: eventId(1),
178
+ installId: "install-2",
179
+ type: "RECOVERED",
180
+ }),
181
+ ]);
182
+ expect(fixture.listEvents).toHaveBeenCalledWith({
183
+ beforeReceivedAtMs: 1_000,
184
+ limit: 11,
185
+ sinceMs: 0,
186
+ filter: { kind: "installationMovement", installId: "install-2" },
187
+ });
188
+ });
189
+
190
+ it("pages exact current user matches and binds the cursor to that user", async () => {
191
+ const fixture = createModel();
192
+ fixture.findLatestEvents.mockResolvedValue([
193
+ installationRow("install-a"),
194
+ installationRow("install-b"),
195
+ installationRow("install-c"),
196
+ ]);
197
+ const provider = createInsightsProvider(fixture.model);
198
+
199
+ const page = await provider.pageInstallationsByCurrentUserId({
200
+ limit: 2,
201
+ userId: "user-1",
202
+ });
203
+
204
+ expect(page.data.map(({ installId }) => installId)).toEqual([
205
+ "install-a",
206
+ "install-b",
207
+ ]);
208
+ expect(fixture.findLatestEvents).toHaveBeenCalledWith({
209
+ limit: 3,
210
+ userId: "user-1",
211
+ });
212
+ await expect(
213
+ provider.pageInstallationsByCurrentUserId({
214
+ cursor: page.nextCursor ?? undefined,
215
+ userId: "user-2",
216
+ }),
217
+ ).rejects.toBeInstanceOf(InsightsBadRequestError);
218
+ expect(fixture.findLatestEvents).toHaveBeenCalledOnce();
219
+ });
220
+
221
+ it("counts one explicit scope and returns independent measurement times", async () => {
222
+ vi.useFakeTimers();
223
+ vi.setSystemTime(new Date("2026-08-12T00:00:00.000Z"));
224
+ const fixture = createModel();
225
+ fixture.countLatestEvents.mockResolvedValue(123);
226
+ const provider = createInsightsProvider(fixture.model);
227
+ const input = {
228
+ window: "7d",
229
+ platform: "ios",
230
+ channel: "production",
231
+ } as const;
232
+ await expect(provider.getReportingOverview(input)).resolves.toEqual({
233
+ ...input,
234
+ sinceMs: Date.now() - 7 * 24 * 60 * 60 * 1_000,
235
+ beforeReceivedAtMs: Date.now(),
236
+ reportingInstallations: { count: 123, measuredAtMs: Date.now() },
237
+ });
238
+ expect(fixture.countLatestEvents).toHaveBeenCalledWith({
239
+ platform: "ios",
240
+ channel: "production",
241
+ sinceMs: Date.now() - 7 * 24 * 60 * 60 * 1_000,
242
+ });
243
+ expect(fixture.countEvents).not.toHaveBeenCalled();
244
+ });
245
+
246
+ it("attributes recovery to the source bundle and reuses its count predicate for drill-down", async () => {
247
+ vi.useFakeTimers();
248
+ vi.setSystemTime(new Date("2026-08-12T00:00:00.000Z"));
249
+ const fixture = createModel();
250
+ fixture.countLatestEvents.mockResolvedValueOnce(1).mockResolvedValueOnce(2);
251
+ fixture.countEvents
252
+ .mockResolvedValueOnce(7)
253
+ .mockResolvedValueOnce(5)
254
+ .mockResolvedValueOnce(3)
255
+ .mockResolvedValueOnce(1);
256
+ const provider = createInsightsProvider(fixture.model);
257
+ const scope = { platform: "ios", channel: "production" } as const;
258
+ const result = await provider.getReportingOverview({
259
+ ...scope,
260
+ window: "24h",
261
+ bundleId: "B",
262
+ });
263
+ expect(result.reportingInstallations.count).toBe(1);
264
+ // Independent live measurements are never clamped or turned into a share.
265
+ expect(result.bundle?.reportingInstallations.count).toBe(2);
266
+ expect(fixture.countLatestEvents).toHaveBeenCalledTimes(2);
267
+ expect(fixture.countLatestEvents.mock.calls[1]?.[0]).toEqual({
268
+ ...scope,
269
+ sinceMs: Date.now() - 24 * 60 * 60 * 1_000,
270
+ bundle: [
271
+ { field: "from_bundle_id", value: "B", types: ["UPDATE_DOWNLOADED"] },
272
+ {
273
+ field: "to_bundle_id",
274
+ value: "B",
275
+ types: ["UNCHANGED", "UPDATE_APPLIED", "RECOVERED"],
276
+ },
277
+ ],
278
+ });
279
+ expect(result.bundle?.downloadedReports.count).toBe(7);
280
+ expect(result.bundle?.appliedReports.count).toBe(5);
281
+ expect(result.bundle?.recoveredReports.count).toBe(3);
282
+ expect(result.bundle?.unchangedReports.count).toBe(1);
283
+ expect(
284
+ fixture.countEvents.mock.calls.map(([input]) => input.filter),
285
+ ).toEqual([
286
+ { ...scope, type: "UPDATE_DOWNLOADED", toBundleId: "B" },
287
+ { ...scope, type: "UPDATE_APPLIED", toBundleId: "B" },
288
+ { ...scope, type: "RECOVERED", fromBundleId: "B" },
289
+ { ...scope, type: "UNCHANGED", toBundleId: "B" },
290
+ ]);
291
+ await provider.listEvents({
292
+ bundle: { ...scope, bundleId: "B", outcome: "recovered" },
293
+ sinceMs: result.sinceMs,
294
+ beforeReceivedAtMs: result.beforeReceivedAtMs,
295
+ });
296
+ const counted = fixture.countEvents.mock.calls[2]![0];
297
+ expect(fixture.listEvents).toHaveBeenCalledWith({
298
+ ...counted,
299
+ filter: { kind: "bundle", ...counted.filter },
300
+ limit: 51,
301
+ });
302
+ });
303
+
304
+ it("binds bundle cursors to the outcome, scope, bundle, and both time bounds", async () => {
305
+ const fixture = createModel();
306
+ fixture.listEvents.mockResolvedValue([
307
+ eventRow(eventId(2), 900),
308
+ eventRow(eventId(1), 800),
309
+ ]);
310
+ const provider = createInsightsProvider(fixture.model);
311
+ const bundle = {
312
+ platform: "ios",
313
+ channel: "production",
314
+ bundleId: "bundle-after",
315
+ outcome: "applied",
316
+ } as const;
317
+ const first = await provider.listEvents({
318
+ bundle,
319
+ sinceMs: 100,
320
+ beforeReceivedAtMs: 1_000,
321
+ limit: 1,
322
+ });
323
+ const cursor = first.nextCursor ?? undefined;
324
+ for (const change of [
325
+ { bundle: { ...bundle, outcome: "recovered" as const } },
326
+ { bundle: { ...bundle, channel: "beta" } },
327
+ { bundle: { ...bundle, bundleId: "another" } },
328
+ { sinceMs: 101 },
329
+ { beforeReceivedAtMs: 1_001 },
330
+ ]) {
331
+ await expect(
332
+ provider.listEvents({ bundle, cursor, ...change }),
333
+ ).rejects.toBeInstanceOf(InsightsBadRequestError);
334
+ }
335
+ expect(fixture.listEvents).toHaveBeenCalledOnce();
336
+ });
337
+
338
+ it("rejects forged event keys before they reach the database boundary", async () => {
339
+ const fixture = createModel();
340
+ fixture.listEvents.mockResolvedValue([
341
+ eventRow(eventId(2), 900),
342
+ eventRow(eventId(1), 800),
343
+ ]);
344
+ const provider = createInsightsProvider(fixture.model);
345
+ const first = await provider.listEvents({
346
+ sinceMs: 100,
347
+ beforeReceivedAtMs: 1_000,
348
+ limit: 1,
349
+ });
350
+ const payload = JSON.parse(
351
+ Buffer.from(first.nextCursor!, "base64url").toString("utf8"),
352
+ );
353
+ for (const after of [
354
+ { id: "invalid", receivedAtMs: 900 },
355
+ { id: eventId(1), receivedAtMs: 1_000 },
356
+ { id: eventId(1), receivedAtMs: 99 },
357
+ ]) {
358
+ const cursor = Buffer.from(
359
+ JSON.stringify({ ...payload, after }),
360
+ ).toString("base64url");
361
+ await expect(provider.listEvents({ cursor })).rejects.toBeInstanceOf(
362
+ InsightsBadRequestError,
363
+ );
364
+ }
365
+ expect(fixture.listEvents).toHaveBeenCalledOnce();
366
+ });
367
+
368
+ it("propagates count failures without reporting a partial overview", async () => {
369
+ const fixture = createModel();
370
+ fixture.countEvents.mockRejectedValue(new Error("database unavailable"));
371
+ const provider = createInsightsProvider(fixture.model);
372
+ await expect(
373
+ provider.getReportingOverview({
374
+ platform: "ios",
375
+ channel: "production",
376
+ window: "24h",
377
+ bundleId: "B",
378
+ }),
379
+ ).rejects.toThrow("database unavailable");
380
+ });
381
+
382
+ it("uses UTF-8 order when checking exact current-user pages", async () => {
383
+ const fixture = createModel();
384
+ fixture.findLatestEvents.mockResolvedValue([
385
+ installationRow("\uE000"),
386
+ installationRow("\u{10000}"),
387
+ ]);
388
+ const result = await createInsightsProvider(
389
+ fixture.model,
390
+ ).pageInstallationsByCurrentUserId({ userId: "user-1" });
391
+ expect(result.data.map(({ installId }) => installId)).toEqual([
392
+ "\uE000",
393
+ "\u{10000}",
394
+ ]);
395
+ });
396
+ });