@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,402 @@
1
+ import { DatabaseAmbiguousCommitError, DatabaseConflictError, DatabaseConstraintError, DatabaseTransactionError } from "./errors.mjs";
2
+ import { DatabaseQueryError } from "./engineReads.mjs";
3
+ import { NegativeGaugeError, compileAggregates, recordAggregate } from "./engineAggregates.mjs";
4
+ import { DATABASE_VERSION_COLUMN, canonicalJson, compareTuples, indexEntries, rowKey } from "@hot-updater/plugin-core/internal";
5
+ //#region src/database/engineTransaction.ts
6
+ /** A row this attempt read changed while it ran; the attempt reruns. */
7
+ var StaleReadError = class extends Error {};
8
+ const idOf = (table, key) => JSON.stringify([table, key]);
9
+ const versionOf = (row) => Number(row[DATABASE_VERSION_COLUMN]);
10
+ const isKeyed = (value) => value !== null && value !== void 0;
11
+ const misuse = (table, message) => new DatabaseTransactionError(`${table}: ${message}`);
12
+ const once = (table) => misuse(table, "a transaction writes one key once.");
13
+ const hooks = globalThis.process?.getBuiltinModule?.("node:async_hooks");
14
+ /** Where the runtime tracks async context, `db.*` inside a transaction throws. */
15
+ const transactionScope = hooks && new hooks.AsyncLocalStorage();
16
+ const assertOutsideTransaction = () => {
17
+ if (transactionScope?.getStore() !== void 0) throw new DatabaseTransactionError("Inside transaction(), read and write through its handle; db and core are not part of it.");
18
+ };
19
+ const createTransactions = ({ adapter, schema, reads, retry = {} }) => {
20
+ const { attempts = 8, baseDelayMs = 5, maxDelayMs = 250, onRetry } = retry;
21
+ const modelOf = (name, kind = "table") => {
22
+ const model = schema.models.get(name);
23
+ if (model?.definition.kind !== kind) throw new DatabaseQueryError(`Unknown ${kind} ${name}.`);
24
+ return model;
25
+ };
26
+ /**
27
+ * A key-value index copy has no `_v`. A transaction guards what it reads,
28
+ * so it reads such a row whole, and reruns if it changed since the copy.
29
+ */
30
+ const complete = async ({ table }, rows) => {
31
+ const copies = rows.filter((row) => !(DATABASE_VERSION_COLUMN in row));
32
+ if (copies.length === 0) return [...rows];
33
+ const current = await adapter.get(table, copies.map((copy) => rowKey(table, copy)));
34
+ return rows.map((row) => {
35
+ const at = copies.indexOf(row);
36
+ if (at < 0) return row;
37
+ const whole = current[at];
38
+ if (!whole || Object.keys(row).some((column) => canonicalJson(row[column]) !== canonicalJson(whole[column]))) throw new StaleReadError();
39
+ return whole;
40
+ });
41
+ };
42
+ const attempt = async (fn) => {
43
+ const read = /* @__PURE__ */ new Map();
44
+ /** Rows of rooted ranges: their root guards them, so they need no check of their own. */
45
+ const ranged = /* @__PURE__ */ new Map();
46
+ const writes = /* @__PURE__ */ new Map();
47
+ /** Deleted keys, children before their parents. */
48
+ const deleted = [];
49
+ const aggregates = /* @__PURE__ */ new Map();
50
+ let open = true;
51
+ let failure;
52
+ /** A failed call fails the attempt even when `fn` catches it. */
53
+ const step = (method) => (...args) => {
54
+ if (!open) throw new DatabaseTransactionError("The transaction has ended.");
55
+ const fail = (error) => {
56
+ failure ??= { error };
57
+ throw error;
58
+ };
59
+ try {
60
+ const result = method(...args);
61
+ return result instanceof Promise ? result.catch(fail) : result;
62
+ } catch (error) {
63
+ return fail(error);
64
+ }
65
+ };
66
+ const remember = (model, key, row) => {
67
+ const id = idOf(model.table.name, key);
68
+ const known = read.get(id);
69
+ if (known !== void 0 && (known && row ? versionOf(known) !== versionOf(row) : known !== row)) throw new StaleReadError();
70
+ read.set(id, row);
71
+ return row;
72
+ };
73
+ const readRow = ({ table }, row) => {
74
+ const id = idOf(table.name, rowKey(table, row));
75
+ const known = read.get(id) ?? ranged.get(id);
76
+ if (known && versionOf(known) === versionOf(row)) return known;
77
+ throw misuse(table.name, "update and delete take a row this transaction read.");
78
+ };
79
+ const checkFields = ({ table, definition: { fields } }, values, creating) => {
80
+ for (const field of Object.keys(values)) if (!(field in fields) || !creating && table.key.includes(field)) throw misuse(table.name, `${field} cannot be ${creating ? "set" : "changed"}.`);
81
+ for (const [field, { required }] of Object.entries(fields)) if (required !== false && (creating || field in values) && !isKeyed(values[field])) throw misuse(table.name, `${field} is required.`);
82
+ };
83
+ /** Adds counter deltas to a key's pending op; an empty `by` still bumps `_v`. */
84
+ const bump = (model, key, by) => {
85
+ const id = idOf(model.table.name, key);
86
+ const pending = writes.get(id);
87
+ if (pending === void 0) writes.set(id, {
88
+ model,
89
+ key,
90
+ type: "increment",
91
+ row: { ...by }
92
+ });
93
+ else if (pending.type !== "delete") for (const [column, delta] of Object.entries(by)) pending.row[column] = Number(pending.row[column] ?? pending.read?.[column] ?? 0) + delta;
94
+ else if (Object.values(by).some((delta) => delta > 0)) throw new DatabaseConstraintError("not_found", model.table.name);
95
+ };
96
+ /** Moves parent counters when a reference changes and bumps every rooted parent. */
97
+ const touchParents = (model, before, after) => {
98
+ for (const { field, counter, target } of model.references) {
99
+ const [from, to] = [before?.[field], after?.[field]];
100
+ if (counter === void 0 || from === to) continue;
101
+ if (isKeyed(from)) bump(modelOf(target), [from], { [counter]: -1 });
102
+ if (isKeyed(to)) bump(modelOf(target), [to], { [counter]: 1 });
103
+ }
104
+ for (const [index, root] of model.roots) {
105
+ const parent = modelOf(root);
106
+ const { eq } = model.table.indexes.find(({ name }) => name === index);
107
+ for (const row of [before, after]) {
108
+ const key = eq.slice(0, parent.table.key.length).map((field) => row?.[field]);
109
+ if (row && key.every(isKeyed)) bump(parent, key, {});
110
+ }
111
+ }
112
+ };
113
+ const derive = ({ definition }, row) => {
114
+ if (definition.kind === "table") for (const [name, derived] of Object.entries(definition.derived)) row[name] = derived.compute(row);
115
+ return row;
116
+ };
117
+ /** Deletes a row after its cascaded children, or refuses a restricted delete. */
118
+ const remove = async (model, known) => {
119
+ const { table } = model;
120
+ const key = rowKey(table, known);
121
+ const id = idOf(table.name, key);
122
+ const pending = writes.get(id);
123
+ if (pending?.type === "delete") return;
124
+ if (pending && pending.type !== "increment") throw once(table.name);
125
+ writes.set(id, {
126
+ model,
127
+ key,
128
+ type: "delete",
129
+ row: {},
130
+ read: known
131
+ });
132
+ touchParents(model, known, null);
133
+ for (const reference of model.referencedBy) {
134
+ const { counter, field, onDelete, table: name } = reference;
135
+ if (counter === void 0) continue;
136
+ const stored = Number(known[counter] ?? 0);
137
+ const added = Number(pending?.row[counter] ?? 0);
138
+ if (added > 0) throw new DatabaseConstraintError("referenced", table.name);
139
+ if (stored + added <= 0) continue;
140
+ if (onDelete === "restrict") {
141
+ const [current] = await adapter.get(table, [key]);
142
+ if (current && versionOf(current) === versionOf(known)) throw new DatabaseConstraintError("referenced", table.name);
143
+ throw new StaleReadError();
144
+ }
145
+ const child = modelOf(name);
146
+ const index = child.table.indexes.find(({ eq }) => eq.length === 1 && eq[0] === field);
147
+ let cursor;
148
+ let seen = 0;
149
+ do {
150
+ const page = await reads.findMany(name, {
151
+ index: index.name,
152
+ where: { [field]: key[0] },
153
+ limit: Math.min(stored - seen, reads.maxPageSize),
154
+ ...cursor === void 0 ? {} : { cursor }
155
+ });
156
+ for (const row of await complete(child, page.rows)) {
157
+ remember(child, rowKey(child.table, row), row);
158
+ await remove(child, row);
159
+ }
160
+ seen += page.rows.length;
161
+ cursor = page.next;
162
+ } while (cursor !== void 0 && seen < stored);
163
+ }
164
+ deleted.push(id);
165
+ };
166
+ const tx = {
167
+ findOne: step(async (name, lookup) => {
168
+ const model = modelOf(name);
169
+ const { table } = model;
170
+ const found = await reads.findOne(name, lookup);
171
+ if (found === null && !table.key.every((field) => field in lookup)) return null;
172
+ const [row = null] = found ? await complete(model, [found]) : [];
173
+ const key = row ? rowKey(table, row) : table.key.map((field) => lookup[field]);
174
+ return remember(model, key, row);
175
+ }),
176
+ findMany: step(async (name, input) => {
177
+ const model = modelOf(name);
178
+ const root = model.roots.get(input.index);
179
+ if (root === void 0) throw new DatabaseQueryError(`${name}.${input.index} is not rooted; a transaction reads a range only under a guarded parent.`);
180
+ const parent = modelOf(root);
181
+ const { eq } = model.table.indexes.find(({ name: index }) => index === input.index);
182
+ const where = input.where ?? {};
183
+ const lookup = Object.fromEntries(parent.table.key.map((field, at) => [field, where[eq[at]]]));
184
+ remember(parent, Object.values(lookup), await reads.findOne(root, lookup));
185
+ const found = await reads.findMany(name, input);
186
+ const rows = await complete(model, found.rows);
187
+ for (const row of rows) ranged.set(idOf(name, rowKey(model.table, row)), row);
188
+ return {
189
+ ...found,
190
+ rows
191
+ };
192
+ }),
193
+ create: step((name, values) => {
194
+ const model = modelOf(name);
195
+ checkFields(model, values, true);
196
+ const defaults = model.table.columns.flatMap((column) => column.nullable || column.default !== void 0 ? [[column.name, column.default ?? null]] : []);
197
+ const row = derive(model, {
198
+ ...Object.fromEntries(defaults),
199
+ ...values
200
+ });
201
+ const key = rowKey(model.table, row);
202
+ const id = idOf(name, key);
203
+ const pending = writes.get(id);
204
+ if (pending && pending.type !== "increment") throw once(name);
205
+ for (const [column, delta] of Object.entries(pending?.row ?? {})) row[column] = Number(row[column]) + Number(delta);
206
+ writes.set(id, {
207
+ model,
208
+ key,
209
+ type: "insert",
210
+ row
211
+ });
212
+ touchParents(model, null, row);
213
+ }),
214
+ update: step((name, row, set) => {
215
+ const model = modelOf(name);
216
+ const known = readRow(model, row);
217
+ checkFields(model, set, false);
218
+ const key = rowKey(model.table, known);
219
+ const id = idOf(name, key);
220
+ const pending = writes.get(id);
221
+ if (pending?.type === "insert" || pending?.type === "delete") throw once(name);
222
+ const before = pending?.type === "patch" ? {
223
+ ...known,
224
+ ...pending.row
225
+ } : known;
226
+ const next = derive(model, {
227
+ ...before,
228
+ ...set
229
+ });
230
+ const changed = Object.entries(next).filter(([column, value]) => column !== DATABASE_VERSION_COLUMN && JSON.stringify(value) !== JSON.stringify(known[column]));
231
+ const patch = Object.fromEntries(changed);
232
+ writes.set(id, {
233
+ model,
234
+ key,
235
+ type: "patch",
236
+ row: patch,
237
+ read: known
238
+ });
239
+ if (pending?.type === "increment") bump(model, key, pending.row);
240
+ touchParents(model, before, next);
241
+ }),
242
+ delete: step(async (name, row) => {
243
+ const model = modelOf(name);
244
+ await remove(model, readRow(model, row));
245
+ }),
246
+ aggregate: step((name, identity, values, options) => {
247
+ const model = modelOf(name, "aggregate");
248
+ recordAggregate(aggregates, model, identity, values, options?.shardBy);
249
+ })
250
+ };
251
+ try {
252
+ const result = await (transactionScope ? transactionScope.run(tx, () => fn(tx)) : fn(tx));
253
+ if (failure) throw failure.error;
254
+ return {
255
+ result,
256
+ read,
257
+ ops: compile(writes, read, deleted),
258
+ aggregates: [...aggregates.values()]
259
+ };
260
+ } catch (error) {
261
+ throw failure?.error instanceof StaleReadError ? failure.error : error;
262
+ } finally {
263
+ open = false;
264
+ }
265
+ };
266
+ /** Inserts first, then patches and increments, then checks, then deletes, children before parents. */
267
+ const compile = (writes, read, deleted) => {
268
+ const toOp = (id) => {
269
+ const { model, key, type, row, read: previous } = writes.get(id);
270
+ const { table } = model;
271
+ if (type === "insert") return {
272
+ type,
273
+ table,
274
+ row
275
+ };
276
+ if (type === "increment") {
277
+ const known = read.get(id);
278
+ const by = row;
279
+ return known ? {
280
+ type,
281
+ table,
282
+ key,
283
+ by,
284
+ guard: { v: versionOf(known) }
285
+ } : {
286
+ type,
287
+ table,
288
+ key,
289
+ by
290
+ };
291
+ }
292
+ const guard = { v: versionOf(previous) };
293
+ return type === "patch" ? {
294
+ type,
295
+ table,
296
+ key,
297
+ set: row,
298
+ guard,
299
+ previous
300
+ } : {
301
+ type,
302
+ table,
303
+ key,
304
+ guard,
305
+ previous
306
+ };
307
+ };
308
+ const checks = [...read].flatMap(([id, row]) => {
309
+ if (row === null || writes.has(id)) return [];
310
+ const { table } = schema.models.get(JSON.parse(id)[0]);
311
+ const guard = { v: versionOf(row) };
312
+ return [{
313
+ type: "check",
314
+ table,
315
+ key: rowKey(table, row),
316
+ guard
317
+ }];
318
+ });
319
+ const ofType = (...types) => [...writes.keys()].filter((id) => types.includes(writes.get(id).type));
320
+ return [
321
+ ...[...ofType("insert"), ...ofType("patch", "increment")].map(toOp),
322
+ ...checks,
323
+ ...deleted.map(toOp)
324
+ ];
325
+ };
326
+ /** Only a constraint the current state confirms is reported; anything else reruns. */
327
+ const classify = async (op, read) => {
328
+ if (op.type === "check" || op.type === "delete") return void 0;
329
+ if (op.type === "increment" && op.guard) return void 0;
330
+ const { table } = op;
331
+ const key = op.type === "insert" ? rowKey(table, op.row) : op.key;
332
+ const [current] = await adapter.get(table, [key]);
333
+ if (op.type === "increment") return current ? void 0 : "not_found";
334
+ if (op.type === "insert" && current) {
335
+ const known = read.get(idOf(table.name, key));
336
+ return known === null || known !== void 0 && versionOf(known) !== versionOf(current) ? void 0 : "exists";
337
+ }
338
+ if (op.type === "patch" && current?.[DATABASE_VERSION_COLUMN] !== op.guard.v) return;
339
+ const row = op.type === "insert" ? op.row : {
340
+ ...current,
341
+ ...op.set
342
+ };
343
+ for (const index of table.indexes) {
344
+ if (!index.unique) continue;
345
+ for (const eq of indexEntries(table, index, row)) if ((await adapter.query(table, {
346
+ index: index.name,
347
+ eq,
348
+ order: "asc",
349
+ limit: 2
350
+ })).some((other) => compareTuples(rowKey(table, other), key))) return "unique";
351
+ }
352
+ };
353
+ return { async transaction(fn) {
354
+ assertOutsideTransaction();
355
+ let run;
356
+ let negative;
357
+ for (let round = 0; round < attempts; round += 1) {
358
+ const delay = round && Math.min(maxDelayMs, baseDelayMs * 2 ** (round - 1));
359
+ if (delay > 0) await new Promise((resolve) => setTimeout(resolve, delay / 2 + Math.random() * (delay / 2)));
360
+ run ??= await attempt(fn).catch((error) => {
361
+ if (error instanceof StaleReadError) return void 0;
362
+ throw error;
363
+ });
364
+ if (run === void 0) {
365
+ onRetry?.("rerun", round + 1);
366
+ continue;
367
+ }
368
+ let aggregates;
369
+ try {
370
+ aggregates = await compileAggregates(adapter, run.aggregates);
371
+ } catch (error) {
372
+ if (!(error instanceof NegativeGaugeError)) throw error;
373
+ negative = error;
374
+ onRetry?.("rerun", round + 1);
375
+ run = void 0;
376
+ continue;
377
+ }
378
+ const ops = [...run.ops, ...aggregates];
379
+ if (ops.length <= 1 && ops.every(({ type }) => type === "check")) return run.result;
380
+ if (!adapter.fits(ops)) throw new DatabaseConstraintError("too_large", ops[0].table.name);
381
+ let outcome;
382
+ try {
383
+ outcome = await adapter.write(ops);
384
+ } catch (cause) {
385
+ throw new DatabaseAmbiguousCommitError("The commit outcome is unknown.", { cause });
386
+ }
387
+ if (outcome.ok) return run.result;
388
+ const failed = "failedOp" in outcome ? outcome.failedOp : void 0;
389
+ if (failed === void 0 || failed >= run.ops.length) {
390
+ onRetry?.("resend", round + 1);
391
+ continue;
392
+ }
393
+ const reason = await classify(ops[failed], run.read);
394
+ if (reason) throw new DatabaseConstraintError(reason, ops[failed].table.name);
395
+ onRetry?.("rerun", round + 1);
396
+ run = void 0;
397
+ }
398
+ throw negative ?? new DatabaseConflictError(`The transaction conflicted ${attempts} times.`);
399
+ } };
400
+ };
401
+ //#endregion
402
+ export { assertOutsideTransaction, createTransactions };
@@ -0,0 +1,27 @@
1
+ //#region src/database/errors.ts
2
+ var DatabaseConstraintError = class extends Error {
3
+ reason;
4
+ model;
5
+ name = "DatabaseConstraintError";
6
+ constructor(reason, model) {
7
+ super(`${model}: ${reason}`);
8
+ this.reason = reason;
9
+ this.model = model;
10
+ }
11
+ };
12
+ /** The retry budget ran out; ingestion answers 503 with Retry-After. */
13
+ var DatabaseConflictError = class extends Error {
14
+ name = "DatabaseConflictError";
15
+ };
16
+ /** The write may or may not have committed; it is reported, never rerun. */
17
+ var DatabaseAmbiguousCommitError = class extends Error {
18
+ name = "DatabaseAmbiguousCommitError";
19
+ };
20
+ var DatabaseTransactionError = class extends Error {
21
+ name = "DatabaseTransactionError";
22
+ };
23
+ //#endregion
24
+ exports.DatabaseAmbiguousCommitError = DatabaseAmbiguousCommitError;
25
+ exports.DatabaseConflictError = DatabaseConflictError;
26
+ exports.DatabaseConstraintError = DatabaseConstraintError;
27
+ exports.DatabaseTransactionError = DatabaseTransactionError;
@@ -0,0 +1,21 @@
1
+ //#region src/database/errors.d.ts
2
+ type ConstraintReason = "exists" | "unique" | "not_found" | "referenced" | "too_large";
3
+ declare class DatabaseConstraintError extends Error {
4
+ readonly reason: ConstraintReason;
5
+ readonly model: string;
6
+ readonly name = "DatabaseConstraintError";
7
+ constructor(reason: ConstraintReason, model: string);
8
+ }
9
+ /** The retry budget ran out; ingestion answers 503 with Retry-After. */
10
+ declare class DatabaseConflictError extends Error {
11
+ readonly name = "DatabaseConflictError";
12
+ }
13
+ /** The write may or may not have committed; it is reported, never rerun. */
14
+ declare class DatabaseAmbiguousCommitError extends Error {
15
+ readonly name = "DatabaseAmbiguousCommitError";
16
+ }
17
+ declare class DatabaseTransactionError extends Error {
18
+ readonly name = "DatabaseTransactionError";
19
+ }
20
+ //#endregion
21
+ export { ConstraintReason, DatabaseAmbiguousCommitError, DatabaseConflictError, DatabaseConstraintError, DatabaseTransactionError };
@@ -0,0 +1,21 @@
1
+ //#region src/database/errors.d.ts
2
+ type ConstraintReason = "exists" | "unique" | "not_found" | "referenced" | "too_large";
3
+ declare class DatabaseConstraintError extends Error {
4
+ readonly reason: ConstraintReason;
5
+ readonly model: string;
6
+ readonly name = "DatabaseConstraintError";
7
+ constructor(reason: ConstraintReason, model: string);
8
+ }
9
+ /** The retry budget ran out; ingestion answers 503 with Retry-After. */
10
+ declare class DatabaseConflictError extends Error {
11
+ readonly name = "DatabaseConflictError";
12
+ }
13
+ /** The write may or may not have committed; it is reported, never rerun. */
14
+ declare class DatabaseAmbiguousCommitError extends Error {
15
+ readonly name = "DatabaseAmbiguousCommitError";
16
+ }
17
+ declare class DatabaseTransactionError extends Error {
18
+ readonly name = "DatabaseTransactionError";
19
+ }
20
+ //#endregion
21
+ export { ConstraintReason, DatabaseAmbiguousCommitError, DatabaseConflictError, DatabaseConstraintError, DatabaseTransactionError };
@@ -0,0 +1,24 @@
1
+ //#region src/database/errors.ts
2
+ var DatabaseConstraintError = class extends Error {
3
+ reason;
4
+ model;
5
+ name = "DatabaseConstraintError";
6
+ constructor(reason, model) {
7
+ super(`${model}: ${reason}`);
8
+ this.reason = reason;
9
+ this.model = model;
10
+ }
11
+ };
12
+ /** The retry budget ran out; ingestion answers 503 with Retry-After. */
13
+ var DatabaseConflictError = class extends Error {
14
+ name = "DatabaseConflictError";
15
+ };
16
+ /** The write may or may not have committed; it is reported, never rerun. */
17
+ var DatabaseAmbiguousCommitError = class extends Error {
18
+ name = "DatabaseAmbiguousCommitError";
19
+ };
20
+ var DatabaseTransactionError = class extends Error {
21
+ name = "DatabaseTransactionError";
22
+ };
23
+ //#endregion
24
+ export { DatabaseAmbiguousCommitError, DatabaseConflictError, DatabaseConstraintError, DatabaseTransactionError };
@@ -0,0 +1,124 @@
1
+ //#region src/database/fence.ts
2
+ /** The settings rows migrations write, last, and the fence reads. */
3
+ const SETTINGS_TABLE = {
4
+ name: "private_hot_updater_settings",
5
+ columns: [
6
+ {
7
+ name: "key",
8
+ type: "string",
9
+ nullable: false,
10
+ maxLength: 255
11
+ },
12
+ {
13
+ name: "value",
14
+ type: "string",
15
+ nullable: false,
16
+ maxLength: 255
17
+ },
18
+ {
19
+ name: "_v",
20
+ type: "integer",
21
+ nullable: false,
22
+ default: 0
23
+ }
24
+ ],
25
+ key: ["key"],
26
+ indexes: []
27
+ };
28
+ /** The engine's storage-layout generation; it changes only with a migration. */
29
+ const ENGINE_SCHEMA_KEY = "schema.engine";
30
+ const ENGINE_SCHEMA_VERSION = "1";
31
+ const settingMessage = (adapterName, { key, expected, found }) => `Hot Updater schema setting "${key}" for ${adapterName} is ${found === null ? "missing" : `"${found}"`}; expected "${expected}". ${key === "schema.engine" ? "Create a new empty database and run `hot-updater db migrate`; databases from before the storage engine are not converted." : "Run `hot-updater db migrate`."}`;
32
+ /** The database needs `hot-updater db migrate`, or a new database; the handler answers 503. */
33
+ var HotUpdaterSchemaMigrationRequiredError = class extends Error {
34
+ adapterName;
35
+ currentVersion;
36
+ setting;
37
+ constructor(adapterName, currentVersion, setting, options) {
38
+ super(setting !== void 0 ? settingMessage(adapterName, setting) : currentVersion === void 0 ? `Hot Updater database schema is not initialized for ${adapterName}. Run \`hot-updater db migrate\` before using this adapter.` : `Hot Updater v1 cannot migrate schema ${currentVersion} in place. Create a new empty database and run \`hot-updater db migrate\`.`, options);
39
+ this.adapterName = adapterName;
40
+ this.currentVersion = currentVersion;
41
+ this.setting = setting;
42
+ this.name = "HotUpdaterSchemaMigrationRequiredError";
43
+ }
44
+ };
45
+ /** Driver codes for a table or column the database lacks. */
46
+ const MISSING_SCHEMA_CODES = /* @__PURE__ */ new Set([
47
+ "42P01",
48
+ "42703",
49
+ "ER_NO_SUCH_TABLE",
50
+ "ER_BAD_FIELD_ERROR"
51
+ ]);
52
+ const MISSING_SCHEMA_MESSAGE = /no such (?:table|column)|(?:relation|column) .+ does not exist|table .+ doesn't exist|unknown column/iu;
53
+ /**
54
+ * Whether a read failed because a table or column is missing, so the
55
+ * database needs migrations. ORMs may wrap the driver's error in `cause`.
56
+ */
57
+ const isMissingSchemaError = (error) => {
58
+ for (let depth = 0; error instanceof Object && depth < 8; depth += 1) {
59
+ const { code, message, cause } = error;
60
+ if (MISSING_SCHEMA_CODES.has(String(code)) || typeof message === "string" && MISSING_SCHEMA_MESSAGE.test(message)) return true;
61
+ error = cause;
62
+ }
63
+ return false;
64
+ };
65
+ const readSettings = (adapter, keys) => adapter.get(SETTINGS_TABLE, keys.map((key) => [key]));
66
+ /** Throws unless every expected setting is stored with its value: one batch read. */
67
+ const checkSchemaFence = async (adapter, adapterName, expected) => {
68
+ const keys = Object.keys(expected);
69
+ let rows;
70
+ try {
71
+ rows = await readSettings(adapter, keys);
72
+ } catch (cause) {
73
+ if (!isMissingSchemaError(cause)) throw cause;
74
+ throw new HotUpdaterSchemaMigrationRequiredError(adapterName, void 0, {
75
+ key: ENGINE_SCHEMA_KEY,
76
+ expected: "1",
77
+ found: null
78
+ }, { cause });
79
+ }
80
+ keys.forEach((key, position) => {
81
+ const found = rows[position]?.value;
82
+ if (found !== expected[key]) throw new HotUpdaterSchemaMigrationRequiredError(adapterName, void 0, {
83
+ key,
84
+ expected: expected[key],
85
+ found: typeof found === "string" ? found : null
86
+ });
87
+ });
88
+ };
89
+ /** The database name a fenced adapter carries, so a server can fence its plugins' rows too. */
90
+ const FENCED = Symbol.for("@hot-updater/server/schema-fence");
91
+ /** The database name an adapter behind the schema fence reports under. */
92
+ const fencedName = (adapter) => adapter[FENCED];
93
+ /**
94
+ * The adapter behind the schema fence: a process's first read or write
95
+ * checks the settings first. Success is kept; a failure is checked again on
96
+ * the next call.
97
+ */
98
+ const withSchemaFence = (adapter, adapterName, expected) => {
99
+ let ready;
100
+ const fence = () => {
101
+ ready ??= checkSchemaFence(adapter, adapterName, expected).catch((error) => {
102
+ ready = void 0;
103
+ throw error;
104
+ });
105
+ return ready;
106
+ };
107
+ return {
108
+ ...adapter,
109
+ [FENCED]: adapterName,
110
+ get: (table, keys) => fence().then(() => adapter.get(table, keys)),
111
+ query: (table, request) => fence().then(() => adapter.query(table, request)),
112
+ write: (ops) => fence().then(() => adapter.write(ops))
113
+ };
114
+ };
115
+ //#endregion
116
+ exports.ENGINE_SCHEMA_KEY = ENGINE_SCHEMA_KEY;
117
+ exports.ENGINE_SCHEMA_VERSION = ENGINE_SCHEMA_VERSION;
118
+ exports.HotUpdaterSchemaMigrationRequiredError = HotUpdaterSchemaMigrationRequiredError;
119
+ exports.SETTINGS_TABLE = SETTINGS_TABLE;
120
+ exports.checkSchemaFence = checkSchemaFence;
121
+ exports.fencedName = fencedName;
122
+ exports.isMissingSchemaError = isMissingSchemaError;
123
+ exports.readSettings = readSettings;
124
+ exports.withSchemaFence = withSchemaFence;
@@ -0,0 +1,42 @@
1
+ import { DatabaseAdapter, PhysicalTable, StoredRow } from "@hot-updater/plugin-core/internal";
2
+ //#region src/database/fence.d.ts
3
+ /** The settings rows migrations write, last, and the fence reads. */
4
+ declare const SETTINGS_TABLE: PhysicalTable;
5
+ /** The engine's storage-layout generation; it changes only with a migration. */
6
+ declare const ENGINE_SCHEMA_KEY = "schema.engine";
7
+ declare const ENGINE_SCHEMA_VERSION = "1";
8
+ /** A schema setting the fence found missing or different. */
9
+ interface SchemaSettingMismatch {
10
+ readonly key: string;
11
+ readonly expected: string;
12
+ readonly found: string | null;
13
+ }
14
+ /** The database needs `hot-updater db migrate`, or a new database; the handler answers 503. */
15
+ declare class HotUpdaterSchemaMigrationRequiredError extends Error {
16
+ readonly adapterName: string;
17
+ readonly currentVersion: string | undefined;
18
+ readonly setting?: SchemaSettingMismatch | undefined;
19
+ constructor(adapterName: string, currentVersion: string | undefined, setting?: SchemaSettingMismatch | undefined, options?: ErrorOptions);
20
+ }
21
+ /** Settings keys and the values a process expects, `schema.engine` included. */
22
+ type SchemaSettings = Readonly<Record<string, string>>;
23
+ /**
24
+ * Whether a read failed because a table or column is missing, so the
25
+ * database needs migrations. ORMs may wrap the driver's error in `cause`.
26
+ */
27
+ declare const isMissingSchemaError: (error: unknown) => boolean;
28
+ /** Throws unless every expected setting is stored with its value: one batch read. */
29
+ declare const checkSchemaFence: (adapter: DatabaseAdapter, adapterName: string, expected: SchemaSettings) => Promise<void>;
30
+ /** The database name a fenced adapter carries, so a server can fence its plugins' rows too. */
31
+ declare const FENCED: unique symbol;
32
+ interface FencedAdapter extends DatabaseAdapter {
33
+ readonly [FENCED]?: string;
34
+ }
35
+ /**
36
+ * The adapter behind the schema fence: a process's first read or write
37
+ * checks the settings first. Success is kept; a failure is checked again on
38
+ * the next call.
39
+ */
40
+ declare const withSchemaFence: (adapter: DatabaseAdapter, adapterName: string, expected: SchemaSettings) => FencedAdapter;
41
+ //#endregion
42
+ export { ENGINE_SCHEMA_KEY, ENGINE_SCHEMA_VERSION, HotUpdaterSchemaMigrationRequiredError, SETTINGS_TABLE, SchemaSettingMismatch, SchemaSettings, checkSchemaFence, isMissingSchemaError, withSchemaFence };