@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,335 @@
1
+ import {
2
+ DATABASE_VERSION_COLUMN,
3
+ type DatabaseKeyValue,
4
+ type StoredRow,
5
+ } from "@hot-updater/plugin-core/internal";
6
+
7
+ import { createEngine, type DatabaseEngineOptions } from "./engine";
8
+ import type { Page, ReadInput } from "./engineReads";
9
+ import {
10
+ assertOutsideTransaction,
11
+ type TransactionEngine,
12
+ } from "./engineTransaction";
13
+ import type { SchemaModule } from "./resolveSchema";
14
+ import type {
15
+ AggregateDefinition,
16
+ FieldType,
17
+ FieldValue,
18
+ ModuleSchema,
19
+ RowOf,
20
+ TableDefinition,
21
+ } from "./schema";
22
+
23
+ type TableNames<S extends ModuleSchema> = {
24
+ [K in keyof S]: S[K] extends TableDefinition ? K : never;
25
+ }[keyof S] &
26
+ string;
27
+
28
+ type AggregateNames<S extends ModuleSchema> = {
29
+ [K in keyof S]: S[K] extends AggregateDefinition ? K : never;
30
+ }[keyof S] &
31
+ string;
32
+
33
+ /** Reference counters: how many rows of another table point at this one. */
34
+ type RefColumns = { readonly [K: `_refs_${string}`]: number };
35
+
36
+ /** Engine columns every stored row carries. */
37
+ export type EngineColumns = { readonly _v: number } & RefColumns;
38
+
39
+ type DerivedValues<TDerived> = {
40
+ -readonly [K in keyof TDerived]: TDerived[K] extends FieldType
41
+ ? FieldValue<TDerived[K]> | readonly FieldValue<TDerived[K]>[] | null
42
+ : never;
43
+ };
44
+
45
+ type Values<TModel> =
46
+ TModel extends TableDefinition<infer TFields, infer TDerived>
47
+ ? RowOf<TFields> & DerivedValues<TDerived>
48
+ : TModel extends AggregateDefinition<
49
+ infer TFields,
50
+ infer TMetric,
51
+ infer _TIndexes,
52
+ infer TSketch
53
+ >
54
+ ? RowOf<TFields> & { -readonly [K in TMetric]: number } & {
55
+ -readonly [K in TSketch]: string;
56
+ }
57
+ : never;
58
+
59
+ /** A row read in a transaction, `_v` included, so the transaction can write it back. */
60
+ export type TableRow<TModel> = Values<TModel> & EngineColumns;
61
+ /** A row read outside a transaction, without `_v`, which only a transaction's guard uses. */
62
+ export type ReadRow<TModel> = Values<TModel> & RefColumns;
63
+ export type AggregateRow<TModel> = Values<TModel>;
64
+
65
+ type IndexesOf<TModel> = TModel extends { readonly indexes: infer I }
66
+ ? I
67
+ : never;
68
+ type IndexName<TModel> = keyof IndexesOf<TModel> & string;
69
+ type IndexFields<
70
+ TModel,
71
+ TIndex,
72
+ TPart extends "eq" | "sort",
73
+ > = IndexesOf<TModel>[TIndex & keyof IndexesOf<TModel>] extends {
74
+ readonly [P in TPart]: readonly (infer F)[];
75
+ }
76
+ ? F & keyof Values<TModel>
77
+ : never;
78
+
79
+ type KeyValueOf<TModel, TField extends keyof Values<TModel>> = Exclude<
80
+ Values<TModel>[TField],
81
+ null | readonly unknown[]
82
+ >;
83
+
84
+ type FirstOrderField<TModel, TIndex> = IndexesOf<TModel>[TIndex &
85
+ keyof IndexesOf<TModel>] extends {
86
+ readonly sort: readonly [infer F, ...unknown[]];
87
+ }
88
+ ? F & keyof Values<TModel>
89
+ : TModel extends { readonly key: readonly (infer K)[] }
90
+ ? K & keyof Values<TModel>
91
+ : never;
92
+
93
+ export interface ReadOptions<TModel, TIndex> {
94
+ readonly index: TIndex;
95
+ /** Every eq field of the index; null never matches. */
96
+ readonly where: {
97
+ readonly [F in IndexFields<TModel, TIndex, "eq">]: KeyValueOf<TModel, F>;
98
+ };
99
+ /** Bounds on the first order field, or on a prefix of the order tuple (sort fields, then the key). */
100
+ readonly range?: {
101
+ readonly [B in "gt" | "gte" | "lt" | "lte"]?:
102
+ | KeyValueOf<TModel, FirstOrderField<TModel, TIndex>>
103
+ | readonly [
104
+ KeyValueOf<TModel, FirstOrderField<TModel, TIndex>>,
105
+ ...DatabaseKeyValue[],
106
+ ];
107
+ };
108
+ readonly order?: "asc" | "desc";
109
+ readonly limit: number;
110
+ readonly cursor?: string;
111
+ }
112
+
113
+ type UniqueLookups<TModel> =
114
+ TModel extends TableDefinition<infer TFields, infer _D, infer TIndexes>
115
+ ?
116
+ | {
117
+ [F in keyof TFields]: TFields[F] extends { readonly unique: true }
118
+ ? {
119
+ readonly [P in F]: KeyValueOf<
120
+ TModel,
121
+ P & keyof Values<TModel>
122
+ >;
123
+ }
124
+ : never;
125
+ }[keyof TFields]
126
+ | {
127
+ [I in keyof TIndexes]: TIndexes[I] extends {
128
+ readonly unique: true;
129
+ readonly eq: readonly (infer E)[];
130
+ }
131
+ ? {
132
+ readonly [P in E & string]: KeyValueOf<
133
+ TModel,
134
+ P & keyof Values<TModel>
135
+ >;
136
+ }
137
+ : never;
138
+ }[keyof TIndexes]
139
+ : never;
140
+
141
+ /** A table's key values. */
142
+ export type KeyLookup<TModel> =
143
+ TModel extends TableDefinition<infer _F>
144
+ ? {
145
+ readonly [K in TModel["key"][number]]: KeyValueOf<
146
+ TModel,
147
+ K & keyof Values<TModel>
148
+ >;
149
+ }
150
+ : never;
151
+
152
+ /** The key, or the eq fields of a unique index. */
153
+ export type Lookup<TModel> = KeyLookup<TModel> | UniqueLookups<TModel>;
154
+
155
+ type RootedIndexName<TModel> = {
156
+ [I in keyof IndexesOf<TModel>]: IndexesOf<TModel>[I] extends {
157
+ readonly root: object;
158
+ }
159
+ ? I
160
+ : never;
161
+ }[keyof IndexesOf<TModel>] &
162
+ string;
163
+
164
+ type OptionalFields<TFields> = {
165
+ [K in keyof TFields]: TFields[K] extends { readonly required: false }
166
+ ? K
167
+ : never;
168
+ }[keyof TFields];
169
+
170
+ /** Declared fields, optional ones omittable; derived fields and engine columns are computed. */
171
+ export type CreateRow<TModel> =
172
+ TModel extends TableDefinition<infer TFields>
173
+ ? Omit<RowOf<TFields>, OptionalFields<TFields>> &
174
+ Partial<Pick<RowOf<TFields>, OptionalFields<TFields>>>
175
+ : never;
176
+
177
+ /** Changed non-key fields. */
178
+ export type UpdateSet<TModel> =
179
+ TModel extends TableDefinition<infer TFields, infer _D, infer _I, infer TKey>
180
+ ? Partial<Omit<RowOf<TFields>, TKey[number]>>
181
+ : never;
182
+
183
+ export type AggregateIdentity<TModel> =
184
+ TModel extends AggregateDefinition<infer TFields> ? RowOf<TFields> : never;
185
+
186
+ /** Counter and gauge deltas, and sketches to merge. */
187
+ export type AggregateChanges<TModel> =
188
+ TModel extends AggregateDefinition<
189
+ infer _F,
190
+ infer TMetric,
191
+ infer _I,
192
+ infer TSketch
193
+ >
194
+ ? { readonly [K in TMetric]?: number } & {
195
+ readonly [K in TSketch]?: string;
196
+ }
197
+ : never;
198
+
199
+ /** Reads are recorded and guarded at commit; writes apply only if every guard holds. */
200
+ export interface HotUpdaterTransaction<S extends ModuleSchema> {
201
+ findOne<M extends TableNames<S>>(
202
+ model: M,
203
+ lookup: Lookup<S[M]>,
204
+ ): Promise<TableRow<S[M]> | null>;
205
+ /** Rooted indexes only: the parent row guards the whole range. */
206
+ findMany<M extends TableNames<S>, I extends RootedIndexName<S[M]>>(
207
+ model: M,
208
+ options: ReadOptions<S[M], I>,
209
+ ): Promise<Page<TableRow<S[M]>>>;
210
+ create<M extends TableNames<S>>(model: M, row: CreateRow<S[M]>): void;
211
+ /** Patches a row this transaction read, by key or through a rooted range. */
212
+ update<M extends TableNames<S>>(
213
+ model: M,
214
+ row: TableRow<S[M]>,
215
+ set: UpdateSet<S[M]>,
216
+ ): void;
217
+ /** Deletes a row this transaction read, cascading to its children first. */
218
+ delete<M extends TableNames<S>>(model: M, row: TableRow<S[M]>): Promise<void>;
219
+ /**
220
+ * Changes one shard row of an aggregate. Gauges of a sharded aggregate need
221
+ * `shardBy`, so every change keyed by one value lands on one shard.
222
+ */
223
+ aggregate<M extends AggregateNames<S>>(
224
+ model: M,
225
+ identity: AggregateIdentity<S[M]>,
226
+ changes: AggregateChanges<S[M]>,
227
+ options?: { readonly shardBy?: string },
228
+ ): void;
229
+ }
230
+
231
+ /** A table name, or the reason an aggregate cannot be read this way. */
232
+ export type FindManyModel<S extends ModuleSchema, M> =
233
+ M extends TableNames<S>
234
+ ? M
235
+ : "findMany reads tables; read aggregates with findAggregates";
236
+
237
+ /** An aggregate name, or the reason a table cannot be read this way. */
238
+ export type FindAggregatesModel<S extends ModuleSchema, M> =
239
+ M extends AggregateNames<S>
240
+ ? M
241
+ : "findAggregates reads aggregates; read tables with findMany";
242
+
243
+ /** A module's database handle. There is no count, offset, or free-form filter. */
244
+ export interface HotUpdaterDatabase<S extends ModuleSchema> {
245
+ findOne<M extends TableNames<S>>(
246
+ model: M,
247
+ lookup: Lookup<S[M]>,
248
+ ): Promise<ReadRow<S[M]> | null>;
249
+ /** Rows by key in one batch read, in the keys' order. */
250
+ findByKeys<M extends TableNames<S>>(
251
+ model: M,
252
+ keys: readonly KeyLookup<S[M]>[],
253
+ ): Promise<(ReadRow<S[M]> | null)[]>;
254
+ findMany<M extends keyof S & string, I extends IndexName<S[M]>>(
255
+ model: FindManyModel<S, M>,
256
+ options: ReadOptions<S[M], I>,
257
+ ): Promise<Page<ReadRow<S[M]>>>;
258
+ findAggregates<M extends keyof S & string, I extends IndexName<S[M]>>(
259
+ model: FindAggregatesModel<S, M>,
260
+ options: ReadOptions<S[M], I>,
261
+ ): Promise<Page<AggregateRow<S[M]>>>;
262
+ /** Reruns `fn` when a guarded read changed, within a jittered retry budget. */
263
+ transaction<R>(fn: (tx: HotUpdaterTransaction<S>) => Promise<R>): Promise<R>;
264
+ }
265
+
266
+ /** The engine plus `database(module)`, which hands a module its typed handle. */
267
+ export const createDatabaseEngine = (options: DatabaseEngineOptions) => {
268
+ const engine = createEngine(options);
269
+ const { reads } = engine;
270
+ const outside =
271
+ <A extends unknown[], T>(read: (...args: A) => T) =>
272
+ (...args: A): T => {
273
+ assertOutsideTransaction();
274
+ return read(...args);
275
+ };
276
+ /** No read outside a transaction returns `_v`, which a key-value index copy lacks. */
277
+ const bare = (row: StoredRow | null) =>
278
+ row &&
279
+ Object.fromEntries(
280
+ Object.entries(row).filter(
281
+ ([column]) => column !== DATABASE_VERSION_COLUMN,
282
+ ),
283
+ );
284
+ const barePage = async (page: Promise<Page<StoredRow>>) => {
285
+ const { rows, next } = await page;
286
+ return { rows: rows.map(bare), ...(next === undefined ? {} : { next }) };
287
+ };
288
+ return {
289
+ ...engine,
290
+ database<S extends ModuleSchema>(
291
+ module: SchemaModule & { readonly schema: S },
292
+ ): HotUpdaterDatabase<S> {
293
+ const name = (model: string) =>
294
+ module.namespace ? `${module.namespace}_${model}` : model;
295
+ return {
296
+ findOne: outside(
297
+ async (model, lookup) =>
298
+ bare(await reads.findOne(name(model), lookup as never)) as never,
299
+ ),
300
+ findByKeys: outside(
301
+ async (model, keys) =>
302
+ (await reads.findByKeys(name(model), keys as never)).map(
303
+ bare,
304
+ ) as never,
305
+ ),
306
+ findMany: outside(
307
+ (model, input) =>
308
+ barePage(reads.findMany(name(model), input as ReadInput)) as never,
309
+ ),
310
+ findAggregates: outside(
311
+ (model, input) =>
312
+ barePage(
313
+ reads.findAggregates(name(model), input as ReadInput),
314
+ ) as never,
315
+ ),
316
+ transaction: (fn) =>
317
+ engine.transaction((tx: TransactionEngine) =>
318
+ fn({
319
+ findOne: (model, lookup) =>
320
+ tx.findOne(name(model), lookup as never) as never,
321
+ findMany: (model, input) =>
322
+ tx.findMany(name(model), input as ReadInput) as never,
323
+ create: (model, row) => tx.create(name(model), row),
324
+ update: (model, row, set) => tx.update(name(model), row, set),
325
+ delete: (model, row) => tx.delete(name(model), row),
326
+ aggregate: (model, identity, changes, options) =>
327
+ tx.aggregate(name(model), identity, changes, options),
328
+ }),
329
+ ),
330
+ };
331
+ },
332
+ };
333
+ };
334
+
335
+ export type DatabaseEngine = ReturnType<typeof createDatabaseEngine>;
@@ -0,0 +1,135 @@
1
+ import { describe, expectTypeOf, it } from "vitest";
2
+
3
+ import type {
4
+ FindAggregatesModel,
5
+ FindManyModel,
6
+ HotUpdaterDatabase,
7
+ Lookup,
8
+ } from "./database";
9
+ import { defineAggregate, defineTable } from "./schema";
10
+
11
+ const schema = {
12
+ bundles: defineTable(
13
+ {
14
+ id: { type: "string" },
15
+ platform: { type: "string" },
16
+ tag: { type: "string", required: false },
17
+ hash: { type: "string", unique: true },
18
+ },
19
+ {
20
+ key: ["id"],
21
+ indexes: {
22
+ byPlatform: { eq: ["platform"], sort: ["id"] },
23
+ byTag: { eq: ["tag"], sort: ["id"] },
24
+ },
25
+ },
26
+ ),
27
+ totals: defineAggregate(
28
+ { scope: { type: "string" } },
29
+ {
30
+ key: ["scope"],
31
+ counters: ["hits"],
32
+ indexes: { all: { eq: [], sort: ["scope"] } },
33
+ },
34
+ ),
35
+ } as const;
36
+
37
+ type Schema = typeof schema;
38
+
39
+ /** The callback is type-checked and never runs. */
40
+ const typeOnly = (check: (db: HotUpdaterDatabase<Schema>) => void) =>
41
+ void check;
42
+
43
+ describe("database API types", () => {
44
+ it("names the right read in its error text", () => {
45
+ expectTypeOf<
46
+ FindManyModel<Schema, "totals">
47
+ >().toEqualTypeOf<"findMany reads tables; read aggregates with findAggregates">();
48
+ expectTypeOf<
49
+ FindAggregatesModel<Schema, "bundles">
50
+ >().toEqualTypeOf<"findAggregates reads aggregates; read tables with findMany">();
51
+ typeOnly((db) => {
52
+ // @ts-expect-error Aggregates are read with findAggregates.
53
+ void db.findMany("totals", { index: "all", where: {}, limit: 1 });
54
+ void db.findAggregates(
55
+ // @ts-expect-error Tables are read with findMany.
56
+ "bundles",
57
+ { index: "byPlatform", where: { platform: "ios" }, limit: 1 },
58
+ );
59
+ });
60
+ });
61
+
62
+ it("has no count, offset, or free-form filter", () => {
63
+ expectTypeOf<keyof HotUpdaterDatabase<Schema>>().toEqualTypeOf<
64
+ "findOne" | "findByKeys" | "findMany" | "findAggregates" | "transaction"
65
+ >();
66
+ typeOnly((db) => {
67
+ // @ts-expect-error There is no count.
68
+ void db.count;
69
+ void db.findMany("bundles", {
70
+ index: "byPlatform",
71
+ where: { platform: "ios" },
72
+ limit: 1,
73
+ // @ts-expect-error There is no offset.
74
+ offset: 5,
75
+ });
76
+ });
77
+ });
78
+
79
+ it("reads only declared indexes with every eq field bound to a value", () => {
80
+ typeOnly((db) => {
81
+ void db.findMany("bundles", {
82
+ // @ts-expect-error byHash is not a declared index.
83
+ index: "byHash",
84
+ where: { platform: "ios", tag: "beta" },
85
+ limit: 1,
86
+ });
87
+ void db.findMany("bundles", {
88
+ index: "byPlatform",
89
+ // @ts-expect-error byPlatform needs its platform field.
90
+ where: {},
91
+ limit: 1,
92
+ });
93
+ void db.findMany("bundles", {
94
+ index: "byTag",
95
+ // @ts-expect-error A sparse index never matches null.
96
+ where: { tag: null },
97
+ limit: 1,
98
+ });
99
+ void db.findMany("bundles", {
100
+ index: "byTag",
101
+ where: { tag: "beta" },
102
+ limit: 1,
103
+ });
104
+ });
105
+ });
106
+
107
+ it("creates full rows and updates only non-key fields in a transaction", () => {
108
+ typeOnly((db) => {
109
+ void db.transaction(async (tx) => {
110
+ tx.create("bundles", { id: "b", platform: "ios", hash: "h" });
111
+ // @ts-expect-error hash is required.
112
+ tx.create("bundles", { id: "b", platform: "ios" });
113
+ const row = await tx.findOne("bundles", { id: "b" });
114
+ if (row === null) return;
115
+ tx.update("bundles", row, { tag: null });
116
+ // @ts-expect-error Key fields cannot change.
117
+ tx.update("bundles", row, { id: "c" });
118
+ // @ts-expect-error Aggregates are not written through create.
119
+ tx.create("totals", { scope: "s" });
120
+ });
121
+ });
122
+ });
123
+
124
+ it("finds one row only by its key or a unique field", () => {
125
+ expectTypeOf<Lookup<Schema["bundles"]>>().toEqualTypeOf<
126
+ { readonly id: string } | { readonly hash: string }
127
+ >();
128
+ typeOnly((db) => {
129
+ // @ts-expect-error platform is neither the key nor unique.
130
+ void db.findOne("bundles", { platform: "ios" });
131
+ // @ts-expect-error findOne reads tables.
132
+ void db.findOne("totals", { scope: "s" });
133
+ });
134
+ });
135
+ });
@@ -0,0 +1,72 @@
1
+ /**
2
+ * The model declarations the engine reads. `defineTable` and
3
+ * `defineAggregate` (./schema) build them with typed rows.
4
+ */
5
+ export type FieldType = "string" | "integer" | "number" | "boolean" | "json";
6
+
7
+ export type ReferenceAction = "restrict" | "cascade" | "none";
8
+
9
+ export interface FieldReference {
10
+ readonly model: string;
11
+ readonly onDelete: ReferenceAction;
12
+ }
13
+
14
+ export interface FieldDefinition<TType extends FieldType = FieldType> {
15
+ readonly type: TType;
16
+ /** Defaults to true; an optional field stores null. */
17
+ readonly required?: boolean;
18
+ /** Adds a unique index named after the field. */
19
+ readonly unique?: true;
20
+ /** Strings: the maximum length; unbounded text when absent. */
21
+ readonly maxLength?: number;
22
+ /** Strings: ASCII only, so a long key fits MySQL's 3,072-byte index limit. */
23
+ readonly ascii?: true;
24
+ readonly references?: FieldReference;
25
+ }
26
+
27
+ export interface IndexDefinition<TField extends string = string> {
28
+ readonly eq: readonly TField[];
29
+ readonly sort: readonly TField[];
30
+ /** The eq values identify at most one row. */
31
+ readonly unique?: true;
32
+ /** `eq` starts with the key of a `model` row, which every child write bumps. */
33
+ readonly root?: { readonly model: string };
34
+ }
35
+
36
+ /** A field computed on every write and stored as a real column. */
37
+ export interface DerivedShape {
38
+ readonly type: FieldType;
39
+ /** Up to 16 values; the row is indexed once per value. */
40
+ readonly multi?: true;
41
+ /** Null, or an empty list, leaves the row out of indexes on this field. */
42
+ compute(row: never): unknown;
43
+ }
44
+
45
+ export interface TableShape {
46
+ readonly kind: "table";
47
+ readonly fields: Readonly<Record<string, FieldDefinition>>;
48
+ readonly key: readonly string[];
49
+ readonly derived: Readonly<Record<string, DerivedShape>>;
50
+ readonly indexes: Readonly<Record<string, IndexDefinition>>;
51
+ }
52
+
53
+ export interface AggregateShape {
54
+ readonly kind: "aggregate";
55
+ /** Identity fields; `key` lists them in declaration order. */
56
+ readonly fields: Readonly<Record<string, FieldDefinition>>;
57
+ readonly key: readonly string[];
58
+ /** Blind increments. */
59
+ readonly counters: readonly string[];
60
+ /** Read, merged, and written back per shard; a row at zero is deleted. */
61
+ readonly gauges: readonly string[];
62
+ /** HLL sketches, kept in aggregates of their own. */
63
+ readonly distinct: readonly string[];
64
+ /** Fixed once data exists. */
65
+ readonly shards: number;
66
+ readonly indexes: Readonly<Record<string, IndexDefinition>>;
67
+ }
68
+
69
+ export type ModelShape = TableShape | AggregateShape;
70
+
71
+ /** A module's models by name: core, or one plugin. */
72
+ export type SchemaShape = Readonly<Record<string, ModelShape>>;
@@ -0,0 +1,62 @@
1
+ import {
2
+ type DatabaseAdapter,
3
+ type DatabaseReadCount,
4
+ verifyAdapter,
5
+ } from "@hot-updater/plugin-core/internal";
6
+
7
+ import { createEngineReads, type EngineReadCount } from "./engineReads";
8
+ import { createTransactions, type RetryOptions } from "./engineTransaction";
9
+ import type { ResolvedSchema } from "./resolveSchema";
10
+
11
+ export interface DatabaseEngineOptions {
12
+ readonly adapter: DatabaseAdapter;
13
+ readonly schema: ResolvedSchema;
14
+ readonly maxPageSize?: number;
15
+ /** Checks every adapter call against the contract and meters adapter reads. */
16
+ readonly verify?: boolean;
17
+ readonly retry?: RetryOptions;
18
+ }
19
+
20
+ export interface ReadMeasurement<T> {
21
+ readonly result: T;
22
+ /** Point reads and rows the adapter returned. */
23
+ readonly adapter: DatabaseReadCount;
24
+ /** Calls and rows (logical rows for aggregates) returned to callers. */
25
+ readonly engine: EngineReadCount;
26
+ }
27
+
28
+ /** Storage semantics over one adapter, addressed by physical table name. */
29
+ export const createEngine = ({
30
+ adapter: given,
31
+ schema,
32
+ maxPageSize,
33
+ verify,
34
+ retry,
35
+ }: DatabaseEngineOptions) => {
36
+ const verified = verify ? verifyAdapter(given) : undefined;
37
+ const adapter = verified ?? given;
38
+ const reads = createEngineReads({ adapter, schema, maxPageSize });
39
+ const { transaction } = createTransactions({ adapter, schema, reads, retry });
40
+ return {
41
+ reads,
42
+ transaction,
43
+ /** Runs `read` and reports what it read at both boundaries (verify mode only). */
44
+ async measureReads<T>(read: () => Promise<T>): Promise<ReadMeasurement<T>> {
45
+ if (verified === undefined) {
46
+ throw new Error(
47
+ "measureReads needs an engine created with verify: true.",
48
+ );
49
+ }
50
+ verified.reads.reset();
51
+ reads.reads.reset();
52
+ const result = await read();
53
+ return {
54
+ result,
55
+ adapter: verified.reads.total(),
56
+ engine: reads.reads.total(),
57
+ };
58
+ },
59
+ };
60
+ };
61
+
62
+ export type Engine = ReturnType<typeof createEngine>;