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

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (542) hide show
  1. package/dist/_virtual/_rolldown/runtime.cjs +1 -1
  2. package/dist/adapters/drizzle.cjs +35 -69
  3. package/dist/adapters/drizzle.d.cts +13 -6
  4. package/dist/adapters/drizzle.d.mts +13 -6
  5. package/dist/adapters/drizzle.mjs +34 -69
  6. package/dist/adapters/drizzleExecutor.cjs +114 -0
  7. package/dist/adapters/drizzleExecutor.d.cts +9 -0
  8. package/dist/adapters/drizzleExecutor.d.mts +9 -0
  9. package/dist/adapters/drizzleExecutor.mjs +112 -0
  10. package/dist/adapters/kysely.cjs +25 -31
  11. package/dist/adapters/kysely.d.cts +10 -7
  12. package/dist/adapters/kysely.d.mts +10 -7
  13. package/dist/adapters/kysely.mjs +25 -31
  14. package/dist/adapters/kyselyExecutor.cjs +32 -0
  15. package/dist/adapters/kyselyExecutor.d.cts +12 -0
  16. package/dist/adapters/kyselyExecutor.d.mts +12 -0
  17. package/dist/adapters/kyselyExecutor.mjs +32 -0
  18. package/dist/adapters/mongodb.cjs +28 -27
  19. package/dist/adapters/mongodb.d.cts +10 -5
  20. package/dist/adapters/mongodb.d.mts +10 -5
  21. package/dist/adapters/mongodb.mjs +28 -27
  22. package/dist/adapters/mongodbAdapter.cjs +174 -0
  23. package/dist/adapters/mongodbAdapter.d.cts +9 -0
  24. package/dist/adapters/mongodbAdapter.d.mts +9 -0
  25. package/dist/adapters/mongodbAdapter.mjs +173 -0
  26. package/dist/adapters/prisma.cjs +38 -220
  27. package/dist/adapters/prisma.d.cts +12 -8
  28. package/dist/adapters/prisma.d.mts +12 -8
  29. package/dist/adapters/prisma.mjs +38 -219
  30. package/dist/adapters/prismaExecutor.cjs +64 -0
  31. package/dist/adapters/prismaExecutor.mjs +64 -0
  32. package/dist/adapters/sqlProviders.cjs +9 -0
  33. package/dist/adapters/sqlProviders.mjs +9 -0
  34. package/dist/apiKeys.cjs +8 -8
  35. package/dist/apiKeys.d.cts +1 -24
  36. package/dist/apiKeys.d.mts +1 -24
  37. package/dist/apiKeys.mjs +5 -9
  38. package/dist/assembly/assemblePlugins.cjs +147 -0
  39. package/dist/assembly/assemblePlugins.d.cts +12 -0
  40. package/dist/assembly/assemblePlugins.d.mts +12 -0
  41. package/dist/assembly/assemblePlugins.mjs +146 -0
  42. package/dist/assembly/databasePlugins.cjs +23 -0
  43. package/dist/assembly/databasePlugins.d.cts +43 -0
  44. package/dist/assembly/databasePlugins.d.mts +43 -0
  45. package/dist/assembly/databasePlugins.mjs +22 -0
  46. package/dist/core/api.cjs +91 -0
  47. package/dist/core/api.d.cts +65 -0
  48. package/dist/core/api.d.mts +65 -0
  49. package/dist/core/api.mjs +87 -0
  50. package/dist/core/baseCandidates.cjs +71 -0
  51. package/dist/core/baseCandidates.d.cts +17 -0
  52. package/dist/core/baseCandidates.d.mts +17 -0
  53. package/dist/core/baseCandidates.mjs +69 -0
  54. package/dist/core/operations.cjs +350 -0
  55. package/dist/core/operations.mjs +350 -0
  56. package/dist/core/reads.cjs +273 -0
  57. package/dist/core/reads.d.cts +48 -0
  58. package/dist/core/reads.d.mts +48 -0
  59. package/dist/core/reads.mjs +267 -0
  60. package/dist/core/releases.cjs +193 -0
  61. package/dist/core/releases.mjs +190 -0
  62. package/dist/core/schema.cjs +279 -0
  63. package/dist/core/schema.d.cts +307 -0
  64. package/dist/core/schema.d.mts +307 -0
  65. package/dist/core/schema.mjs +277 -0
  66. package/dist/core/writes.cjs +96 -0
  67. package/dist/core/writes.mjs +91 -0
  68. package/dist/createHotUpdaterCore.cjs +61 -63
  69. package/dist/createHotUpdaterCore.d.cts +53 -45
  70. package/dist/createHotUpdaterCore.d.mts +53 -45
  71. package/dist/createHotUpdaterCore.mjs +61 -63
  72. package/dist/database/cursor.cjs +44 -0
  73. package/dist/database/cursor.d.cts +7 -0
  74. package/dist/database/cursor.d.mts +7 -0
  75. package/dist/database/cursor.mjs +40 -0
  76. package/dist/database/database.cjs +44 -0
  77. package/dist/database/database.d.cts +123 -0
  78. package/dist/database/database.d.mts +123 -0
  79. package/dist/database/database.mjs +44 -0
  80. package/dist/database/definitions.d.cts +68 -0
  81. package/dist/database/definitions.d.mts +68 -0
  82. package/dist/database/engine.cjs +37 -0
  83. package/dist/database/engine.d.cts +40 -0
  84. package/dist/database/engine.d.mts +40 -0
  85. package/dist/database/engine.mjs +37 -0
  86. package/dist/database/engineAggregates.cjs +115 -0
  87. package/dist/database/engineAggregates.mjs +112 -0
  88. package/dist/database/engineReads.cjs +180 -0
  89. package/dist/database/engineReads.d.cts +35 -0
  90. package/dist/database/engineReads.d.mts +35 -0
  91. package/dist/database/engineReads.mjs +179 -0
  92. package/dist/database/engineTransaction.cjs +403 -0
  93. package/dist/database/engineTransaction.d.cts +26 -0
  94. package/dist/database/engineTransaction.d.mts +26 -0
  95. package/dist/database/engineTransaction.mjs +402 -0
  96. package/dist/database/errors.cjs +27 -0
  97. package/dist/database/errors.d.cts +21 -0
  98. package/dist/database/errors.d.mts +21 -0
  99. package/dist/database/errors.mjs +24 -0
  100. package/dist/database/fence.cjs +124 -0
  101. package/dist/database/fence.d.cts +42 -0
  102. package/dist/database/fence.d.mts +42 -0
  103. package/dist/database/fence.mjs +116 -0
  104. package/dist/database/index.cjs +127 -0
  105. package/dist/database/index.d.cts +17 -0
  106. package/dist/database/index.d.mts +17 -0
  107. package/dist/database/index.mjs +15 -0
  108. package/dist/database/kv/kvAdapter.cjs +273 -0
  109. package/dist/database/kv/kvAdapter.d.cts +101 -0
  110. package/dist/database/kv/kvAdapter.d.mts +101 -0
  111. package/dist/database/kv/kvAdapter.mjs +272 -0
  112. package/dist/database/resolveSchema.cjs +196 -0
  113. package/dist/database/resolveSchema.d.cts +42 -0
  114. package/dist/database/resolveSchema.d.mts +42 -0
  115. package/dist/database/resolveSchema.mjs +193 -0
  116. package/dist/database/schema.cjs +21 -0
  117. package/dist/database/schema.d.cts +61 -0
  118. package/dist/database/schema.d.mts +61 -0
  119. package/dist/database/schema.mjs +20 -0
  120. package/dist/database/sql/sqlAdapter.cjs +282 -0
  121. package/dist/database/sql/sqlAdapter.d.cts +46 -0
  122. package/dist/database/sql/sqlAdapter.d.mts +46 -0
  123. package/dist/database/sql/sqlAdapter.mjs +279 -0
  124. package/dist/database/sql/sqlSchema.cjs +115 -0
  125. package/dist/database/sql/sqlSchema.d.cts +8 -0
  126. package/dist/database/sql/sqlSchema.d.mts +8 -0
  127. package/dist/database/sql/sqlSchema.mjs +111 -0
  128. package/dist/db/builtInDatabase.cjs +104 -0
  129. package/dist/db/builtInDatabase.d.cts +38 -0
  130. package/dist/db/builtInDatabase.d.mts +38 -0
  131. package/dist/db/builtInDatabase.mjs +97 -0
  132. package/dist/db/createBundleDiff.cjs +6 -6
  133. package/dist/db/createBundleDiff.d.cts +4 -7
  134. package/dist/db/createBundleDiff.d.mts +4 -7
  135. package/dist/db/createBundleDiff.mjs +5 -5
  136. package/dist/db/engineDrizzleSchema.cjs +54 -0
  137. package/dist/db/engineDrizzleSchema.mjs +54 -0
  138. package/dist/db/engineMigrator.cjs +53 -0
  139. package/dist/db/engineMigrator.mjs +53 -0
  140. package/dist/db/enginePrismaSchema.cjs +85 -0
  141. package/dist/db/enginePrismaSchema.d.cts +5 -0
  142. package/dist/db/enginePrismaSchema.d.mts +5 -0
  143. package/dist/db/enginePrismaSchema.mjs +84 -0
  144. package/dist/db/engineSql.cjs +26 -0
  145. package/dist/db/engineSql.d.cts +17 -0
  146. package/dist/db/engineSql.d.mts +17 -0
  147. package/dist/db/engineSql.mjs +25 -0
  148. package/dist/db/engineSqlMigrator.cjs +66 -0
  149. package/dist/db/engineSqlMigrator.mjs +66 -0
  150. package/dist/db/fixedMigratorShared.cjs +0 -11
  151. package/dist/db/fixedMigratorShared.mjs +1 -8
  152. package/dist/db/index.cjs +23 -8
  153. package/dist/db/index.d.cts +10 -4
  154. package/dist/db/index.d.mts +10 -4
  155. package/dist/db/index.mjs +16 -8
  156. package/dist/db/releaseCatalog.cjs +20 -44
  157. package/dist/db/releaseCatalog.d.cts +2 -3
  158. package/dist/db/releaseCatalog.d.mts +2 -3
  159. package/dist/db/releaseCatalog.mjs +20 -44
  160. package/dist/db/schemaSettings.cjs +63 -0
  161. package/dist/db/schemaSettings.d.cts +12 -0
  162. package/dist/db/schemaSettings.d.mts +12 -0
  163. package/dist/db/schemaSettings.mjs +62 -0
  164. package/dist/db/settingsMigrator.cjs +92 -0
  165. package/dist/db/settingsMigrator.mjs +89 -0
  166. package/dist/db/types.cjs +3 -12
  167. package/dist/db/types.d.cts +26 -69
  168. package/dist/db/types.d.mts +26 -69
  169. package/dist/db/types.mjs +2 -11
  170. package/dist/db/updateArtifacts.cjs +38 -68
  171. package/dist/db/updateArtifacts.mjs +40 -69
  172. package/dist/handler.cjs +72 -43
  173. package/dist/handler.d.cts +3 -6
  174. package/dist/handler.d.mts +3 -6
  175. package/dist/handler.mjs +73 -43
  176. package/dist/handlerAdminRoutes.cjs +375 -0
  177. package/dist/handlerAdminRoutes.mjs +373 -0
  178. package/dist/handlerParameters.cjs +6 -11
  179. package/dist/handlerParameters.mjs +6 -10
  180. package/dist/handlerReleaseCatalogRoutes.cjs +11 -14
  181. package/dist/handlerReleaseCatalogRoutes.mjs +11 -13
  182. package/dist/handlerTypes.d.cts +2 -56
  183. package/dist/handlerTypes.d.mts +2 -56
  184. package/dist/handlerVersionRoutes.cjs +20 -4
  185. package/dist/handlerVersionRoutes.d.cts +1 -0
  186. package/dist/handlerVersionRoutes.d.mts +1 -0
  187. package/dist/handlerVersionRoutes.mjs +20 -4
  188. package/dist/index.cjs +4 -7
  189. package/dist/index.d.cts +10 -9
  190. package/dist/index.d.mts +10 -9
  191. package/dist/index.mjs +4 -4
  192. package/dist/insights/domain.d.cts +53 -70
  193. package/dist/insights/domain.d.mts +53 -70
  194. package/dist/insights/errors.cjs +35 -8
  195. package/dist/insights/errors.mjs +35 -8
  196. package/dist/insights/eventInput.cjs +64 -24
  197. package/dist/insights/eventInput.mjs +63 -25
  198. package/dist/insights/provider.cjs +356 -0
  199. package/dist/insights/provider.d.cts +6 -0
  200. package/dist/insights/provider.d.mts +6 -0
  201. package/dist/insights/provider.mjs +355 -0
  202. package/dist/insights/queryInput.cjs +78 -43
  203. package/dist/insights/queryInput.mjs +76 -40
  204. package/dist/insights/routes.cjs +94 -34
  205. package/dist/insights/routes.mjs +93 -35
  206. package/dist/insights/types.d.cts +27 -12
  207. package/dist/insights/types.d.mts +27 -12
  208. package/dist/node.d.cts +1 -2
  209. package/dist/node.d.mts +1 -2
  210. package/dist/package.cjs +1 -1
  211. package/dist/package.mjs +1 -1
  212. package/dist/plugins/api-keys/index.cjs +50 -0
  213. package/dist/plugins/api-keys/index.d.cts +85 -0
  214. package/dist/plugins/api-keys/index.d.mts +85 -0
  215. package/dist/plugins/api-keys/index.mjs +47 -0
  216. package/dist/plugins/api-keys/model.cjs +58 -0
  217. package/dist/plugins/api-keys/model.d.cts +8 -0
  218. package/dist/plugins/api-keys/model.d.mts +8 -0
  219. package/dist/plugins/api-keys/model.mjs +58 -0
  220. package/dist/plugins/api-keys/schema.cjs +38 -0
  221. package/dist/plugins/api-keys/schema.d.cts +44 -0
  222. package/dist/plugins/api-keys/schema.d.mts +44 -0
  223. package/dist/plugins/api-keys/schema.mjs +39 -0
  224. package/dist/plugins/builtIn.cjs +7 -0
  225. package/dist/plugins/builtIn.mjs +6 -0
  226. package/dist/plugins/definePlugin.cjs +5 -0
  227. package/dist/plugins/definePlugin.d.cts +73 -0
  228. package/dist/plugins/definePlugin.d.mts +73 -0
  229. package/dist/plugins/definePlugin.mjs +5 -0
  230. package/dist/plugins/index.cjs +17 -0
  231. package/dist/plugins/index.d.cts +9 -0
  232. package/dist/plugins/index.d.mts +9 -0
  233. package/dist/plugins/index.mjs +7 -0
  234. package/dist/plugins/insights/index.cjs +48 -0
  235. package/dist/plugins/insights/index.d.cts +295 -0
  236. package/dist/plugins/insights/index.d.mts +295 -0
  237. package/dist/plugins/insights/index.mjs +44 -0
  238. package/dist/plugins/insights/model.cjs +17 -0
  239. package/dist/plugins/insights/model.d.cts +10 -0
  240. package/dist/plugins/insights/model.d.mts +10 -0
  241. package/dist/plugins/insights/model.mjs +17 -0
  242. package/dist/plugins/insights/reads.cjs +471 -0
  243. package/dist/plugins/insights/reads.mjs +466 -0
  244. package/dist/plugins/insights/recordEvent.cjs +135 -0
  245. package/dist/plugins/insights/recordEvent.d.cts +13 -0
  246. package/dist/plugins/insights/recordEvent.d.mts +13 -0
  247. package/dist/plugins/insights/recordEvent.mjs +132 -0
  248. package/dist/plugins/insights/schema.cjs +347 -0
  249. package/dist/plugins/insights/schema.d.cts +258 -0
  250. package/dist/plugins/insights/schema.d.mts +258 -0
  251. package/dist/plugins/insights/schema.mjs +344 -0
  252. package/dist/storageAccess.cjs +0 -1
  253. package/dist/types/index.d.cts +2 -29
  254. package/dist/types/index.d.mts +2 -29
  255. package/package.json +30 -7
  256. package/src/adapters/drizzle.conformance.integration.spec.ts +34 -0
  257. package/src/adapters/drizzle.readBudgets.integration.spec.ts +41 -0
  258. package/src/adapters/drizzle.spec.ts +277 -208
  259. package/src/adapters/drizzle.ts +48 -128
  260. package/src/adapters/drizzleExecutor.ts +166 -0
  261. package/src/adapters/kysely.conformance.integration.spec.ts +36 -0
  262. package/src/adapters/kysely.readBudgets.integration.spec.ts +42 -0
  263. package/src/adapters/kysely.spec.ts +212 -117
  264. package/src/adapters/kysely.ts +32 -87
  265. package/src/adapters/kyselyExecutor.ts +53 -0
  266. package/src/adapters/mongodb.integration.spec.ts +180 -0
  267. package/src/adapters/mongodb.readBudgets.integration.spec.ts +61 -0
  268. package/src/adapters/mongodb.ts +36 -65
  269. package/src/adapters/mongodbAdapter.ts +293 -0
  270. package/src/adapters/prisma.conformance.integration.spec.ts +36 -0
  271. package/src/adapters/prisma.integration.spec.ts +138 -0
  272. package/src/adapters/prisma.readBudgets.integration.spec.ts +40 -0
  273. package/src/adapters/prisma.spec.ts +226 -173
  274. package/src/adapters/prisma.ts +60 -451
  275. package/src/adapters/prismaExecutor.ts +107 -0
  276. package/src/adapters/prismaTestClients.ts +175 -0
  277. package/src/adapters/sqlProviders.ts +14 -0
  278. package/src/apiKeys.integration.spec.ts +19 -119
  279. package/src/apiKeys.spec.ts +39 -35
  280. package/src/apiKeys.ts +2 -8
  281. package/src/assembly/assemblePlugins.ts +269 -0
  282. package/src/assembly/assembly.spec.ts +325 -0
  283. package/src/assembly/assembly.types.spec.ts +155 -0
  284. package/src/assembly/builtInRoutes.spec.ts +213 -0
  285. package/src/assembly/databasePlugins.spec.ts +71 -0
  286. package/src/assembly/databasePlugins.ts +96 -0
  287. package/src/core/api.ts +139 -0
  288. package/src/core/baseCandidates.spec.ts +378 -0
  289. package/src/core/baseCandidates.ts +136 -0
  290. package/src/core/index.ts +44 -0
  291. package/src/core/operations.spec.ts +415 -0
  292. package/src/core/operations.ts +551 -0
  293. package/src/core/reads.spec.ts +300 -0
  294. package/src/core/reads.ts +417 -0
  295. package/src/core/releases.spec.ts +308 -0
  296. package/src/core/releases.ts +345 -0
  297. package/src/core/schema.ts +173 -0
  298. package/src/core/writes.ts +160 -0
  299. package/src/createHotUpdaterCore.ts +191 -167
  300. package/src/database/cursor.ts +65 -0
  301. package/src/database/database.ts +335 -0
  302. package/src/database/database.types.spec.ts +135 -0
  303. package/src/database/definitions.ts +72 -0
  304. package/src/database/engine.ts +62 -0
  305. package/src/database/engineAggregates.spec.ts +539 -0
  306. package/src/database/engineAggregates.ts +193 -0
  307. package/src/database/engineReads.spec.ts +219 -0
  308. package/src/database/engineReads.ts +302 -0
  309. package/src/database/engineTransaction.spec.ts +710 -0
  310. package/src/database/engineTransaction.ts +588 -0
  311. package/src/database/errors.ts +30 -0
  312. package/src/database/fence.spec.ts +223 -0
  313. package/src/database/fence.ts +171 -0
  314. package/src/database/index.ts +154 -0
  315. package/src/database/kv/kvAdapter.conformance.integration.spec.ts +17 -0
  316. package/src/database/kv/kvAdapter.readBudgets.integration.spec.ts +17 -0
  317. package/src/database/kv/kvAdapter.spec.ts +468 -0
  318. package/src/database/kv/kvAdapter.ts +450 -0
  319. package/src/database/kv/kvTestStore.ts +91 -0
  320. package/src/database/memory.readBudgets.integration.spec.ts +13 -0
  321. package/src/database/resolveSchema.spec.ts +230 -0
  322. package/src/database/resolveSchema.ts +372 -0
  323. package/src/database/schema.ts +169 -0
  324. package/src/database/schema.types.spec.ts +94 -0
  325. package/src/database/sql/docker-compose.yml +36 -0
  326. package/src/database/sql/sqlAdapter.integration.spec.ts +148 -0
  327. package/src/database/sql/sqlAdapter.readBudgets.integration.spec.ts +109 -0
  328. package/src/database/sql/sqlAdapter.spec.ts +255 -0
  329. package/src/database/sql/sqlAdapter.ts +532 -0
  330. package/src/database/sql/sqlSchema.ts +205 -0
  331. package/src/database/sql/sqlTestExecutors.ts +183 -0
  332. package/src/databaseTestSuite.spec.ts +39 -0
  333. package/src/db/builtInDatabase.ts +149 -0
  334. package/src/db/bundleRows.spec.ts +3 -3
  335. package/src/db/createBundleDiff.spec.ts +43 -29
  336. package/src/db/createBundleDiff.ts +13 -7
  337. package/src/db/engineDrizzleSchema.ts +72 -0
  338. package/src/db/engineMigrator.ts +105 -0
  339. package/src/db/enginePrismaSchema.ts +147 -0
  340. package/src/db/engineSql.spec.ts +129 -0
  341. package/src/db/engineSql.ts +48 -0
  342. package/src/db/engineSqlMigrator.ts +116 -0
  343. package/src/db/fixedMigratorShared.ts +1 -20
  344. package/src/db/index.spec.ts +116 -824
  345. package/src/db/index.ts +43 -14
  346. package/src/db/pluginTables.spec.ts +218 -0
  347. package/src/db/releaseCatalog.ts +48 -90
  348. package/src/db/schemaSettings.ts +104 -0
  349. package/src/db/settingsMigrator.spec.ts +65 -0
  350. package/src/db/settingsMigrator.ts +152 -0
  351. package/src/db/types.ts +25 -165
  352. package/src/db/updateArtifacts.spec.ts +170 -294
  353. package/src/db/updateArtifacts.ts +74 -142
  354. package/src/db/updateCheck.bench.ts +47 -0
  355. package/src/handler-standalone.integration.spec.ts +204 -412
  356. package/src/handler.spec.ts +134 -51
  357. package/src/handler.testFixtures.ts +14 -19
  358. package/src/handler.ts +163 -75
  359. package/src/handlerAdminRoutes.spec.ts +183 -0
  360. package/src/handlerAdminRoutes.ts +536 -0
  361. package/src/handlerAuth.integration.spec.ts +3 -3
  362. package/src/handlerManagement.spec.ts +136 -196
  363. package/src/handlerReleaseCatalogRoutes.ts +15 -17
  364. package/src/handlerTypes.ts +3 -80
  365. package/src/handlerVersionRoutes.ts +20 -7
  366. package/src/index.ts +7 -14
  367. package/src/insights/domain.ts +56 -77
  368. package/src/insights/errors.spec.ts +48 -0
  369. package/src/insights/errors.ts +50 -6
  370. package/src/insights/eventInput.ts +80 -27
  371. package/src/insights/insights.integration.spec.ts +525 -44
  372. package/src/insights/provider.spec.ts +574 -0
  373. package/src/insights/provider.ts +667 -0
  374. package/src/insights/queryInput.ts +113 -73
  375. package/src/insights/routes.ts +125 -69
  376. package/src/insights/types.ts +47 -36
  377. package/src/lintRules.spec.ts +76 -0
  378. package/src/plugins/api-keys/apiKeysPlugin.spec.ts +172 -0
  379. package/src/plugins/api-keys/index.ts +66 -0
  380. package/src/plugins/api-keys/model.ts +69 -0
  381. package/src/plugins/api-keys/schema.ts +22 -0
  382. package/src/plugins/builtIn.ts +5 -0
  383. package/src/plugins/definePlugin.ts +100 -0
  384. package/src/plugins/index.ts +55 -0
  385. package/src/plugins/insights/index.ts +86 -0
  386. package/src/plugins/insights/insightsRollout.integration.spec.ts +187 -0
  387. package/src/plugins/insights/model.spec.ts +66 -0
  388. package/src/plugins/insights/model.ts +19 -0
  389. package/src/plugins/insights/reads.spec.ts +725 -0
  390. package/src/plugins/insights/reads.ts +707 -0
  391. package/src/plugins/insights/recordEvent.spec.ts +443 -0
  392. package/src/plugins/insights/recordEvent.ts +238 -0
  393. package/src/plugins/insights/schema.ts +229 -0
  394. package/src/plugins/pluginTestHarness.spec.ts +56 -0
  395. package/src/readBudgets.testFixtures.ts +15 -0
  396. package/src/releaseCatalogRoutes.integration.spec.ts +47 -92
  397. package/src/runtime.spec.ts +91 -77
  398. package/src/runtime.testFixtures.ts +28 -44
  399. package/src/runtimeBundles.integration.spec.ts +112 -0
  400. package/src/testUtilsMutation.integration.spec.ts +215 -0
  401. package/src/testUtilsPackage.integration.spec.ts +176 -0
  402. package/src/types/index.ts +0 -32
  403. package/dist/adapters/databaseConstraintErrors.cjs +0 -23
  404. package/dist/adapters/databaseConstraintErrors.mjs +0 -21
  405. package/dist/adapters/databasePluginUtils.cjs +0 -117
  406. package/dist/adapters/databasePluginUtils.mjs +0 -106
  407. package/dist/adapters/drizzleCrud.cjs +0 -250
  408. package/dist/adapters/drizzleCrud.mjs +0 -249
  409. package/dist/adapters/drizzleLazyDB.cjs +0 -101
  410. package/dist/adapters/drizzleLazyDB.mjs +0 -101
  411. package/dist/adapters/drizzleQuery.cjs +0 -68
  412. package/dist/adapters/drizzleQuery.mjs +0 -67
  413. package/dist/adapters/kyselyCrud.cjs +0 -254
  414. package/dist/adapters/kyselyCrud.mjs +0 -253
  415. package/dist/adapters/kyselyQuery.cjs +0 -56
  416. package/dist/adapters/kyselyQuery.mjs +0 -55
  417. package/dist/adapters/mongodbCollections.cjs +0 -36
  418. package/dist/adapters/mongodbCollections.mjs +0 -30
  419. package/dist/adapters/mongodbQuery.cjs +0 -77
  420. package/dist/adapters/mongodbQuery.mjs +0 -70
  421. package/dist/adapters/mongodbReads.cjs +0 -148
  422. package/dist/adapters/mongodbReads.mjs +0 -147
  423. package/dist/adapters/mongodbWrites.cjs +0 -134
  424. package/dist/adapters/mongodbWrites.mjs +0 -133
  425. package/dist/adapters/prismaQuery.cjs +0 -58
  426. package/dist/adapters/prismaQuery.mjs +0 -56
  427. package/dist/adapters/prismaRows.cjs +0 -198
  428. package/dist/adapters/prismaRows.mjs +0 -188
  429. package/dist/db/databasePluginCore.cjs +0 -138
  430. package/dist/db/databasePluginCore.mjs +0 -137
  431. package/dist/db/fixedMigrator.cjs +0 -79
  432. package/dist/db/fixedMigrator.mjs +0 -78
  433. package/dist/db/fixedMigratorMongo.cjs +0 -319
  434. package/dist/db/fixedMigratorMongo.mjs +0 -319
  435. package/dist/db/mongoMigrationExecution.cjs +0 -11
  436. package/dist/db/mongoMigrationExecution.mjs +0 -11
  437. package/dist/db/schema/mongodb.cjs +0 -25
  438. package/dist/db/schema/mongodb.mjs +0 -25
  439. package/dist/db/schema/registry.cjs +0 -21
  440. package/dist/db/schema/registry.mjs +0 -17
  441. package/dist/db/schema/sql.cjs +0 -101
  442. package/dist/db/schema/sql.mjs +0 -97
  443. package/dist/db/schema/sqlOperations.cjs +0 -27
  444. package/dist/db/schema/sqlOperations.mjs +0 -26
  445. package/dist/db/schemaGenerators.cjs +0 -256
  446. package/dist/db/schemaGenerators.mjs +0 -254
  447. package/dist/db/schemaReadiness.cjs +0 -24
  448. package/dist/db/schemaReadiness.d.cts +0 -8
  449. package/dist/db/schemaReadiness.d.mts +0 -8
  450. package/dist/db/schemaReadiness.mjs +0 -23
  451. package/dist/db/sqlMigrationExecution.cjs +0 -67
  452. package/dist/db/sqlMigrationExecution.mjs +0 -66
  453. package/dist/handlerBundleRoutes.cjs +0 -155
  454. package/dist/handlerBundleRoutes.mjs +0 -155
  455. package/dist/handlerReleaseManagementRoutes.cjs +0 -125
  456. package/dist/handlerReleaseManagementRoutes.mjs +0 -124
  457. package/dist/insights/bounded/activeOverview.cjs +0 -87
  458. package/dist/insights/bounded/activeOverview.mjs +0 -85
  459. package/dist/insights/bounded/installationSearch.cjs +0 -42
  460. package/dist/insights/bounded/installationSearch.mjs +0 -42
  461. package/dist/insights/bounded/persistence.cjs +0 -39
  462. package/dist/insights/bounded/persistence.mjs +0 -38
  463. package/dist/insights/bounded/provider.cjs +0 -170
  464. package/dist/insights/bounded/provider.d.cts +0 -7
  465. package/dist/insights/bounded/provider.d.mts +0 -7
  466. package/dist/insights/bounded/provider.mjs +0 -170
  467. package/dist/insights/bounded/scan.cjs +0 -144
  468. package/dist/insights/bounded/scan.mjs +0 -138
  469. package/dist/insights/persistence.d.cts +0 -6
  470. package/dist/insights/persistence.d.mts +0 -6
  471. package/dist/schema/dsl.cjs +0 -103
  472. package/dist/schema/dsl.mjs +0 -87
  473. package/dist/schema/index.cjs +0 -6
  474. package/dist/schema/index.mjs +0 -7
  475. package/dist/schema/settings.cjs +0 -9
  476. package/dist/schema/settings.mjs +0 -9
  477. package/dist/schema/types.cjs +0 -8
  478. package/dist/schema/types.mjs +0 -6
  479. package/dist/schema/v1_0_0.cjs +0 -364
  480. package/dist/schema/v1_0_0.mjs +0 -357
  481. package/src/adapters/databaseConstraintErrors.ts +0 -25
  482. package/src/adapters/databasePluginTestDatabase.ts +0 -106
  483. package/src/adapters/databasePluginUtils.spec.ts +0 -29
  484. package/src/adapters/databasePluginUtils.ts +0 -214
  485. package/src/adapters/drizzleCrud.ts +0 -419
  486. package/src/adapters/drizzleLazyDB.ts +0 -257
  487. package/src/adapters/drizzleQuery.ts +0 -164
  488. package/src/adapters/kyselyCrud.ts +0 -588
  489. package/src/adapters/kyselyQuery.ts +0 -128
  490. package/src/adapters/mongodb.spec.ts +0 -141
  491. package/src/adapters/mongodbCollections.ts +0 -62
  492. package/src/adapters/mongodbQuery.ts +0 -226
  493. package/src/adapters/mongodbReads.ts +0 -311
  494. package/src/adapters/mongodbRows.spec.ts +0 -64
  495. package/src/adapters/mongodbRows.ts +0 -118
  496. package/src/adapters/mongodbTestClient.ts +0 -342
  497. package/src/adapters/mongodbTestFilter.ts +0 -166
  498. package/src/adapters/mongodbWrites.ts +0 -260
  499. package/src/adapters/prismaQuery.ts +0 -129
  500. package/src/adapters/prismaRows.spec.ts +0 -98
  501. package/src/adapters/prismaRows.ts +0 -301
  502. package/src/adapters/prismaTestClient.ts +0 -396
  503. package/src/calculatePagination.ts +0 -34
  504. package/src/db/databasePluginCore.spec.ts +0 -62
  505. package/src/db/databasePluginCore.testFixtures.ts +0 -76
  506. package/src/db/databasePluginCore.ts +0 -185
  507. package/src/db/databasePluginUpdateCheck.bench.ts +0 -107
  508. package/src/db/fixedMigrator.spec.ts +0 -231
  509. package/src/db/fixedMigrator.ts +0 -147
  510. package/src/db/fixedMigratorMongo.spec.ts +0 -192
  511. package/src/db/fixedMigratorMongo.ts +0 -425
  512. package/src/db/hotUpdaterSchema.ts +0 -5
  513. package/src/db/mongoMigrationExecution.ts +0 -23
  514. package/src/db/schema/definitions.ts +0 -1
  515. package/src/db/schema/mongodb.ts +0 -40
  516. package/src/db/schema/registry.ts +0 -55
  517. package/src/db/schema/sql.ts +0 -241
  518. package/src/db/schema/sqlOperations.ts +0 -63
  519. package/src/db/schema/types.ts +0 -1
  520. package/src/db/schemaGenerators.ts +0 -466
  521. package/src/db/schemaReadiness.ts +0 -34
  522. package/src/db/sqlMigrationExecution.spec.ts +0 -65
  523. package/src/db/sqlMigrationExecution.ts +0 -108
  524. package/src/db/types.spec.ts +0 -55
  525. package/src/handlerBundleRoutes.ts +0 -259
  526. package/src/handlerReleaseManagementRoutes.ts +0 -213
  527. package/src/insights/bounded/activeOverview.spec.ts +0 -189
  528. package/src/insights/bounded/activeOverview.ts +0 -148
  529. package/src/insights/bounded/installationSearch.spec.ts +0 -130
  530. package/src/insights/bounded/installationSearch.ts +0 -69
  531. package/src/insights/bounded/persistence.ts +0 -43
  532. package/src/insights/bounded/provider.spec.ts +0 -219
  533. package/src/insights/bounded/provider.ts +0 -229
  534. package/src/insights/bounded/scan.ts +0 -235
  535. package/src/insights/persistence.ts +0 -10
  536. package/src/schema/dsl-all-versions.spec.ts +0 -35
  537. package/src/schema/dsl.ts +0 -187
  538. package/src/schema/index.ts +0 -10
  539. package/src/schema/settings.ts +0 -15
  540. package/src/schema/types.ts +0 -79
  541. package/src/schema/v1_0_0.spec.ts +0 -146
  542. package/src/schema/v1_0_0.ts +0 -465
