@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,223 @@
1
+ import { DatabaseSync } from "node:sqlite";
2
+
3
+ import { PGlite } from "@electric-sql/pglite";
4
+ import {
5
+ createMemoryAdapter,
6
+ type DatabaseAdapter,
7
+ } from "@hot-updater/plugin-core/internal";
8
+ import { afterAll, describe, expect, it, vi } from "vitest";
9
+
10
+ import {
11
+ builtInSettings,
12
+ createEngineDatabase,
13
+ migrateBuiltInSchema,
14
+ } from "../db/builtInDatabase";
15
+ import { migrateSchema, writeSchemaSettings } from "../db/schemaSettings";
16
+ import { createHotUpdater } from "../index";
17
+ import {
18
+ checkSchemaFence,
19
+ HotUpdaterSchemaMigrationRequiredError,
20
+ isMissingSchemaError,
21
+ SETTINGS_TABLE,
22
+ withSchemaFence,
23
+ } from "./fence";
24
+ import { createSqlAdapter } from "./sql/sqlAdapter";
25
+ import { pgliteExecutor, sqliteExecutor } from "./sql/sqlTestExecutors";
26
+
27
+ const settings = { "schema.engine": "1", "schema.core": "1.0.0" };
28
+
29
+ /** Counts the adapter's point reads. */
30
+ const counted = (adapter: DatabaseAdapter) => {
31
+ const calls = { gets: 0 };
32
+ return {
33
+ calls,
34
+ adapter: {
35
+ ...adapter,
36
+ get: (table, keys) => {
37
+ calls.gets += 1;
38
+ return adapter.get(table, keys);
39
+ },
40
+ } satisfies DatabaseAdapter,
41
+ };
42
+ };
43
+
44
+ const mismatch = (promise: Promise<unknown>) =>
45
+ promise.then(
46
+ () => undefined,
47
+ (error: unknown) =>
48
+ error instanceof HotUpdaterSchemaMigrationRequiredError
49
+ ? error.setting
50
+ : error,
51
+ );
52
+
53
+ describe("schema fence", () => {
54
+ it("passes once migrations wrote every setting, and names the first missing or different one", async () => {
55
+ const memory = createMemoryAdapter();
56
+ await expect(
57
+ mismatch(checkSchemaFence(memory, "memory", settings)),
58
+ ).resolves.toEqual({
59
+ key: "schema.engine",
60
+ expected: "1",
61
+ found: null,
62
+ });
63
+
64
+ await migrateSchema(memory, "memory", [], settings);
65
+ await expect(
66
+ checkSchemaFence(memory, "memory", settings),
67
+ ).resolves.toBeUndefined();
68
+ await expect(
69
+ mismatch(
70
+ checkSchemaFence(memory, "memory", {
71
+ ...settings,
72
+ "schema.insights": "1.0.0",
73
+ }),
74
+ ),
75
+ ).resolves.toEqual({
76
+ key: "schema.insights",
77
+ expected: "1.0.0",
78
+ found: null,
79
+ });
80
+ await expect(
81
+ mismatch(checkSchemaFence(memory, "memory", { "schema.core": "2.0.0" })),
82
+ ).resolves.toEqual({
83
+ key: "schema.core",
84
+ expected: "2.0.0",
85
+ found: "1.0.0",
86
+ });
87
+ });
88
+
89
+ it("checks before a process's first read only, and again after a failure", async () => {
90
+ const memory = createMemoryAdapter();
91
+ const { adapter, calls } = counted(memory);
92
+ const fenced = withSchemaFence(adapter, "memory", settings);
93
+ await expect(fenced.get(SETTINGS_TABLE, [["x"]])).rejects.toBeInstanceOf(
94
+ HotUpdaterSchemaMigrationRequiredError,
95
+ );
96
+ await expect(fenced.get(SETTINGS_TABLE, [["x"]])).rejects.toBeInstanceOf(
97
+ HotUpdaterSchemaMigrationRequiredError,
98
+ );
99
+ expect(calls.gets).toBe(2);
100
+
101
+ await migrateSchema(memory, "memory", [], settings);
102
+ calls.gets = 0;
103
+ await fenced.get(SETTINGS_TABLE, [["x"]]);
104
+ await fenced.get(SETTINGS_TABLE, [["x"]]);
105
+ // one fence read, then the two reads themselves
106
+ expect(calls.gets).toBe(3);
107
+ });
108
+
109
+ it("rewrites only changed settings and refuses a database from before the engine", async () => {
110
+ const memory = createMemoryAdapter();
111
+ await migrateSchema(memory, "memory", [], settings);
112
+ const writes: unknown[] = [];
113
+ const recorded: DatabaseAdapter = {
114
+ ...memory,
115
+ write: (ops) => {
116
+ writes.push(ops);
117
+ return memory.write(ops);
118
+ },
119
+ };
120
+ await writeSchemaSettings(recorded, "memory", settings);
121
+ expect(writes).toEqual([]);
122
+ await writeSchemaSettings(recorded, "memory", {
123
+ ...settings,
124
+ "schema.insights": "1.0.0",
125
+ });
126
+ expect(writes).toHaveLength(1);
127
+
128
+ const legacy = createMemoryAdapter();
129
+ await legacy.write([
130
+ {
131
+ type: "insert",
132
+ table: SETTINGS_TABLE,
133
+ row: { key: "schema.core", value: "1.0.0", _v: 0 },
134
+ },
135
+ ]);
136
+ await expect(
137
+ mismatch(writeSchemaSettings(legacy, "memory", settings)),
138
+ ).resolves.toEqual({ key: "schema.engine", expected: "1", found: null });
139
+ });
140
+ it("reads a missing table as missing settings and rethrows any other failure", async () => {
141
+ const empty = createSqlAdapter({
142
+ executor: sqliteExecutor(new DatabaseSync(":memory:")),
143
+ });
144
+ await expect(
145
+ mismatch(checkSchemaFence(empty, "sqlite", settings)),
146
+ ).resolves.toEqual({ key: "schema.engine", expected: "1", found: null });
147
+
148
+ const refused = new Error("connect ECONNREFUSED 127.0.0.1:5432");
149
+ const offline: DatabaseAdapter = {
150
+ ...createMemoryAdapter(),
151
+ get: async () => {
152
+ throw refused;
153
+ },
154
+ };
155
+ await expect(checkSchemaFence(offline, "memory", settings)).rejects.toBe(
156
+ refused,
157
+ );
158
+ await expect(migrateSchema(offline, "memory", [], settings)).rejects.toBe(
159
+ refused,
160
+ );
161
+ });
162
+
163
+ it.each([
164
+ [
165
+ "PostgreSQL",
166
+ Object.assign(new Error('relation "x" does not exist'), {
167
+ code: "42P01",
168
+ }),
169
+ ],
170
+ [
171
+ "MySQL",
172
+ Object.assign(new Error("Table 'db.x' doesn't exist"), {
173
+ code: "ER_NO_SUCH_TABLE",
174
+ }),
175
+ ],
176
+ ["SQLite", new Error("SQLITE_ERROR: no such table: x")],
177
+ [
178
+ "an ORM wrapping the driver",
179
+ new Error("Failed query", { cause: new Error("no such column: _v") }),
180
+ ],
181
+ ])("recognizes a missing table or column from %s", (_, error) => {
182
+ expect(isMissingSchemaError(error)).toBe(true);
183
+ });
184
+
185
+ it("does not take a missing database or a driver failure for a missing table", () => {
186
+ expect(isMissingSchemaError(new Error('database "x" does not exist'))).toBe(
187
+ false,
188
+ );
189
+ expect(
190
+ isMissingSchemaError(Object.assign(new Error("x"), { code: "28P01" })),
191
+ ).toBe(false);
192
+ });
193
+ });
194
+
195
+ describe("a provider's fenced database on PGlite", () => {
196
+ const pglite = new PGlite();
197
+ afterAll(() => pglite.close());
198
+
199
+ it("answers 503 before migrations and serves after them", async () => {
200
+ const adapter = createSqlAdapter({
201
+ executor: pgliteExecutor(pglite),
202
+ tablePrefix: "fence_",
203
+ });
204
+ const hotUpdater = createHotUpdater({
205
+ database: createEngineDatabase({ name: "pglite", adapter }),
206
+ clientAccess: "public",
207
+ });
208
+ const channels = () =>
209
+ hotUpdater.handlers.admin(
210
+ new Request("https://updates.example.com/channels"),
211
+ );
212
+
213
+ const error = vi.spyOn(console, "error").mockImplementation(() => {});
214
+ expect((await channels()).status).toBe(503);
215
+ error.mockRestore();
216
+ await migrateBuiltInSchema(adapter, "pglite");
217
+ await expect(
218
+ checkSchemaFence(adapter, "pglite", builtInSettings),
219
+ ).resolves.toBeUndefined();
220
+ expect((await channels()).status).toBe(200);
221
+ await expect(hotUpdater.core.listChannels()).resolves.toEqual([]);
222
+ });
223
+ });
@@ -0,0 +1,171 @@
1
+ import type {
2
+ DatabaseAdapter,
3
+ PhysicalTable,
4
+ StoredRow,
5
+ } from "@hot-updater/plugin-core/internal";
6
+
7
+ /** The settings rows migrations write, last, and the fence reads. */
8
+ export const SETTINGS_TABLE: PhysicalTable = {
9
+ name: "private_hot_updater_settings",
10
+ columns: [
11
+ { name: "key", type: "string", nullable: false, maxLength: 255 },
12
+ { name: "value", type: "string", nullable: false, maxLength: 255 },
13
+ { name: "_v", type: "integer", nullable: false, default: 0 },
14
+ ],
15
+ key: ["key"],
16
+ indexes: [],
17
+ };
18
+
19
+ /** The engine's storage-layout generation; it changes only with a migration. */
20
+ export const ENGINE_SCHEMA_KEY = "schema.engine";
21
+ export const ENGINE_SCHEMA_VERSION = "1";
22
+
23
+ /** A schema setting the fence found missing or different. */
24
+ export interface SchemaSettingMismatch {
25
+ readonly key: string;
26
+ readonly expected: string;
27
+ readonly found: string | null;
28
+ }
29
+
30
+ const settingMessage = (
31
+ adapterName: string,
32
+ { key, expected, found }: SchemaSettingMismatch,
33
+ ) =>
34
+ `Hot Updater schema setting "${key}" for ${adapterName} is ${found === null ? "missing" : `"${found}"`}; expected "${expected}". ${
35
+ key === ENGINE_SCHEMA_KEY
36
+ ? "Create a new empty database and run `hot-updater db migrate`; databases from before the storage engine are not converted."
37
+ : "Run `hot-updater db migrate`."
38
+ }`;
39
+
40
+ /** The database needs `hot-updater db migrate`, or a new database; the handler answers 503. */
41
+ export class HotUpdaterSchemaMigrationRequiredError extends Error {
42
+ constructor(
43
+ readonly adapterName: string,
44
+ readonly currentVersion: string | undefined,
45
+ readonly setting?: SchemaSettingMismatch,
46
+ options?: ErrorOptions,
47
+ ) {
48
+ super(
49
+ setting !== undefined
50
+ ? settingMessage(adapterName, setting)
51
+ : currentVersion === undefined
52
+ ? `Hot Updater database schema is not initialized for ${adapterName}. Run \`hot-updater db migrate\` before using this adapter.`
53
+ : `Hot Updater v1 cannot migrate schema ${currentVersion} in place. Create a new empty database and run \`hot-updater db migrate\`.`,
54
+ options,
55
+ );
56
+ this.name = "HotUpdaterSchemaMigrationRequiredError";
57
+ }
58
+ }
59
+
60
+ /** Settings keys and the values a process expects, `schema.engine` included. */
61
+ export type SchemaSettings = Readonly<Record<string, string>>;
62
+
63
+ /** Driver codes for a table or column the database lacks. */
64
+ const MISSING_SCHEMA_CODES = new Set([
65
+ "42P01", // PostgreSQL undefined_table
66
+ "42703", // PostgreSQL undefined_column
67
+ "ER_NO_SUCH_TABLE", // MySQL 1146
68
+ "ER_BAD_FIELD_ERROR", // MySQL 1054
69
+ ]);
70
+ const MISSING_SCHEMA_MESSAGE =
71
+ /no such (?:table|column)|(?:relation|column) .+ does not exist|table .+ doesn't exist|unknown column/iu;
72
+
73
+ /**
74
+ * Whether a read failed because a table or column is missing, so the
75
+ * database needs migrations. ORMs may wrap the driver's error in `cause`.
76
+ */
77
+ export const isMissingSchemaError = (error: unknown): boolean => {
78
+ for (let depth = 0; error instanceof Object && depth < 8; depth += 1) {
79
+ const { code, message, cause } = error as Record<string, unknown>;
80
+ if (
81
+ MISSING_SCHEMA_CODES.has(String(code)) ||
82
+ (typeof message === "string" && MISSING_SCHEMA_MESSAGE.test(message))
83
+ ) {
84
+ return true;
85
+ }
86
+ error = cause;
87
+ }
88
+ return false;
89
+ };
90
+
91
+ export const readSettings = (
92
+ adapter: DatabaseAdapter,
93
+ keys: readonly string[],
94
+ ) =>
95
+ adapter.get(
96
+ SETTINGS_TABLE,
97
+ keys.map((key) => [key]),
98
+ );
99
+
100
+ /** Throws unless every expected setting is stored with its value: one batch read. */
101
+ export const checkSchemaFence = async (
102
+ adapter: DatabaseAdapter,
103
+ adapterName: string,
104
+ expected: SchemaSettings,
105
+ ): Promise<void> => {
106
+ const keys = Object.keys(expected);
107
+ let rows: readonly (StoredRow | null)[];
108
+ try {
109
+ rows = await readSettings(adapter, keys);
110
+ } catch (cause) {
111
+ // A connection or driver failure is not a schema to migrate.
112
+ if (!isMissingSchemaError(cause)) throw cause;
113
+ throw new HotUpdaterSchemaMigrationRequiredError(
114
+ adapterName,
115
+ undefined,
116
+ { key: ENGINE_SCHEMA_KEY, expected: ENGINE_SCHEMA_VERSION, found: null },
117
+ { cause },
118
+ );
119
+ }
120
+ keys.forEach((key, position) => {
121
+ const found = rows[position]?.value;
122
+ if (found !== expected[key]) {
123
+ throw new HotUpdaterSchemaMigrationRequiredError(adapterName, undefined, {
124
+ key,
125
+ expected: expected[key]!,
126
+ found: typeof found === "string" ? found : null,
127
+ });
128
+ }
129
+ });
130
+ };
131
+
132
+ /** The database name a fenced adapter carries, so a server can fence its plugins' rows too. */
133
+ const FENCED: unique symbol = Symbol.for("@hot-updater/server/schema-fence");
134
+
135
+ interface FencedAdapter extends DatabaseAdapter {
136
+ readonly [FENCED]?: string;
137
+ }
138
+
139
+ /** The database name an adapter behind the schema fence reports under. */
140
+ export const fencedName = (adapter: FencedAdapter): string | undefined =>
141
+ adapter[FENCED];
142
+
143
+ /**
144
+ * The adapter behind the schema fence: a process's first read or write
145
+ * checks the settings first. Success is kept; a failure is checked again on
146
+ * the next call.
147
+ */
148
+ export const withSchemaFence = (
149
+ adapter: DatabaseAdapter,
150
+ adapterName: string,
151
+ expected: SchemaSettings,
152
+ ): FencedAdapter => {
153
+ let ready: Promise<void> | undefined;
154
+ const fence = () => {
155
+ ready ??= checkSchemaFence(adapter, adapterName, expected).catch(
156
+ (error: unknown) => {
157
+ ready = undefined;
158
+ throw error;
159
+ },
160
+ );
161
+ return ready;
162
+ };
163
+ return {
164
+ ...adapter,
165
+ [FENCED]: adapterName,
166
+ get: (table, keys) => fence().then(() => adapter.get(table, keys)),
167
+ query: (table, request) =>
168
+ fence().then(() => adapter.query(table, request)),
169
+ write: (ops) => fence().then(() => adapter.write(ops)),
170
+ };
171
+ };
@@ -0,0 +1,154 @@
1
+ /**
2
+ * What database providers and storage adapter authors build on: the storage
3
+ * adapter contract, the SQL core and key-value helper that implement it,
4
+ * `createEngineDatabase`, which puts an adapter behind the schema fence as a
5
+ * provider's database, and the built-in schema and settings its migration
6
+ * writes.
7
+ */
8
+ export {
9
+ compareTuples,
10
+ compareUtf8,
11
+ createMemoryAdapter,
12
+ DATABASE_MAX_MULTI_VALUES,
13
+ DATABASE_MAX_QUERY_LIMIT,
14
+ DATABASE_VERSION_COLUMN,
15
+ DatabaseAdapterContractError,
16
+ DatabaseSchemaError,
17
+ DatabaseValueError,
18
+ indexOrderColumns,
19
+ normalizeStoredRow,
20
+ normalizeStoredValue,
21
+ verifyAdapter,
22
+ type DatabaseAdapter,
23
+ type DatabaseJson,
24
+ type DatabaseKey,
25
+ type DatabaseKeyValue,
26
+ type DatabaseReadCount,
27
+ type DatabaseReadMeter,
28
+ type DatabaseValue,
29
+ type MemoryAdapterOptions,
30
+ type NormalizeOptions,
31
+ type PhysicalColumn,
32
+ type PhysicalColumnType,
33
+ type PhysicalIndex,
34
+ type PhysicalTable,
35
+ type QueryBound,
36
+ type QueryRequest,
37
+ type StoredRow,
38
+ type VerifiedDatabaseAdapter,
39
+ type VerifyAdapterOptions,
40
+ type WriteGuard,
41
+ type WriteOp,
42
+ type WriteResult,
43
+ } from "@hot-updater/plugin-core/internal";
44
+
45
+ export {
46
+ MAX_SHARDS,
47
+ resolveSchema,
48
+ SHARD_COLUMN,
49
+ validateSchema,
50
+ type ResolvedModel,
51
+ type ResolvedReference,
52
+ type ResolvedSchema,
53
+ type SchemaModule,
54
+ } from "./resolveSchema";
55
+ export {
56
+ defineAggregate,
57
+ defineTable,
58
+ type AggregateDefinition,
59
+ type CheckIndex,
60
+ type DerivedDefinition,
61
+ type DerivedFields,
62
+ type FieldDefinition,
63
+ type FieldReference,
64
+ type FieldType,
65
+ type FieldValue,
66
+ type IndexDefinition,
67
+ type ModelDefinition,
68
+ type ModuleSchema,
69
+ type ReferenceAction,
70
+ type RowOf,
71
+ type TableDefinition,
72
+ } from "./schema";
73
+ export { DatabaseCursorError } from "./cursor";
74
+ export {
75
+ createEngine,
76
+ type DatabaseEngineOptions,
77
+ type Engine,
78
+ type ReadMeasurement,
79
+ } from "./engine";
80
+ export {
81
+ createDatabaseEngine,
82
+ type AggregateChanges,
83
+ type AggregateIdentity,
84
+ type AggregateRow,
85
+ type CreateRow,
86
+ type DatabaseEngine,
87
+ type EngineColumns,
88
+ type FindAggregatesModel,
89
+ type FindManyModel,
90
+ type HotUpdaterDatabase,
91
+ type HotUpdaterTransaction,
92
+ type KeyLookup,
93
+ type Lookup,
94
+ type ReadOptions,
95
+ type ReadRow,
96
+ type TableRow,
97
+ type UpdateSet,
98
+ } from "./database";
99
+ export {
100
+ DatabaseAmbiguousCommitError,
101
+ DatabaseConflictError,
102
+ DatabaseConstraintError,
103
+ DatabaseTransactionError,
104
+ type ConstraintReason,
105
+ } from "./errors";
106
+ export { type RetryOptions } from "./engineTransaction";
107
+ export {
108
+ DatabaseQueryError,
109
+ type EngineReadCount,
110
+ type Page,
111
+ type ReadRange,
112
+ } from "./engineReads";
113
+ export {
114
+ classifySqlError,
115
+ createSqlAdapter,
116
+ createTableStatements,
117
+ type SqlAdapterOptions,
118
+ type SqlConnection,
119
+ type SqlDialect,
120
+ type SqlExecutor,
121
+ type SqlResult,
122
+ type SqlStatement,
123
+ WRITE_GUARD_TABLE,
124
+ } from "./sql/sqlAdapter";
125
+ export {
126
+ createKvAdapter,
127
+ encodeKvKey,
128
+ type KeyValueStore,
129
+ type KvAdapterOptions,
130
+ type KvCondition,
131
+ type KvItem,
132
+ type KvKey,
133
+ type KvOp,
134
+ type KvRange,
135
+ } from "./kv/kvAdapter";
136
+ export { isMultiIndex } from "./sql/sqlSchema";
137
+ export {
138
+ builtInSchema,
139
+ builtInSettings,
140
+ builtInTarget,
141
+ createEngineDatabase,
142
+ migrateBuiltInSchema,
143
+ type EngineDatabaseOptions,
144
+ } from "../db/builtInDatabase";
145
+ export { migrateSchema, writeSchemaSettings } from "../db/schemaSettings";
146
+ export {
147
+ checkSchemaFence,
148
+ isMissingSchemaError,
149
+ ENGINE_SCHEMA_KEY,
150
+ ENGINE_SCHEMA_VERSION,
151
+ SETTINGS_TABLE,
152
+ withSchemaFence,
153
+ type SchemaSettings,
154
+ } from "./fence";
@@ -0,0 +1,17 @@
1
+ import { setupDatabaseAdapterConformanceSuite } from "@hot-updater/test-utils";
2
+
3
+ import { createKvAdapter } from "./kvAdapter";
4
+ import { createMemoryKeyValueStore } from "./kvTestStore";
5
+
6
+ setupDatabaseAdapterConformanceSuite({
7
+ name: "key-value (in-memory store)",
8
+ // The store takes 100 items per write, and a conformance insert is 3: a
9
+ // row and 2 index items. 33 inserts fit; 34 are 102 items.
10
+ maxOps: 33,
11
+ createAdapter: async ({ nativePageSize }) => ({
12
+ adapter: createKvAdapter({
13
+ store: createMemoryKeyValueStore({ nativePageSize }),
14
+ tablePrefix: "t_",
15
+ }),
16
+ }),
17
+ });
@@ -0,0 +1,17 @@
1
+ import { setupReadBudgetTestSuite } from "@hot-updater/test-utils";
2
+
3
+ import { readBudgetServer } from "../../readBudgets.testFixtures";
4
+ import { createKvAdapter } from "./kvAdapter";
5
+ import { createMemoryKeyValueStore } from "./kvTestStore";
6
+
7
+ /** The key-value helper over the in-memory store, whose writes take 100 items as DynamoDB's do. */
8
+ setupReadBudgetTestSuite({
9
+ name: "key-value (in-memory store)",
10
+ server: readBudgetServer,
11
+ createAdapter: async ({ nativePageSize }) => ({
12
+ adapter: createKvAdapter({
13
+ store: createMemoryKeyValueStore({ nativePageSize }),
14
+ }),
15
+ indexCopies: true,
16
+ }),
17
+ });