@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
@@ -1,7 +1,11 @@
1
+ import { PGlite } from "@electric-sql/pglite";
1
2
  import { describe, expect, expectTypeOf, it } from "vitest";
2
3
 
4
+ import { createBundleEventRowFixture } from "../../../test-utils/src/databaseTestFixtures";
3
5
  import { setupDatabasePluginTestSuite } from "../../../test-utils/src/setupDatabasePluginTestSuite";
6
+ import { createTableSql } from "../db/schema/sql";
4
7
  import { prismaAdapter, type PrismaConfig } from "./prisma";
8
+ import { updatePrismaEventHead } from "./prismaInsights";
5
9
  import { createPrismaTestHarness } from "./prismaTestClient";
6
10
 
7
11
  const harness = createPrismaTestHarness();
@@ -34,6 +38,272 @@ const productionChannel = {
34
38
  } as const;
35
39
 
36
40
  describe("prismaAdapter capabilities", () => {
41
+ it("rejects every SQL Server Insights operation before touching the database", async () => {
42
+ const plugin = prismaAdapter({ prisma: {}, provider: "mssql" });
43
+ expect(plugin.generateSchema?.("latest").code).not.toContain(
44
+ "bundle_events_to_bundle_idx",
45
+ );
46
+ expect(plugin.generateSchema?.("latest").code).toContain(
47
+ "releases_scope_order_idx",
48
+ );
49
+ const event = createBundleEventRowFixture("707", 100);
50
+ const filter = {
51
+ platform: "ios" as const,
52
+ channel: "production",
53
+ type: "UPDATE_APPLIED" as const,
54
+ toBundleId: event.to_bundle_id,
55
+ };
56
+ const calls = [
57
+ plugin.models.insights.recordEvent({
58
+ event,
59
+ }),
60
+ plugin.models.insights.listEvents({
61
+ filter: { kind: "all" },
62
+ beforeReceivedAtMs: 101,
63
+ limit: 10,
64
+ }),
65
+ plugin.models.insights.findLatestEvents({ installId: event.install_id }),
66
+ plugin.models.insights.countLatestEvents({
67
+ platform: "ios",
68
+ channel: "production",
69
+ sinceMs: 0,
70
+ }),
71
+ plugin.models.insights.countEvents({
72
+ filter,
73
+ sinceMs: 0,
74
+ beforeReceivedAtMs: 101,
75
+ }),
76
+ ];
77
+ for (const call of calls)
78
+ await expect(call).rejects.toThrow("SQL Server Insights is unsupported");
79
+ });
80
+ it("atomically records Insights without callback transactions using Prisma text-bound UUIDs", async () => {
81
+ const db = new PGlite();
82
+ await db.exec(createTableSql("postgresql").join(";"));
83
+ let statementId = 0;
84
+ const queryWithPrismaTypes = async (query: string, values: unknown[]) => {
85
+ const statement = `prisma_${statementId++}`;
86
+ const types = values.map((value) =>
87
+ typeof value === "number" ? "double precision" : "text",
88
+ );
89
+ // Prisma supplies string parameter types. Letting PostgreSQL infer UUID here
90
+ // would hide missing casts that fail with the real Prisma client.
91
+ await db.exec(`PREPARE ${statement} (${types.join(", ")}) AS ${query}`);
92
+ try {
93
+ return await db.query(
94
+ `EXECUTE ${statement} (${values.map((value) => (value === null ? "NULL" : typeof value === "number" ? String(value) : `'${String(value).replaceAll("'", "''")}'`)).join(", ")})`,
95
+ );
96
+ } finally {
97
+ await db.exec(`DEALLOCATE ${statement}`);
98
+ }
99
+ };
100
+ const client = {
101
+ $executeRawUnsafe: (query: string, ...values: unknown[]) =>
102
+ queryWithPrismaTypes(query, values),
103
+ $queryRawUnsafe: async (query: string, ...values: unknown[]) =>
104
+ (await queryWithPrismaTypes(query, values)).rows,
105
+ };
106
+ const insights = prismaAdapter({ prisma: client, provider: "postgresql" })
107
+ .models.insights;
108
+ const event = createBundleEventRowFixture("704", 100);
109
+ try {
110
+ await insights.recordEvent({ event });
111
+ await updatePrismaEventHead(client, "postgresql", event);
112
+ await insights.recordEvent({
113
+ event: { ...event, install_id: "altered-install", received_at_ms: 300 },
114
+ });
115
+ await expect(
116
+ insights.findLatestEvents({ installId: event.install_id }),
117
+ ).resolves.toEqual([event]);
118
+ await expect(
119
+ insights.findLatestEvents({ installId: "altered-install" }),
120
+ ).resolves.toEqual([]);
121
+ expect((await db.query("SELECT id FROM bundle_events")).rows).toEqual([
122
+ { id: event.id },
123
+ ]);
124
+ await expect(
125
+ insights.countLatestEvents({
126
+ platform: event.platform,
127
+ channel: event.channel,
128
+ sinceMs: 0,
129
+ bundle: [
130
+ {
131
+ field: "to_bundle_id",
132
+ value: event.to_bundle_id,
133
+ types: [event.type],
134
+ },
135
+ ],
136
+ }),
137
+ ).resolves.toBe(1);
138
+
139
+ await db.exec(
140
+ "ALTER TABLE bundle_event_heads ADD CONSTRAINT reject_head CHECK (received_at_ms < 200)",
141
+ );
142
+ const rejected = {
143
+ ...event,
144
+ id: createBundleEventRowFixture("706", 200).id,
145
+ received_at_ms: 200,
146
+ };
147
+ await expect(insights.recordEvent({ event: rejected })).rejects.toThrow();
148
+ expect((await db.query("SELECT id FROM bundle_events")).rows).toEqual([
149
+ { id: event.id },
150
+ ]);
151
+ await expect(
152
+ insights.findLatestEvents({ installId: event.install_id }),
153
+ ).resolves.toEqual([event]);
154
+ await db.exec(
155
+ "ALTER TABLE bundle_event_heads DROP CONSTRAINT reject_head",
156
+ );
157
+ await insights.recordEvent({ event: rejected });
158
+ await expect(
159
+ insights.findLatestEvents({ installId: event.install_id }),
160
+ ).resolves.toEqual([rejected]);
161
+ } finally {
162
+ await db.close();
163
+ }
164
+ });
165
+
166
+ it("rolls back the canonical event when its head update fails and permits retry", async () => {
167
+ const isolated = createPrismaTestHarness();
168
+ const event = createBundleEventRowFixture("705", 100);
169
+ const plugin = prismaAdapter({
170
+ prisma: {
171
+ ...isolated.client,
172
+ $transaction: (callback: (client: object) => Promise<unknown>) =>
173
+ isolated.client.$transaction((transaction) =>
174
+ callback({
175
+ ...transaction,
176
+ $executeRawUnsafe: async () => {
177
+ throw new Error("injected head failure");
178
+ },
179
+ }),
180
+ ),
181
+ },
182
+ provider: "postgresql",
183
+ });
184
+ await expect(plugin.models.insights.recordEvent({ event })).rejects.toThrow(
185
+ "injected head failure",
186
+ );
187
+ const working = prismaAdapter({
188
+ prisma: isolated.client,
189
+ provider: "postgresql",
190
+ });
191
+ await expect(
192
+ working.models.insights.findLatestEvents({ installId: event.install_id }),
193
+ ).resolves.toEqual([]);
194
+ expect(await isolated.client.bundle_events.findMany()).toEqual([]);
195
+ await working.models.insights.recordEvent({ event });
196
+ await expect(
197
+ working.models.insights.findLatestEvents({ installId: event.install_id }),
198
+ ).resolves.toEqual([event]);
199
+ });
200
+
201
+ it("retries CockroachDB raw serialization failures without duplicating the event", async () => {
202
+ const isolated = createPrismaTestHarness();
203
+ const event = createBundleEventRowFixture("708", 100);
204
+ let failHead = true;
205
+ const prisma = {
206
+ ...isolated.client,
207
+ $transaction: (
208
+ callback: (client: object) => Promise<unknown>,
209
+ options?: { readonly isolationLevel?: string },
210
+ ) =>
211
+ isolated.client.$transaction(
212
+ (transaction) =>
213
+ callback({
214
+ ...transaction,
215
+ $executeRawUnsafe: (
216
+ ...args: Parameters<typeof isolated.client.$executeRawUnsafe>
217
+ ) => {
218
+ if (failHead) {
219
+ failHead = false;
220
+ throw Object.assign(new Error("could not serialize access"), {
221
+ code: "P2010",
222
+ meta: { code: "40001" },
223
+ });
224
+ }
225
+ return Reflect.get(transaction, "$executeRawUnsafe")(...args);
226
+ },
227
+ }),
228
+ options,
229
+ ),
230
+ };
231
+ const insights = prismaAdapter({ prisma, provider: "cockroachdb" }).models
232
+ .insights;
233
+ await insights.recordEvent({ event });
234
+ expect(await isolated.client.bundle_events.findMany()).toEqual([event]);
235
+ await expect(
236
+ insights.findLatestEvents({ installId: event.install_id }),
237
+ ).resolves.toEqual([event]);
238
+ expect(isolated.getTransactionOptions()).toEqual([
239
+ { isolationLevel: "Serializable" },
240
+ { isolationLevel: "Serializable" },
241
+ ]);
242
+ });
243
+
244
+ it("counts MySQL overlapping bundle predicates once without dropping nullable source bundles", async () => {
245
+ const isolated = createPrismaTestHarness();
246
+ const writer = prismaAdapter({
247
+ prisma: isolated.client,
248
+ provider: "postgresql",
249
+ }).models.insights;
250
+ const base = createBundleEventRowFixture("720", 100);
251
+ const applied = { ...base, from_bundle_id: base.to_bundle_id };
252
+ const download = {
253
+ ...createBundleEventRowFixture("721", 100),
254
+ type: "UPDATE_DOWNLOADED" as const,
255
+ from_bundle_id: base.to_bundle_id,
256
+ };
257
+ const unchanged = {
258
+ ...createBundleEventRowFixture("722", 100),
259
+ type: "UNCHANGED" as const,
260
+ from_bundle_id: null,
261
+ to_bundle_id: base.to_bundle_id,
262
+ metadata: { ...base.metadata, update_strategy: null },
263
+ };
264
+ for (const event of [applied, download, unchanged])
265
+ await writer.recordEvent({ event });
266
+ let queries = 0;
267
+ const reader = prismaAdapter({
268
+ prisma: {
269
+ ...isolated.client,
270
+ $queryRawUnsafe: (
271
+ ...args: Parameters<typeof isolated.client.$queryRawUnsafe>
272
+ ) => {
273
+ queries += 1;
274
+ return isolated.client.$queryRawUnsafe(...args);
275
+ },
276
+ },
277
+ provider: "mysql",
278
+ }).models.insights;
279
+ const source = {
280
+ field: "from_bundle_id" as const,
281
+ value: base.to_bundle_id,
282
+ types: ["UPDATE_APPLIED", "UPDATE_DOWNLOADED"] as const,
283
+ };
284
+ const destination = {
285
+ field: "to_bundle_id" as const,
286
+ value: base.to_bundle_id,
287
+ types: ["UPDATE_APPLIED", "UNCHANGED"] as const,
288
+ };
289
+ for (const [bundle, expected] of [
290
+ [[source, destination], 3],
291
+ [[destination, destination], 2],
292
+ [[{ ...source, types: ["UNCHANGED"] }, destination], 2],
293
+ [[destination], 2],
294
+ ] as const) {
295
+ await expect(
296
+ reader.countLatestEvents({
297
+ platform: "ios",
298
+ channel: "production",
299
+ sinceMs: 0,
300
+ bundle,
301
+ }),
302
+ ).resolves.toBe(expected);
303
+ }
304
+ expect(queries).toBe(4);
305
+ });
306
+
37
307
  it("excludes MongoDB from the public configuration", () => {
38
308
  expectTypeOf<"mongodb">().not.toMatchTypeOf<PrismaConfig["provider"]>();
39
309
  });
@@ -1,6 +1,7 @@
1
1
  import {
2
2
  createDatabasePlugin,
3
3
  DatabasePluginInputError,
4
+ type InsightsModel,
4
5
  } from "@hot-updater/plugin-core";
5
6
  import {
6
7
  createDatabasePluginAdapter,
@@ -26,6 +27,11 @@ import {
26
27
  translateChannelDeleteError,
27
28
  } from "./databaseConstraintErrors";
28
29
  import { hasNullOrderOverrides, sortRowsByOrder } from "./databasePluginUtils";
30
+ import {
31
+ queryPrismaLatestEvents,
32
+ recordPrismaEventWithCte,
33
+ updatePrismaEventHead,
34
+ } from "./prismaInsights";
29
35
  import { createPrismaOrderBy, createPrismaWhere } from "./prismaQuery";
30
36
  import {
31
37
  getPrismaDelegate,
@@ -69,6 +75,7 @@ const runPrismaTransaction = <TResult>(
69
75
  client: PrismaTransactionClient,
70
76
  isolationLevel: "default" | "serializable",
71
77
  callback: (client: object) => Promise<TResult>,
78
+ retryUniqueConflict = false,
72
79
  ): Promise<TResult> => {
73
80
  const execute = () =>
74
81
  isolationLevel === "serializable"
@@ -86,7 +93,16 @@ const runPrismaTransaction = <TResult>(
86
93
  typeof error !== "object" ||
87
94
  error === null ||
88
95
  !("code" in error) ||
89
- error.code !== "P2034"
96
+ (error.code !== "P2034" &&
97
+ !(
98
+ error.code === "P2010" &&
99
+ "meta" in error &&
100
+ typeof error.meta === "object" &&
101
+ error.meta !== null &&
102
+ "code" in error.meta &&
103
+ error.meta.code === "40001"
104
+ ) &&
105
+ !(retryUniqueConflict && error.code === "P2002"))
90
106
  ) {
91
107
  throw error;
92
108
  }
@@ -135,6 +151,7 @@ const findMany = async (
135
151
  return parsePrismaRows(rows, parsePrismaPatchRow);
136
152
  case "bundle_events":
137
153
  return parsePrismaRows(rows, parsePrismaBundleEventRow);
154
+
138
155
  case "channels":
139
156
  return parsePrismaRows(rows, parsePrismaChannelRow);
140
157
  case "api_keys":
@@ -234,6 +251,7 @@ const createCrudImplementation = (
234
251
  return parsePrismaPatchRow(row);
235
252
  case "bundle_events":
236
253
  return parsePrismaBundleEventRow(row);
254
+
237
255
  case "channels":
238
256
  return parsePrismaChannelRow(row);
239
257
  case "api_keys":
@@ -356,6 +374,46 @@ const createPrismaImplementation = (
356
374
  const crud = createCrudImplementation(client, provider, relationMode);
357
375
  const implementation: DatabasePluginImplementation = {
358
376
  ...crud,
377
+ async recordInsights({ event }) {
378
+ if (!hasCallbackTransaction(client)) {
379
+ return recordPrismaEventWithCte(client, provider, event);
380
+ }
381
+ const events = getPrismaDelegate(client, "bundle_events");
382
+ try {
383
+ await runPrismaTransaction(
384
+ client,
385
+ provider === "cockroachdb" ? "serializable" : "default",
386
+ async (transaction) => {
387
+ await getPrismaDelegate(transaction, "bundle_events").create({
388
+ data: event,
389
+ });
390
+ await updatePrismaEventHead(transaction, provider, event);
391
+ },
392
+ );
393
+ } catch (error) {
394
+ if (
395
+ typeof error !== "object" ||
396
+ error === null ||
397
+ !("code" in error) ||
398
+ error.code !== "P2002"
399
+ )
400
+ throw error;
401
+ if ((await events.findFirst({ where: { id: event.id } })) === null)
402
+ throw error;
403
+ }
404
+ },
405
+ async findLatestInsightsEvents(input) {
406
+ const rows = await queryPrismaLatestEvents(client, provider, input);
407
+ if (typeof rows === "number")
408
+ throw new PrismaAdapterError("invalid latest-event rows");
409
+ return rows;
410
+ },
411
+ async countLatestInsightsEvents(input) {
412
+ const count = await queryPrismaLatestEvents(client, provider, input);
413
+ if (typeof count !== "number")
414
+ throw new PrismaAdapterError("invalid latest-event count");
415
+ return count;
416
+ },
359
417
  deleteChannel: (input) => {
360
418
  if (!hasCallbackTransaction(client)) {
361
419
  throw new PrismaAdapterError(
@@ -442,10 +500,25 @@ export const prismaAdapter = (
442
500
  config.provider,
443
501
  ),
444
502
  );
503
+ const unsupportedMssqlInsights = async (): Promise<never> => {
504
+ throw new PrismaAdapterError(
505
+ "SQL Server Insights is unsupported: string keys pad trailing spaces and do not provide the required exact UTF-8 identity ordering",
506
+ );
507
+ };
508
+ const insights: InsightsModel =
509
+ config.provider === "mssql"
510
+ ? {
511
+ recordEvent: unsupportedMssqlInsights,
512
+ listEvents: unsupportedMssqlInsights,
513
+ findLatestEvents: unsupportedMssqlInsights,
514
+ countLatestEvents: unsupportedMssqlInsights,
515
+ countEvents: unsupportedMssqlInsights,
516
+ }
517
+ : adapter.models.insights;
445
518
  return Object.assign(
446
519
  createDatabasePlugin({
447
520
  name: "prisma",
448
- models: adapter.models,
521
+ models: { ...adapter.models, insights },
449
522
  commit: adapter.commit,
450
523
  }),
451
524
  {
@@ -0,0 +1,190 @@
1
+ import type {
2
+ BundleEventRow,
3
+ InsightsCountLatestEventsInput,
4
+ InsightsFindLatestEventsInput,
5
+ } from "@hot-updater/plugin-core";
6
+ import {
7
+ latestInsightsWhere,
8
+ latestInsightsCountGroups,
9
+ } from "@hot-updater/plugin-core/internal";
10
+
11
+ import type { ORMSQLProvider } from "../db/types";
12
+ import { parsePrismaBundleEventRow, PrismaAdapterError } from "./prismaRows";
13
+
14
+ const headFields = [
15
+ "install_id",
16
+ "id",
17
+ "received_at_ms",
18
+ "user_id",
19
+ "platform",
20
+ "channel",
21
+ "type",
22
+ "from_bundle_id",
23
+ "to_bundle_id",
24
+ ] as const;
25
+
26
+ const parameter = (
27
+ provider: ORMSQLProvider,
28
+ index: number,
29
+ field?: string,
30
+ ): string => {
31
+ if (provider !== "postgresql" && provider !== "cockroachdb") return "?";
32
+ const cast =
33
+ field === "metadata"
34
+ ? "::jsonb"
35
+ : [
36
+ "id",
37
+ "from_release_id",
38
+ "from_bundle_id",
39
+ "to_release_id",
40
+ "to_bundle_id",
41
+ ].includes(field ?? "")
42
+ ? "::uuid"
43
+ : "";
44
+ return `$${index}${cast}`;
45
+ };
46
+
47
+ const headConflict = (provider: ORMSQLProvider): string => {
48
+ const newer =
49
+ "(excluded.received_at_ms > bundle_event_heads.received_at_ms OR (excluded.received_at_ms = bundle_event_heads.received_at_ms AND excluded.id > bundle_event_heads.id))";
50
+ if (provider === "mysql") {
51
+ const mysqlNewer = newer.replace(/excluded\.(\w+)/g, "VALUES($1)");
52
+ // MySQL evaluates assignments from left to right. Update the ordering keys last.
53
+ const fields = [
54
+ ...headFields.filter(
55
+ (field) => !["install_id", "id", "received_at_ms"].includes(field),
56
+ ),
57
+ "id",
58
+ "received_at_ms",
59
+ ];
60
+ return `ON DUPLICATE KEY UPDATE ${fields.map((field) => `${field} = IF(${mysqlNewer}, VALUES(${field}), bundle_event_heads.${field})`).join(", ")}`;
61
+ }
62
+ return `ON CONFLICT (install_id) DO UPDATE SET ${headFields
63
+ .filter((field) => field !== "install_id")
64
+ .map((field) => `${field} = excluded.${field}`)
65
+ .join(", ")} WHERE ${newer}`;
66
+ };
67
+
68
+ const executePrismaInsights = async (
69
+ client: object,
70
+ query: string,
71
+ values: readonly unknown[],
72
+ ): Promise<void> => {
73
+ if (
74
+ !("$executeRawUnsafe" in client) ||
75
+ typeof client.$executeRawUnsafe !== "function"
76
+ ) {
77
+ throw new PrismaAdapterError("Insights writes require native SQL support");
78
+ }
79
+ await client.$executeRawUnsafe(query, ...values);
80
+ };
81
+
82
+ export const updatePrismaEventHead = (
83
+ client: object,
84
+ provider: ORMSQLProvider,
85
+ event: BundleEventRow,
86
+ ): Promise<void> =>
87
+ executePrismaInsights(
88
+ client,
89
+ `INSERT INTO bundle_event_heads (${headFields.join(", ")}) VALUES (${headFields.map((field, index) => parameter(provider, index + 1, field)).join(", ")}) ${headConflict(provider)}`,
90
+ headFields.map((field) => event[field]),
91
+ );
92
+
93
+ /** PostgreSQL clients without callback transactions can publish both rows atomically. */
94
+ export const recordPrismaEventWithCte = (
95
+ client: object,
96
+ provider: ORMSQLProvider,
97
+ event: BundleEventRow,
98
+ ): Promise<void> => {
99
+ if (provider !== "postgresql" && provider !== "cockroachdb") {
100
+ throw new PrismaAdapterError(
101
+ "Insights writes require callback transactions",
102
+ );
103
+ }
104
+ const fields = [
105
+ "id",
106
+ "type",
107
+ "install_id",
108
+ "user_id",
109
+ "from_release_id",
110
+ "from_bundle_id",
111
+ "to_release_id",
112
+ "to_bundle_id",
113
+ "platform",
114
+ "app_version",
115
+ "channel",
116
+ "metadata",
117
+ "received_at_ms",
118
+ ] as const;
119
+ return executePrismaInsights(
120
+ client,
121
+ `WITH inserted AS (INSERT INTO bundle_events (${fields.join(", ")}) VALUES (${fields.map((field, index) => parameter(provider, index + 1, field)).join(", ")}) ON CONFLICT (id) DO NOTHING RETURNING ${headFields.join(", ")}) INSERT INTO bundle_event_heads (${headFields.join(", ")}) SELECT ${headFields.join(", ")} FROM inserted ${headConflict(provider)}`,
122
+ fields.map((field) =>
123
+ field === "metadata" ? JSON.stringify(event[field]) : event[field],
124
+ ),
125
+ );
126
+ };
127
+
128
+ export const queryPrismaLatestEvents = async (
129
+ client: object,
130
+ provider: ORMSQLProvider,
131
+ input: InsightsFindLatestEventsInput | InsightsCountLatestEventsInput,
132
+ ): Promise<readonly BundleEventRow[] | number> => {
133
+ if (
134
+ !("$queryRawUnsafe" in client) ||
135
+ typeof client.$queryRawUnsafe !== "function"
136
+ ) {
137
+ throw new PrismaAdapterError(
138
+ "Insights reads require native SQL query support",
139
+ );
140
+ }
141
+ const values: unknown[] = [];
142
+ const bind = (value: unknown, field?: string): string => {
143
+ values.push(value);
144
+ return parameter(provider, values.length, field);
145
+ };
146
+ const groups =
147
+ "sinceMs" in input
148
+ ? latestInsightsCountGroups(input)
149
+ : [latestInsightsWhere(input)];
150
+ let firstGroupValues: unknown[] = [];
151
+ const predicates = groups.map((group, index) => {
152
+ const predicate = `(${group
153
+ .map((where) =>
154
+ where.operator === "in" && Array.isArray(where.value)
155
+ ? `${where.field} IN (${where.value.map((value) => bind(value, where.field)).join(", ")})`
156
+ : `${where.field} ${where.operator === "gte" ? ">=" : where.operator === "gt" ? ">" : "="} ${bind(where.value, where.field)}`,
157
+ )
158
+ .join(" AND ")})`;
159
+ if (index === 0) firstGroupValues = values.slice();
160
+ return predicate;
161
+ });
162
+
163
+ const counting = "sinceMs" in input;
164
+ const page = counting
165
+ ? ""
166
+ : ` ORDER BY install_id ASC LIMIT ${bind("installId" in input ? 1 : input.limit)}`;
167
+ // Only fixed identifiers/operators enter SQL; every input value is bound.
168
+ let selection = `SELECT ${counting ? "COUNT(*) AS count" : "id, install_id"} FROM bundle_event_heads WHERE (${predicates.join(" OR ")})${page}`;
169
+ if (counting && provider === "mysql" && predicates.length === 2) {
170
+ // Separate ranges let MySQL use each bundle index within one snapshot.
171
+ // IS NOT TRUE also retains rows where the first predicate is NULL.
172
+ selection = `SELECT (SELECT COUNT(*) FROM bundle_event_heads WHERE ${predicates[0]}) + (SELECT COUNT(*) FROM bundle_event_heads WHERE ${predicates[1]} AND ${predicates[0]} IS NOT TRUE) AS count`;
173
+ values.push(...firstGroupValues);
174
+ }
175
+ const rows: unknown = await client.$queryRawUnsafe(
176
+ counting
177
+ ? selection
178
+ : `SELECT event.* FROM (${selection}) AS head JOIN bundle_events AS event ON event.id = head.id ORDER BY head.install_id ASC`,
179
+ ...values,
180
+ );
181
+ if (!Array.isArray(rows))
182
+ throw new PrismaAdapterError("invalid latest-event query result");
183
+ if (counting) {
184
+ const count = rows[0]?.count;
185
+ if (typeof count !== "number" && typeof count !== "bigint")
186
+ throw new PrismaAdapterError("invalid latest-event count");
187
+ return Number(count);
188
+ }
189
+ return rows.map(parsePrismaBundleEventRow);
190
+ };
@@ -1,3 +1,4 @@
1
+ import { isDatabaseBundleEventMetadata } from "@hot-updater/plugin-core";
1
2
  import type {
2
3
  BundleEventRow,
3
4
  BundlePatchRow,
@@ -19,7 +20,9 @@ export type PrismaDelegate = {
19
20
  readonly findFirst: (args?: PrismaQuery) => Promise<unknown>;
20
21
  readonly findMany: (args?: PrismaQuery) => Promise<readonly unknown[]>;
21
22
  readonly update: (args: PrismaQuery) => Promise<unknown>;
22
- readonly updateMany?: (args: PrismaQuery) => Promise<unknown>;
23
+ readonly updateMany?: (
24
+ args: PrismaQuery,
25
+ ) => Promise<{ readonly count: number }>;
23
26
  readonly upsert: (args: PrismaQuery) => Promise<unknown>;
24
27
  };
25
28
 
@@ -48,6 +51,7 @@ const modelDelegates = {
48
51
  bundles: "bundles",
49
52
  bundle_patches: "bundle_patches",
50
53
  bundle_events: "bundle_events",
54
+
51
55
  channels: "channels",
52
56
  api_keys: "api_keys",
53
57
  releases: "releases",
@@ -160,13 +164,20 @@ export const parsePrismaBundleEventRow = (value: unknown): BundleEventRow => {
160
164
  const type = readString(value, "type");
161
165
  const platform = readString(value, "platform");
162
166
  const fromBundleId = readNullableString(value, "from_bundle_id");
163
- const updateStrategy = readNullableString(value, "update_strategy");
167
+ const storedMetadata = value["metadata"];
168
+ const metadata =
169
+ typeof storedMetadata === "string"
170
+ ? JSON.parse(storedMetadata)
171
+ : storedMetadata;
172
+ if (!isDatabaseBundleEventMetadata(metadata))
173
+ throw new PrismaAdapterError("invalid event metadata");
174
+ const updateStrategy = metadata.update_strategy;
164
175
  if (
165
176
  (platform !== "ios" && platform !== "android") ||
166
177
  !(
167
- ((type === "UPDATE_APPLIED" ||
168
- type === "RECOVERED" ||
169
- type === "RELEASE_ADOPTED") &&
178
+ ((type === "UPDATE_DOWNLOADED" ||
179
+ type === "UPDATE_APPLIED" ||
180
+ type === "RECOVERED") &&
170
181
  typeof fromBundleId === "string" &&
171
182
  (updateStrategy === "fingerprint" ||
172
183
  updateStrategy === "appVersion")) ||
@@ -180,7 +191,6 @@ export const parsePrismaBundleEventRow = (value: unknown): BundleEventRow => {
180
191
  type,
181
192
  install_id: readString(value, "install_id"),
182
193
  user_id: readNullableString(value, "user_id"),
183
- username: readNullableString(value, "username"),
184
194
  from_release_id: readNullableString(value, "from_release_id"),
185
195
  from_bundle_id: fromBundleId,
186
196
  to_release_id: readNullableString(value, "to_release_id"),
@@ -188,10 +198,7 @@ export const parsePrismaBundleEventRow = (value: unknown): BundleEventRow => {
188
198
  platform,
189
199
  app_version: readString(value, "app_version"),
190
200
  channel: readString(value, "channel"),
191
- cohort: readString(value, "cohort"),
192
- update_strategy: updateStrategy,
193
- fingerprint_hash: readNullableString(value, "fingerprint_hash"),
194
- sdk_version: readNullableString(value, "sdk_version"),
201
+ metadata,
195
202
  received_at_ms: readNumber(value, "received_at_ms"),
196
203
  } as BundleEventRow;
197
204
  };