@@ -0,0 +1,710 @@
1
+ import {
2
+ createMemoryAdapter,
3
+ type DatabaseAdapter,
4
+ type StoredRow,
5
+ type WriteOp,
6
+ type WriteResult,
7
+ } from "@hot-updater/plugin-core/internal";
8
+ import { describe, expect, it } from "vitest";
9
+
10
+ import { createDatabaseEngine, type HotUpdaterTransaction } from "./database";
11
+ import { DatabaseQueryError } from "./engineReads";
12
+ import type { RetryOptions } from "./engineTransaction";
13
+ import {
14
+ DatabaseAmbiguousCommitError,
15
+ DatabaseConflictError,
16
+ DatabaseConstraintError,
17
+ DatabaseTransactionError,
18
+ } from "./errors";
19
+ import { resolveSchema } from "./resolveSchema";
20
+ import { defineTable } from "./schema";
21
+
22
+ const channels = defineTable(
23
+ { name: { type: "string", maxLength: 32 } },
24
+ { key: ["name"] },
25
+ );
26
+
27
+ const bundles = defineTable(
28
+ {
29
+ id: { type: "string", maxLength: 36 },
30
+ channel: {
31
+ type: "string",
32
+ maxLength: 32,
33
+ references: { model: "channels", onDelete: "restrict" },
34
+ },
35
+ hash: { type: "string", maxLength: 64, unique: true },
36
+ note: { type: "string", required: false },
37
+ },
38
+ { key: ["id"], indexes: { byChannel: { eq: ["channel"], sort: ["id"] } } },
39
+ );
40
+
41
+ const patches = defineTable(
42
+ {
43
+ id: { type: "string", maxLength: 80 },
44
+ bundle_id: {
45
+ type: "string",
46
+ maxLength: 36,
47
+ references: { model: "bundles", onDelete: "cascade" },
48
+ },
49
+ base_bundle_id: {
50
+ type: "string",
51
+ maxLength: 36,
52
+ references: { model: "bundles", onDelete: "cascade" },
53
+ },
54
+ },
55
+ {
56
+ key: ["id"],
57
+ indexes: {
58
+ byBundle: { eq: ["bundle_id"], sort: ["id"] },
59
+ byBase: { eq: ["base_bundle_id"], sort: ["id"] },
60
+ },
61
+ },
62
+ );
63
+
64
+ const catalogs = defineTable(
65
+ {
66
+ id: { type: "string", maxLength: 36 },
67
+ latest: { type: "string", maxLength: 36, required: false },
68
+ },
69
+ { key: ["id"] },
70
+ );
71
+
72
+ const releases = defineTable(
73
+ {
74
+ catalog_id: { type: "string", maxLength: 36 },
75
+ id: { type: "string", maxLength: 36 },
76
+ },
77
+ {
78
+ key: ["catalog_id", "id"],
79
+ indexes: {
80
+ byCatalog: {
81
+ eq: ["catalog_id"],
82
+ sort: ["id"],
83
+ root: { model: "catalogs" },
84
+ },
85
+ all: { eq: [], sort: ["id"] },
86
+ },
87
+ },
88
+ );
89
+
90
+ const counters = defineTable(
91
+ {
92
+ id: { type: "string", maxLength: 36 },
93
+ value: { type: "integer" },
94
+ on_call: { type: "boolean" },
95
+ },
96
+ { key: ["id"] },
97
+ );
98
+
99
+ const core = {
100
+ id: "core",
101
+ schema: { channels, bundles, patches, catalogs, releases, counters },
102
+ } as const;
103
+ const schema = resolveSchema([core]);
104
+ const table = (name: string) => schema.models.get(name)!.table;
105
+
106
+ type Tx = HotUpdaterTransaction<typeof core.schema>;
107
+ type Fault = WriteResult | "throw" | undefined;
108
+
109
+ const setup = async (
110
+ options: {
111
+ readonly maxOps?: number;
112
+ readonly retry?: RetryOptions;
113
+ readonly seed?: false;
114
+ } = {},
115
+ ) => {
116
+ const memory = createMemoryAdapter(
117
+ options.maxOps === undefined ? {} : { maxOps: options.maxOps },
118
+ );
119
+ await memory.migrations?.apply(schema.tables);
120
+ const faults: { inject?: (ops: readonly WriteOp[]) => Fault } = {};
121
+ const writes: (readonly WriteOp[])[] = [];
122
+ const adapter: DatabaseAdapter = {
123
+ ...memory,
124
+ async write(ops) {
125
+ writes.push(ops);
126
+ const fault = faults.inject?.(ops);
127
+ if (fault === "throw") throw new Error("connection reset");
128
+ return fault ?? memory.write(ops);
129
+ },
130
+ };
131
+ const engine = createDatabaseEngine({
132
+ adapter,
133
+ schema,
134
+ verify: true,
135
+ retry: options.retry ?? { attempts: 8, baseDelayMs: 0, maxDelayMs: 1 },
136
+ });
137
+ const db = engine.database(core);
138
+ if (options.seed === false) return { memory, faults, writes, db };
139
+ await db.transaction(async (tx) => {
140
+ tx.create("channels", { name: "prod" });
141
+ for (const id of ["b0", "b1", "b2"]) {
142
+ tx.create("bundles", { id, channel: "prod", hash: `h-${id}` });
143
+ }
144
+ tx.create("patches", { id: "p1", bundle_id: "b1", base_bundle_id: "b0" });
145
+ tx.create("patches", { id: "p2", bundle_id: "b2", base_bundle_id: "b1" });
146
+ tx.create("catalogs", { id: "c1" });
147
+ tx.create("counters", { id: "c", value: 0, on_call: true });
148
+ tx.create("counters", { id: "d1", value: 0, on_call: true });
149
+ tx.create("counters", { id: "d2", value: 0, on_call: true });
150
+ });
151
+ writes.length = 0;
152
+ return { memory, faults, writes, db };
153
+ };
154
+
155
+ /** Fails the next write once with `fault`. */
156
+ const failOnce = (fault: Fault) => {
157
+ let used = false;
158
+ return () => {
159
+ if (used) return undefined;
160
+ used = true;
161
+ return fault;
162
+ };
163
+ };
164
+
165
+ /** Resolves for everyone once `parties` callers have arrived. */
166
+ const barrier = (parties: number) => {
167
+ let arrived = 0;
168
+ let open!: () => void;
169
+ const all = new Promise<void>((resolve) => {
170
+ open = resolve;
171
+ });
172
+ return () => {
173
+ arrived += 1;
174
+ if (arrived === parties) open();
175
+ return all;
176
+ };
177
+ };
178
+
179
+ const reasonOf = (promise: Promise<unknown>) =>
180
+ promise.then(
181
+ () => "committed",
182
+ (error: unknown) =>
183
+ error instanceof DatabaseConstraintError ? error.reason : error,
184
+ );
185
+
186
+ describe("engine transactions", () => {
187
+ it("coalesces writes to one guarded op per key and skips a lone read", async () => {
188
+ const { db, writes } = await setup();
189
+ const seen = await db.transaction(async (tx) => {
190
+ const row = (await tx.findOne("counters", { id: "c" }))!;
191
+ tx.update("counters", row, { value: row.value + 1 });
192
+ tx.update("counters", row, { value: row.value + 2 });
193
+ return row.value;
194
+ });
195
+ expect(seen).toBe(0);
196
+ expect(writes).toEqual([
197
+ [
198
+ expect.objectContaining({
199
+ type: "patch",
200
+ key: ["c"],
201
+ set: { value: 2 },
202
+ guard: { v: 0 },
203
+ }),
204
+ ],
205
+ ]);
206
+ await expect(
207
+ db.transaction((tx) => tx.findOne("counters", { id: "c" })),
208
+ ).resolves.toMatchObject({ value: 2, _v: 1 });
209
+
210
+ writes.length = 0;
211
+ await db.transaction((tx) => tx.findOne("counters", { id: "c" }));
212
+ expect(writes).toEqual([]);
213
+ });
214
+
215
+ it("injects a guard failure at every op and applies the rerun exactly once", async () => {
216
+ const run = async (tx: Tx) => {
217
+ await tx.findOne("channels", { name: "prod" });
218
+ const catalog = (await tx.findOne("catalogs", { id: "c1" }))!;
219
+ tx.update("catalogs", catalog, { latest: "r1" });
220
+ tx.create("releases", { catalog_id: "c1", id: "r1" });
221
+ tx.create("patches", { id: "p3", bundle_id: "b2", base_bundle_id: "b0" });
222
+ };
223
+ const probe = await setup();
224
+ await probe.db.transaction(run);
225
+ const ops = probe.writes[0]!;
226
+ expect(ops.map(({ type, table }) => `${type} ${table.name}`)).toEqual([
227
+ "insert releases",
228
+ "insert patches",
229
+ "patch catalogs",
230
+ "increment bundles",
231
+ "increment bundles",
232
+ "check channels",
233
+ ]);
234
+
235
+ for (const failedOp of ops.keys()) {
236
+ const { db, faults } = await setup();
237
+ faults.inject = failOnce({ ok: false, failedOp });
238
+ let runs = 0;
239
+ await db.transaction(async (tx) => {
240
+ runs += 1;
241
+ await run(tx);
242
+ });
243
+ expect(runs, `failedOp ${failedOp}`).toBe(2);
244
+ await expect(db.findOne("bundles", { id: "b2" })).resolves.toMatchObject({
245
+ _refs_patches_bundle_id: 2,
246
+ });
247
+ await expect(db.findOne("bundles", { id: "b0" })).resolves.toMatchObject({
248
+ _refs_patches_base_bundle_id: 2,
249
+ });
250
+ await expect(
251
+ db.transaction((tx) => tx.findOne("catalogs", { id: "c1" })),
252
+ ).resolves.toMatchObject({ latest: "r1", _v: 1 });
253
+ }
254
+ });
255
+
256
+ it("reruns transient failures, reports ambiguous commits, and stops at the budget", async () => {
257
+ const bump = async (tx: Tx) => {
258
+ const row = (await tx.findOne("counters", { id: "c" }))!;
259
+ tx.update("counters", row, { value: row.value + 1 });
260
+ };
261
+ const transient = await setup();
262
+ transient.faults.inject = failOnce({ ok: false, retry: true });
263
+ await transient.db.transaction(bump);
264
+ expect(transient.writes).toHaveLength(2);
265
+
266
+ const ambiguous = await setup();
267
+ ambiguous.faults.inject = failOnce("throw");
268
+ let runs = 0;
269
+ await expect(
270
+ ambiguous.db.transaction(async (tx) => {
271
+ runs += 1;
272
+ await bump(tx);
273
+ }),
274
+ ).rejects.toThrow(DatabaseAmbiguousCommitError);
275
+ expect(runs).toBe(1);
276
+
277
+ const exhausted = await setup({
278
+ retry: { attempts: 3, baseDelayMs: 0, maxDelayMs: 0 },
279
+ });
280
+ exhausted.faults.inject = () => ({ ok: false, failedOp: 0 });
281
+ await expect(exhausted.db.transaction(bump)).rejects.toThrow(
282
+ DatabaseConflictError,
283
+ );
284
+ expect(exhausted.writes).toHaveLength(3);
285
+ await expect(
286
+ exhausted.db.findOne("counters", { id: "c" }),
287
+ ).resolves.toMatchObject({ value: 0 });
288
+ });
289
+
290
+ it("loses no increment across 32 concurrent read-modify-write writers", async () => {
291
+ const { db } = await setup({
292
+ retry: { attempts: 200, baseDelayMs: 1, maxDelayMs: 4 },
293
+ });
294
+ const arrive = barrier(32);
295
+ let runs = 0;
296
+ await Promise.all(
297
+ Array.from({ length: 32 }, () => {
298
+ let first = true;
299
+ return db.transaction(async (tx) => {
300
+ runs += 1;
301
+ const row = (await tx.findOne("counters", { id: "c" }))!;
302
+ if (first) {
303
+ first = false;
304
+ await arrive();
305
+ }
306
+ tx.update("counters", row, { value: row.value + 1 });
307
+ });
308
+ }),
309
+ );
310
+ await expect(
311
+ db.transaction((tx) => tx.findOne("counters", { id: "c" })),
312
+ ).resolves.toMatchObject({ value: 32, _v: 32 });
313
+ expect(runs).toBeGreaterThanOrEqual(32 + 31);
314
+ });
315
+
316
+ it("counts blind reference increments from 32 writers without reruns", async () => {
317
+ const { db } = await setup();
318
+ let runs = 0;
319
+ await Promise.all(
320
+ Array.from({ length: 32 }, (_, writer) =>
321
+ db.transaction(async (tx) => {
322
+ runs += 1;
323
+ tx.create("bundles", {
324
+ id: `n${writer}`,
325
+ channel: "prod",
326
+ hash: `h-n${writer}`,
327
+ });
328
+ }),
329
+ ),
330
+ );
331
+ expect(runs).toBe(32);
332
+ await expect(
333
+ db.findOne("channels", { name: "prod" }),
334
+ ).resolves.toMatchObject({ _refs_bundles_channel: 35 });
335
+ });
336
+
337
+ it("has exactly one winner per contested key", async () => {
338
+ const { db } = await setup();
339
+ const blind = await Promise.all(
340
+ Array.from({ length: 32 }, (_, writer) =>
341
+ reasonOf(
342
+ db.transaction(async (tx) => {
343
+ tx.create("counters", { id: "k", value: writer, on_call: false });
344
+ }),
345
+ ),
346
+ ),
347
+ );
348
+ expect(blind.filter((reason) => reason === "committed")).toHaveLength(1);
349
+ expect(blind.filter((reason) => reason === "exists")).toHaveLength(31);
350
+
351
+ const arrive = barrier(32);
352
+ const won = await Promise.all(
353
+ Array.from({ length: 32 }, (_, writer) => {
354
+ let first = true;
355
+ return db.transaction(async (tx) => {
356
+ const row = await tx.findOne("counters", { id: "r" });
357
+ if (first) {
358
+ first = false;
359
+ await arrive();
360
+ }
361
+ if (row !== null) return false;
362
+ tx.create("counters", { id: "r", value: writer, on_call: false });
363
+ return true;
364
+ });
365
+ }),
366
+ );
367
+ expect(won.filter(Boolean)).toHaveLength(1);
368
+ await expect(db.findOne("counters", { id: "r" })).resolves.toMatchObject({
369
+ value: won.indexOf(true),
370
+ });
371
+ });
372
+
373
+ it("guards every row it read against write skew", async () => {
374
+ const { db } = await setup();
375
+ const arrive = barrier(2);
376
+ const leave = (me: string, other: string) => {
377
+ let first = true;
378
+ return db.transaction(async (tx) => {
379
+ const mine = (await tx.findOne("counters", { id: me }))!;
380
+ const theirs = (await tx.findOne("counters", { id: other }))!;
381
+ if (first) {
382
+ first = false;
383
+ await arrive();
384
+ }
385
+ if (theirs.on_call) tx.update("counters", mine, { on_call: false });
386
+ });
387
+ };
388
+ await Promise.all([leave("d1", "d2"), leave("d2", "d1")]);
389
+ const rows = await Promise.all(
390
+ ["d1", "d2"].map((id) => db.findOne("counters", { id })),
391
+ );
392
+ expect(rows.filter((row) => row!.on_call)).toHaveLength(1);
393
+ });
394
+
395
+ it("reruns when a row it read changes before the read repeats", async () => {
396
+ const { db, memory } = await setup();
397
+ let runs = 0;
398
+ await db.transaction(async (tx) => {
399
+ runs += 1;
400
+ const row = (await tx.findOne("counters", { id: "c" }))!;
401
+ if (runs === 1) {
402
+ await memory.write([
403
+ {
404
+ type: "increment",
405
+ table: table("counters"),
406
+ key: ["c"],
407
+ by: { value: 5 },
408
+ },
409
+ ]);
410
+ }
411
+ const again = (await tx.findOne("counters", { id: "c" }))!;
412
+ tx.update("counters", again, { value: row.value + 1 });
413
+ });
414
+ expect(runs).toBe(2);
415
+ await expect(db.findOne("counters", { id: "c" })).resolves.toMatchObject({
416
+ value: 6,
417
+ });
418
+ });
419
+
420
+ it("reports exists, unique, and not_found only for current reads", async () => {
421
+ const { db } = await setup();
422
+ await expect(
423
+ reasonOf(
424
+ db.transaction(async (tx) => {
425
+ tx.create("counters", { id: "c", value: 1, on_call: false });
426
+ }),
427
+ ),
428
+ ).resolves.toBe("exists");
429
+ await expect(
430
+ reasonOf(
431
+ db.transaction(async (tx) => {
432
+ tx.create("bundles", { id: "b9", channel: "prod", hash: "h-b0" });
433
+ }),
434
+ ),
435
+ ).resolves.toBe("unique");
436
+ await expect(
437
+ reasonOf(
438
+ db.transaction(async (tx) => {
439
+ const row = (await tx.findOne("bundles", { hash: "h-b1" }))!;
440
+ tx.update("bundles", row, { hash: "h-b0" });
441
+ }),
442
+ ),
443
+ ).resolves.toBe("unique");
444
+ await expect(
445
+ reasonOf(
446
+ db.transaction(async (tx) => {
447
+ tx.create("bundles", { id: "b9", channel: "beta", hash: "h-b9" });
448
+ }),
449
+ ),
450
+ ).resolves.toBe("not_found");
451
+ await expect(
452
+ reasonOf(
453
+ db.transaction(async (tx) => {
454
+ const channel = await tx.findOne("channels", { name: "beta" });
455
+ if (channel === null) {
456
+ tx.create("bundles", { id: "b9", channel: "beta", hash: "h-b9" });
457
+ }
458
+ }),
459
+ ),
460
+ ).resolves.toBe("not_found");
461
+ });
462
+
463
+ it("refuses a restricted delete, even when fn catches it, unless the children go first", async () => {
464
+ const { db } = await setup();
465
+ await expect(
466
+ reasonOf(
467
+ db.transaction(async (tx) => {
468
+ const channel = (await tx.findOne("channels", { name: "prod" }))!;
469
+ await tx.delete("channels", channel).catch(() => undefined);
470
+ }),
471
+ ),
472
+ ).resolves.toBe("referenced");
473
+
474
+ await db.transaction(async (tx) => {
475
+ for (const id of ["b0", "b1", "b2"]) {
476
+ await tx.delete("bundles", (await tx.findOne("bundles", { id }))!);
477
+ }
478
+ await tx.delete(
479
+ "channels",
480
+ (await tx.findOne("channels", { name: "prod" }))!,
481
+ );
482
+ });
483
+ await expect(db.findOne("channels", { name: "prod" })).resolves.toBeNull();
484
+ await expect(db.findOne("patches", { id: "p1" })).resolves.toBeNull();
485
+ });
486
+
487
+ it("reruns a restricted delete whose read of the counter went stale", async () => {
488
+ const { db, memory } = await setup();
489
+ await db.transaction(async (tx) => {
490
+ tx.create("channels", { name: "beta" });
491
+ tx.create("bundles", { id: "bx", channel: "beta", hash: "h-bx" });
492
+ });
493
+ const [bx] = (await memory.get(table("bundles"), [["bx"]])) as [StoredRow];
494
+ let runs = 0;
495
+ await db.transaction(async (tx) => {
496
+ runs += 1;
497
+ const channel = (await tx.findOne("channels", { name: "beta" }))!;
498
+ if (runs === 1) {
499
+ await memory.write([
500
+ {
501
+ type: "delete",
502
+ table: table("bundles"),
503
+ key: ["bx"],
504
+ guard: { v: Number(bx._v) },
505
+ previous: bx,
506
+ },
507
+ {
508
+ type: "increment",
509
+ table: table("channels"),
510
+ key: ["beta"],
511
+ by: { _refs_bundles_channel: -1 },
512
+ },
513
+ ]);
514
+ }
515
+ await tx.delete("channels", channel);
516
+ });
517
+ expect(runs).toBe(2);
518
+ await expect(db.findOne("channels", { name: "beta" })).resolves.toBeNull();
519
+ });
520
+
521
+ it("cascades children first and moves every other parent's counter", async () => {
522
+ const { db, writes } = await setup();
523
+ await db.transaction(async (tx) => {
524
+ await tx.delete("bundles", (await tx.findOne("bundles", { id: "b1" }))!);
525
+ });
526
+ expect(
527
+ writes[0]!.map(
528
+ (op) =>
529
+ `${op.type} ${op.table.name} ${op.type === "insert" ? "" : op.key.join()}`,
530
+ ),
531
+ ).toEqual([
532
+ "increment channels prod",
533
+ "increment bundles b0",
534
+ "increment bundles b2",
535
+ "delete patches p1",
536
+ "delete patches p2",
537
+ "delete bundles b1",
538
+ ]);
539
+ for (const id of ["p1", "p2"]) {
540
+ await expect(db.findOne("patches", { id })).resolves.toBeNull();
541
+ }
542
+ await expect(db.findOne("bundles", { id: "b0" })).resolves.toMatchObject({
543
+ _refs_patches_base_bundle_id: 0,
544
+ });
545
+ await expect(db.findOne("bundles", { id: "b2" })).resolves.toMatchObject({
546
+ _refs_patches_bundle_id: 0,
547
+ });
548
+ await expect(
549
+ db.findOne("channels", { name: "prod" }),
550
+ ).resolves.toMatchObject({ _refs_bundles_channel: 2 });
551
+ });
552
+
553
+ it("carries counters from earlier writes into a later insert", async () => {
554
+ const { db, writes } = await setup();
555
+ await db.transaction(async (tx) => {
556
+ tx.create("patches", { id: "p9", bundle_id: "b9", base_bundle_id: "b0" });
557
+ tx.create("bundles", { id: "b9", channel: "prod", hash: "h-b9" });
558
+ });
559
+ expect(
560
+ writes[0]!.map(({ type, table }) => `${type} ${table.name}`),
561
+ ).toEqual([
562
+ "insert patches",
563
+ "insert bundles",
564
+ "increment bundles",
565
+ "increment channels",
566
+ ]);
567
+ await expect(db.findOne("bundles", { id: "b9" })).resolves.toMatchObject({
568
+ _refs_patches_bundle_id: 1,
569
+ note: null,
570
+ });
571
+ });
572
+
573
+ it("guards a rooted range through its parent and refuses unrooted ranges", async () => {
574
+ const { db } = await setup();
575
+ let entered!: () => void;
576
+ const inside = new Promise<void>((resolve) => {
577
+ entered = resolve;
578
+ });
579
+ let proceed!: () => void;
580
+ const gate = new Promise<void>((resolve) => {
581
+ proceed = resolve;
582
+ });
583
+ let runs = 0;
584
+ const first = db.transaction(async (tx) => {
585
+ runs += 1;
586
+ const page = await tx.findMany("releases", {
587
+ index: "byCatalog",
588
+ where: { catalog_id: "c1" },
589
+ limit: 10,
590
+ });
591
+ if (runs === 1) {
592
+ entered();
593
+ await gate;
594
+ }
595
+ tx.create("releases", { catalog_id: "c1", id: `r${page.rows.length}` });
596
+ return page.rows.length;
597
+ });
598
+ await inside;
599
+ await db.transaction(async (tx) => {
600
+ tx.create("releases", { catalog_id: "c1", id: "rx" });
601
+ });
602
+ proceed();
603
+ await expect(first).resolves.toBe(1);
604
+ expect(runs).toBe(2);
605
+
606
+ await expect(
607
+ db.transaction((tx) =>
608
+ tx.findMany("releases", {
609
+ // @ts-expect-error all is not rooted.
610
+ index: "all",
611
+ where: { catalog_id: "c1" },
612
+ limit: 1,
613
+ }),
614
+ ),
615
+ ).rejects.toThrow(DatabaseQueryError);
616
+ });
617
+
618
+ it("writes rows found through a rooted range, guarded by the root rather than a check per row", async () => {
619
+ const { db, writes } = await setup();
620
+ await db.transaction(async (tx) => {
621
+ tx.create("releases", { catalog_id: "c1", id: "r1" });
622
+ tx.create("releases", { catalog_id: "c1", id: "r2" });
623
+ });
624
+ writes.length = 0;
625
+ await db.transaction(async (tx) => {
626
+ const { rows } = await tx.findMany("releases", {
627
+ index: "byCatalog",
628
+ where: { catalog_id: "c1" },
629
+ limit: 10,
630
+ });
631
+ await tx.delete("releases", rows[0]!);
632
+ });
633
+ expect(
634
+ writes[0]!.map((op) => [
635
+ op.type,
636
+ op.table.name,
637
+ op.type === "insert" ? op.row.id : op.key,
638
+ ]),
639
+ ).toEqual([
640
+ ["increment", "catalogs", ["c1"]],
641
+ ["delete", "releases", ["c1", "r1"]],
642
+ ]);
643
+ });
644
+
645
+ it("rejects writes over the adapter's atomic limit before sending them", async () => {
646
+ const { db, writes } = await setup({ maxOps: 3, seed: false });
647
+ await expect(
648
+ reasonOf(
649
+ db.transaction(async (tx) => {
650
+ for (const id of ["x1", "x2", "x3", "x4"]) {
651
+ tx.create("counters", { id, value: 0, on_call: false });
652
+ }
653
+ }),
654
+ ),
655
+ ).resolves.toBe("too_large");
656
+ expect(writes).toEqual([]);
657
+ });
658
+
659
+ it("keeps db, nested transactions, and a finished handle out of fn", async () => {
660
+ const { db } = await setup();
661
+ await expect(
662
+ db.transaction(async () => db.findOne("counters", { id: "c" })),
663
+ ).rejects.toThrow(DatabaseTransactionError);
664
+ await expect(
665
+ db.transaction(async () => db.transaction(async () => 1)),
666
+ ).rejects.toThrow(DatabaseTransactionError);
667
+ let saved: Tx | undefined;
668
+ await db.transaction(async (tx) => {
669
+ saved = tx;
670
+ });
671
+ expect(() =>
672
+ saved!.create("counters", { id: "z", value: 0, on_call: false }),
673
+ ).toThrow("The transaction has ended.");
674
+ });
675
+
676
+ it("writes only rows it read, never keys, unknown fields, or missing required fields", async () => {
677
+ const { db } = await setup();
678
+ const row = (await db.findOne("counters", { id: "c" }))!;
679
+ await expect(
680
+ db.transaction(async (tx) => {
681
+ // @ts-expect-error A row read outside the transaction has no `_v` to guard.
682
+ tx.update("counters", row, { value: 1 });
683
+ }),
684
+ ).rejects.toThrow("take a row this transaction read");
685
+ await expect(
686
+ db.transaction(async (tx) => {
687
+ const read = (await tx.findOne("counters", { id: "c" }))!;
688
+ // @ts-expect-error Key fields cannot change.
689
+ tx.update("counters", read, { id: "moved" });
690
+ }),
691
+ ).rejects.toThrow("id cannot be changed");
692
+ await expect(
693
+ db.transaction(async (tx) => {
694
+ // @ts-expect-error value is required.
695
+ tx.create("counters", { id: "n", on_call: false });
696
+ }),
697
+ ).rejects.toThrow("value is required");
698
+ await expect(
699
+ db.transaction(async (tx) => {
700
+ tx.create("counters", {
701
+ id: "n",
702
+ value: 0,
703
+ on_call: false,
704
+ // @ts-expect-error extra is not a field.
705
+ extra: 1,
706
+ });
707
+ }),
708
+ ).rejects.toThrow("extra cannot be set");
709
+ });
710
+ });