@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,101 @@
1
+ import { DatabaseAdapter, DatabaseKeyValue, StoredRow, WriteResult } from "@hot-updater/plugin-core/internal";
2
+ //#region src/database/kv/kvAdapter.d.ts
3
+ /** An item's address: a partition, and a sort key within it. */
4
+ interface KvKey {
5
+ readonly pk: string;
6
+ readonly sk: string;
7
+ }
8
+ /** What an op requires of its item before the write: that it exists or not, or that its `_v` is `v`. */
9
+ type KvCondition = {
10
+ readonly exists: boolean;
11
+ } | {
12
+ readonly v: number;
13
+ };
14
+ type KvOp = {
15
+ readonly key: KvKey;
16
+ readonly condition?: KvCondition;
17
+ } & ({
18
+ readonly type: "put";
19
+ readonly value: StoredRow;
20
+ } | {
21
+ readonly type: "delete";
22
+ } | {
23
+ readonly type: "check";
24
+ } |
25
+ /** Adds to numeric attributes, creating the item from `init` when it is missing. */
26
+ {
27
+ readonly type: "add";
28
+ readonly by: Readonly<Record<string, number>>;
29
+ readonly init?: StoredRow;
30
+ });
31
+ /** Sort keys from `gte` up to `lt` in one partition, resuming past `after`. */
32
+ interface KvRange {
33
+ readonly pk: string;
34
+ readonly gte?: string;
35
+ readonly lt?: string;
36
+ /**
37
+ * `lt` as an inclusive bound, with `lt`: every key the helper writes is
38
+ * below `lt` exactly when it is at most `lte`. A store whose two-sided
39
+ * range is inclusive (DynamoDB's `BETWEEN`) uses it to read nothing past
40
+ * the range.
41
+ */
42
+ readonly lte?: string;
43
+ readonly order: "asc" | "desc";
44
+ readonly limit: number;
45
+ readonly after?: string;
46
+ }
47
+ interface KvItem {
48
+ readonly sk: string;
49
+ readonly value: StoredRow;
50
+ }
51
+ /**
52
+ * A key-value backend (DynamoDB, Firestore): strongly consistent point
53
+ * reads, one partition's sort-key range per page, and atomic writes whose
54
+ * conditions all see the state before the write. Sort keys compare as UTF-8.
55
+ */
56
+ interface KeyValueStore {
57
+ readonly id: string;
58
+ /**
59
+ * The most items, and bytes, one atomic write takes; `itemBytes` caps each
60
+ * item, and `keyBytes` the partition and sort keys the store indexes whole.
61
+ */
62
+ readonly limits: {
63
+ readonly items: number;
64
+ readonly bytes: number;
65
+ readonly itemBytes?: number;
66
+ readonly keyBytes?: {
67
+ readonly pk: number;
68
+ readonly sk: number;
69
+ };
70
+ };
71
+ get(keys: readonly KvKey[]): Promise<readonly (StoredRow | null)[]>;
72
+ /** One native page; `more` when the range may go on past it. An empty page ends the range. */
73
+ query(range: KvRange): Promise<{
74
+ readonly items: readonly KvItem[];
75
+ readonly more: boolean;
76
+ }>;
77
+ /** Applies every op or none; `failedOp` names an op whose condition failed. */
78
+ write(ops: readonly KvOp[]): Promise<WriteResult>;
79
+ /** Prepares the store, such as its one table, for `db migrate`. */
80
+ readonly migrations?: {
81
+ apply(): Promise<void>;
82
+ };
83
+ dispose?(): Promise<void>;
84
+ }
85
+ /** Order-preserving text for key values; each value ends in the lowest code point any encoding uses. */
86
+ declare const encodeKvKey: (values: readonly DatabaseKeyValue[]) => string;
87
+ interface KvAdapterOptions {
88
+ readonly store: KeyValueStore;
89
+ readonly tablePrefix?: string;
90
+ }
91
+ /**
92
+ * The storage adapter over a key-value store. A row is one item at
93
+ * `pk = <table>`, `sk = enc(key)`; each index not in key order adds an item
94
+ * per entry at `pk = <table>#<index>#enc(eq)`, `sk = enc(order)`, and each
95
+ * unique entry one item at `sk = "#"`, written only where no other row holds
96
+ * it. Index items hold a copy of the row without `_v` or counters, so an
97
+ * increment, which changes only those, never makes them stale.
98
+ */
99
+ declare const createKvAdapter: ({ store, tablePrefix }: KvAdapterOptions) => DatabaseAdapter;
100
+ //#endregion
101
+ export { KeyValueStore, KvAdapterOptions, KvCondition, KvItem, KvKey, KvOp, KvRange, createKvAdapter, encodeKvKey };
@@ -0,0 +1,101 @@
1
+ import { DatabaseAdapter, DatabaseKeyValue, StoredRow, WriteResult } from "@hot-updater/plugin-core/internal";
2
+ //#region src/database/kv/kvAdapter.d.ts
3
+ /** An item's address: a partition, and a sort key within it. */
4
+ interface KvKey {
5
+ readonly pk: string;
6
+ readonly sk: string;
7
+ }
8
+ /** What an op requires of its item before the write: that it exists or not, or that its `_v` is `v`. */
9
+ type KvCondition = {
10
+ readonly exists: boolean;
11
+ } | {
12
+ readonly v: number;
13
+ };
14
+ type KvOp = {
15
+ readonly key: KvKey;
16
+ readonly condition?: KvCondition;
17
+ } & ({
18
+ readonly type: "put";
19
+ readonly value: StoredRow;
20
+ } | {
21
+ readonly type: "delete";
22
+ } | {
23
+ readonly type: "check";
24
+ } |
25
+ /** Adds to numeric attributes, creating the item from `init` when it is missing. */
26
+ {
27
+ readonly type: "add";
28
+ readonly by: Readonly<Record<string, number>>;
29
+ readonly init?: StoredRow;
30
+ });
31
+ /** Sort keys from `gte` up to `lt` in one partition, resuming past `after`. */
32
+ interface KvRange {
33
+ readonly pk: string;
34
+ readonly gte?: string;
35
+ readonly lt?: string;
36
+ /**
37
+ * `lt` as an inclusive bound, with `lt`: every key the helper writes is
38
+ * below `lt` exactly when it is at most `lte`. A store whose two-sided
39
+ * range is inclusive (DynamoDB's `BETWEEN`) uses it to read nothing past
40
+ * the range.
41
+ */
42
+ readonly lte?: string;
43
+ readonly order: "asc" | "desc";
44
+ readonly limit: number;
45
+ readonly after?: string;
46
+ }
47
+ interface KvItem {
48
+ readonly sk: string;
49
+ readonly value: StoredRow;
50
+ }
51
+ /**
52
+ * A key-value backend (DynamoDB, Firestore): strongly consistent point
53
+ * reads, one partition's sort-key range per page, and atomic writes whose
54
+ * conditions all see the state before the write. Sort keys compare as UTF-8.
55
+ */
56
+ interface KeyValueStore {
57
+ readonly id: string;
58
+ /**
59
+ * The most items, and bytes, one atomic write takes; `itemBytes` caps each
60
+ * item, and `keyBytes` the partition and sort keys the store indexes whole.
61
+ */
62
+ readonly limits: {
63
+ readonly items: number;
64
+ readonly bytes: number;
65
+ readonly itemBytes?: number;
66
+ readonly keyBytes?: {
67
+ readonly pk: number;
68
+ readonly sk: number;
69
+ };
70
+ };
71
+ get(keys: readonly KvKey[]): Promise<readonly (StoredRow | null)[]>;
72
+ /** One native page; `more` when the range may go on past it. An empty page ends the range. */
73
+ query(range: KvRange): Promise<{
74
+ readonly items: readonly KvItem[];
75
+ readonly more: boolean;
76
+ }>;
77
+ /** Applies every op or none; `failedOp` names an op whose condition failed. */
78
+ write(ops: readonly KvOp[]): Promise<WriteResult>;
79
+ /** Prepares the store, such as its one table, for `db migrate`. */
80
+ readonly migrations?: {
81
+ apply(): Promise<void>;
82
+ };
83
+ dispose?(): Promise<void>;
84
+ }
85
+ /** Order-preserving text for key values; each value ends in the lowest code point any encoding uses. */
86
+ declare const encodeKvKey: (values: readonly DatabaseKeyValue[]) => string;
87
+ interface KvAdapterOptions {
88
+ readonly store: KeyValueStore;
89
+ readonly tablePrefix?: string;
90
+ }
91
+ /**
92
+ * The storage adapter over a key-value store. A row is one item at
93
+ * `pk = <table>`, `sk = enc(key)`; each index not in key order adds an item
94
+ * per entry at `pk = <table>#<index>#enc(eq)`, `sk = enc(order)`, and each
95
+ * unique entry one item at `sk = "#"`, written only where no other row holds
96
+ * it. Index items hold a copy of the row without `_v` or counters, so an
97
+ * increment, which changes only those, never makes them stale.
98
+ */
99
+ declare const createKvAdapter: ({ store, tablePrefix }: KvAdapterOptions) => DatabaseAdapter;
100
+ //#endregion
101
+ export { KeyValueStore, KvAdapterOptions, KvCondition, KvItem, KvKey, KvOp, KvRange, createKvAdapter, encodeKvKey };
@@ -0,0 +1,272 @@
1
+ import { DATABASE_VERSION_COLUMN, DatabaseAdapterContractError, canonicalJson, compareUtf8, findPhysicalIndex, indexEntries, indexOrderColumns, indexOrderTuple, matchesQuery, rowKey } from "@hot-updater/plugin-core/internal";
2
+ //#region src/database/kv/kvAdapter.ts
3
+ const SEPARATOR = "";
4
+ /** Order-preserving text for key values; each value ends in the lowest code point any encoding uses. */
5
+ const encodeKvKey = (values) => values.map((value) => {
6
+ if (typeof value === "boolean") return `${Number(value)}${SEPARATOR}`;
7
+ if (typeof value === "number") {
8
+ const view = /* @__PURE__ */ new DataView(/* @__PURE__ */ new ArrayBuffer(8));
9
+ view.setFloat64(0, value === 0 ? 0 : value);
10
+ const mask = view.getUint32(0) >>> 31 ? [-1, -1] : [1 << 31, 0];
11
+ return `${[0, 4].map((at, word) => ((view.getUint32(at) ^ mask[word]) >>> 0).toString(16).padStart(8, "0")).join("")}${SEPARATOR}`;
12
+ }
13
+ let text = "";
14
+ for (const char of value) text += char < "" ? `\u0002${String.fromCharCode(char.charCodeAt(0) + 1)}` : char;
15
+ return `${text}${SEPARATOR}`;
16
+ }).join("");
17
+ /** The first sort key after every key that starts with `prefix`. */
18
+ const pastPrefix = (prefix) => `${prefix.slice(0, -1)}\u0002`;
19
+ /** A unique item's sort key, and an index item's when its order is empty. */
20
+ const ONLY = "#";
21
+ /** An index whose eq and order columns are the key, in order, reads the row items. */
22
+ const inKeyOrder = (table, index) => {
23
+ const columns = [...index.eq, ...indexOrderColumns(table, index)];
24
+ return !index.unique && columns.length === table.key.length && columns.every((column, position) => column === table.key[position]);
25
+ };
26
+ const same = (left, right, columns) => columns.every((name) => canonicalJson(left[name]) === canonicalJson(right[name]));
27
+ /**
28
+ * The storage adapter over a key-value store. A row is one item at
29
+ * `pk = <table>`, `sk = enc(key)`; each index not in key order adds an item
30
+ * per entry at `pk = <table>#<index>#enc(eq)`, `sk = enc(order)`, and each
31
+ * unique entry one item at `sk = "#"`, written only where no other row holds
32
+ * it. Index items hold a copy of the row without `_v` or counters, so an
33
+ * increment, which changes only those, never makes them stale.
34
+ */
35
+ const createKvAdapter = ({ store, tablePrefix = "" }) => {
36
+ const layouts = /* @__PURE__ */ new WeakMap();
37
+ const layoutOf = (table) => {
38
+ const known = layouts.get(table);
39
+ if (known) return known;
40
+ const counters = table.columns.filter((column) => column.default !== void 0 && column.name !== DATABASE_VERSION_COLUMN).map((column) => column.name);
41
+ const layout = {
42
+ table,
43
+ rows: tablePrefix + table.name,
44
+ copied: table.columns.map((column) => column.name).filter((name) => name !== DATABASE_VERSION_COLUMN && !counters.includes(name)),
45
+ counters,
46
+ indexed: table.indexes.filter((index) => !inKeyOrder(table, index))
47
+ };
48
+ layouts.set(table, layout);
49
+ return layout;
50
+ };
51
+ const rowItem = (layout, key) => ({
52
+ pk: layout.rows,
53
+ sk: encodeKvKey(key)
54
+ });
55
+ const partition = (layout, index, eq) => `${layout.rows}#${index.name}#${encodeKvKey(eq)}`;
56
+ const copyOf = (layout, row) => Object.fromEntries(layout.copied.map((name) => [name, row[name] ?? null]));
57
+ /** Every index and unique item a row has, by address. */
58
+ const itemsOf = (layout, row) => {
59
+ const items = /* @__PURE__ */ new Map();
60
+ for (const index of row === null ? [] : layout.indexed) for (const eq of indexEntries(layout.table, index, row)) {
61
+ const pk = partition(layout, index, eq);
62
+ const sk = index.unique ? ONLY : encodeKvKey(indexOrderTuple(layout.table, index, row)) || ONLY;
63
+ items.set(JSON.stringify([pk, sk]), {
64
+ key: {
65
+ pk,
66
+ sk
67
+ },
68
+ unique: index.unique === true
69
+ });
70
+ }
71
+ return items;
72
+ };
73
+ /** Moves a row's index items from `before` to `after`; a unique entry is taken only where no row holds it. */
74
+ const indexOps = (layout, before, after) => {
75
+ const old = itemsOf(layout, before);
76
+ const next = itemsOf(layout, after);
77
+ const ops = [...old].filter(([id]) => !next.has(id)).map(([, item]) => ({
78
+ type: "delete",
79
+ key: item.key
80
+ }));
81
+ const copy = after && copyOf(layout, after);
82
+ const unchanged = before !== null && copy !== null && same(before, copy, layout.copied);
83
+ for (const [id, item] of next) {
84
+ if (old.has(id) && unchanged) continue;
85
+ const taken = item.unique && !old.has(id);
86
+ ops.push({
87
+ type: "put",
88
+ key: item.key,
89
+ value: copy,
90
+ condition: taken ? { exists: false } : void 0
91
+ });
92
+ }
93
+ return ops;
94
+ };
95
+ /** The item ops of one adapter op: its row item first, then its index items. */
96
+ const plan = (op) => {
97
+ const layout = layoutOf(op.table);
98
+ const key = rowItem(layout, op.type === "insert" ? rowKey(op.table, op.row) : op.key);
99
+ const guard = op.type === "insert" ? { exists: false } : op.guard;
100
+ const condition = guard && ("v" in guard ? { v: guard.v } : guard);
101
+ switch (op.type) {
102
+ case "check": return [{
103
+ type: "check",
104
+ key,
105
+ condition
106
+ }];
107
+ case "increment":
108
+ if (layout.indexed.length > 0 && (op.init !== void 0 || Object.keys(op.by).some((name) => layout.copied.includes(name)))) throw new DatabaseAdapterContractError(`${op.table.name} has index copies: an increment may change only counters of an existing row.`);
109
+ return [{
110
+ type: "add",
111
+ key,
112
+ by: {
113
+ ...op.by,
114
+ [DATABASE_VERSION_COLUMN]: 1
115
+ },
116
+ init: op.init,
117
+ condition: condition ?? (op.init ? void 0 : { exists: true })
118
+ }];
119
+ case "delete": return [{
120
+ type: "delete",
121
+ key,
122
+ condition
123
+ }, ...indexOps(layout, op.previous, null)];
124
+ default: {
125
+ const before = op.type === "insert" ? null : op.previous;
126
+ const row = op.type === "insert" ? op.row : {
127
+ ...op.previous,
128
+ ...op.set,
129
+ [DATABASE_VERSION_COLUMN]: op.guard.v + 1
130
+ };
131
+ return [{
132
+ type: "put",
133
+ key,
134
+ value: row,
135
+ condition
136
+ }, ...indexOps(layout, before, row)];
137
+ }
138
+ }
139
+ };
140
+ /**
141
+ * One op per item. Only unique items of two rows can meet: one op frees
142
+ * the value and another takes it. That becomes one unconditional put, as
143
+ * the freeing op's guard already holds the value's owner. Two rows taking
144
+ * one value fail at the later op.
145
+ */
146
+ const compile = (ops) => {
147
+ const items = /* @__PURE__ */ new Map();
148
+ for (const [origin, op] of ops.entries()) for (const kv of plan(op)) {
149
+ const id = JSON.stringify([kv.key.pk, kv.key.sk]);
150
+ const earlier = items.get(id);
151
+ const put = [earlier, {
152
+ op: kv,
153
+ origin
154
+ }].find((planned) => planned?.op.type === "put");
155
+ if (earlier === void 0) items.set(id, {
156
+ op: kv,
157
+ origin
158
+ });
159
+ else if (put?.op.type === "put" && [earlier.op, kv].some(({ type }) => type === "delete")) items.set(id, {
160
+ op: {
161
+ ...put.op,
162
+ condition: void 0
163
+ },
164
+ origin
165
+ });
166
+ else return { failedOp: origin };
167
+ }
168
+ return { items: [...items.values()] };
169
+ };
170
+ const encoder = new TextEncoder();
171
+ const sizeOf = ({ op }) => encoder.encode(op.key.pk + op.key.sk + JSON.stringify(op.type === "put" ? op.value : op.type === "add" ? op.init : null)).length;
172
+ /** Fills counters from the rows; a row that still equals its copy is returned whole, `_v` included. */
173
+ const complete = async (layout, copies) => {
174
+ if (layout.counters.length === 0 || copies.length === 0) return copies;
175
+ const rows = await store.get(copies.map((copy) => rowItem(layout, rowKey(layout.table, copy))));
176
+ return copies.map((copy, at) => {
177
+ const row = rows[at];
178
+ if (row && same(row, copy, layout.copied)) return row;
179
+ const counters = layout.counters.map((name) => [name, row?.[name] ?? 0]);
180
+ return {
181
+ ...copy,
182
+ ...Object.fromEntries(counters)
183
+ };
184
+ });
185
+ };
186
+ /**
187
+ * A request's sort keys within its partition, from `gte` up to `lt`; null
188
+ * when none can match. Every encoding ends in the separator, so the keys
189
+ * that start with a prefix end right before `pastPrefix` of it.
190
+ */
191
+ const rangeOf = (prefix, request) => {
192
+ const edge = (bound, lower) => {
193
+ if (bound === void 0) return prefix === "" ? void 0 : lower ? prefix : pastPrefix(prefix);
194
+ const text = prefix + encodeKvKey(bound.values);
195
+ if (text === "") return bound.inclusive ? void 0 : null;
196
+ return lower === bound.inclusive ? text : pastPrefix(text);
197
+ };
198
+ const gte = edge(request.lower, true);
199
+ const lt = edge(request.upper, false);
200
+ if (gte === null || lt === null) return null;
201
+ if (gte !== void 0 && lt !== void 0 && compareUtf8(gte, lt) >= 0) return null;
202
+ if (lt === void 0) return {
203
+ gte,
204
+ lt
205
+ };
206
+ return {
207
+ gte,
208
+ lt,
209
+ lte: lt.endsWith(SEPARATOR) ? lt.slice(0, -1) : lt
210
+ };
211
+ };
212
+ return {
213
+ id: store.id,
214
+ fits(ops) {
215
+ const { items } = compile(ops);
216
+ if (items === void 0) return true;
217
+ const { items: most, bytes, itemBytes = bytes, keyBytes } = store.limits;
218
+ const sizes = items.map(sizeOf);
219
+ const length = (text) => encoder.encode(text).length;
220
+ return items.length <= most && sizes.reduce((sum, size) => sum + size, 0) <= bytes && sizes.every((size) => size <= itemBytes) && (keyBytes === void 0 || items.every(({ op }) => length(op.key.pk) <= keyBytes.pk && length(op.key.sk) <= keyBytes.sk));
221
+ },
222
+ get: (table, keys) => store.get(keys.map((key) => rowItem(layoutOf(table), key))),
223
+ async query(table, request) {
224
+ const layout = layoutOf(table);
225
+ const index = findPhysicalIndex(table, request.index);
226
+ if (index.unique) {
227
+ const key = {
228
+ pk: partition(layout, index, request.eq),
229
+ sk: ONLY
230
+ };
231
+ const [copy] = await store.get([key]);
232
+ const found = copy && matchesQuery(table, index, request, copy);
233
+ return complete(layout, found ? [copy] : []);
234
+ }
235
+ const own = inKeyOrder(table, index);
236
+ const range = rangeOf(own ? encodeKvKey(request.eq) : "", request);
237
+ if (range === null) return [];
238
+ const pk = own ? layout.rows : partition(layout, index, request.eq);
239
+ const rows = [];
240
+ let after;
241
+ while (rows.length < request.limit) {
242
+ const { items, more } = await store.query({
243
+ pk,
244
+ ...range,
245
+ order: request.order,
246
+ limit: request.limit - rows.length,
247
+ after
248
+ });
249
+ rows.push(...items.map((item) => item.value));
250
+ if (!more || items.length === 0) break;
251
+ after = items.at(-1).sk;
252
+ }
253
+ return own ? rows : complete(layout, rows);
254
+ },
255
+ async write(ops) {
256
+ const { items, failedOp } = compile(ops);
257
+ if (items === void 0) return {
258
+ ok: false,
259
+ failedOp
260
+ };
261
+ const result = await store.write(items.map(({ op }) => op));
262
+ return !result.ok && "failedOp" in result ? {
263
+ ok: false,
264
+ failedOp: items[result.failedOp].origin
265
+ } : result;
266
+ },
267
+ migrations: { apply: async () => store.migrations?.apply() },
268
+ ...store.dispose === void 0 ? {} : { dispose: () => store.dispose() }
269
+ };
270
+ };
271
+ //#endregion
272
+ export { createKvAdapter, encodeKvKey };
@@ -0,0 +1,196 @@
1
+ let _hot_updater_plugin_core_internal = require("@hot-updater/plugin-core/internal");
2
+ //#region src/database/resolveSchema.ts
3
+ const SHARD_COLUMN = "_shard";
4
+ const MAX_SHARDS = 64;
5
+ const NAME = /^[a-z][a-z0-9_]*$/u;
6
+ const INDEX_NAME = /^[A-Za-z][A-Za-z0-9_]*$/u;
7
+ const tableName = (module, model) => module.namespace ? `${module.namespace}_${model}` : model;
8
+ const integer = (name, defaulted = false) => ({
9
+ name,
10
+ type: "integer",
11
+ nullable: false,
12
+ ...defaulted ? { default: 0 } : {}
13
+ });
14
+ /** A declared or derived field's type, and whether it holds several values. */
15
+ const fieldType = (model, name) => {
16
+ const field = model.fields[name] ?? (model.kind === "table" ? model.derived[name] : void 0);
17
+ return field && {
18
+ type: field.type,
19
+ multi: "multi" in field && !!field.multi
20
+ };
21
+ };
22
+ const metricsOf = (model) => [
23
+ ...model.counters,
24
+ ...model.gauges,
25
+ ...model.distinct
26
+ ];
27
+ /** Field names, the key, and each field's options. */
28
+ const fieldProblems = (definition, add) => {
29
+ const names = [...Object.keys(definition.fields), ...definition.kind === "table" ? Object.keys(definition.derived) : metricsOf(definition)];
30
+ for (const name of new Set(names)) {
31
+ if (!NAME.test(name)) add(`field "${name}" must match ${NAME.source}`);
32
+ if (names.indexOf(name) !== names.lastIndexOf(name)) add(`field "${name}" is declared twice`);
33
+ }
34
+ const { key } = definition;
35
+ if (key.length === 0) add("key is empty");
36
+ if (new Set(key).size !== key.length) add("key repeats a field");
37
+ for (const name of key) {
38
+ const field = definition.fields[name];
39
+ if (field === void 0) add(`key field "${name}" is not a declared field`);
40
+ else if (field.required === false) add(`key field "${name}" is nullable`);
41
+ else if (field.type === "json") add(`key field "${name}" is json`);
42
+ }
43
+ for (const [name, { type, maxLength, ascii }] of Object.entries(definition.fields)) {
44
+ if (maxLength !== void 0 && (type !== "string" || !Number.isSafeInteger(maxLength) || maxLength < 1)) add(`field "${name}" has an invalid maxLength`);
45
+ if (ascii && type !== "string") add(`field "${name}" is ascii but not a string`);
46
+ }
47
+ };
48
+ /** A table's derived fields and references. */
49
+ const tableProblems = (definition, add, table) => {
50
+ for (const [name, derived] of Object.entries(definition.derived)) {
51
+ if (typeof derived.compute !== "function") add(`derived field "${name}" has no compute function`);
52
+ if (derived.multi && derived.type === "json") add(`derived field "${name}" cannot be multi-valued json`);
53
+ }
54
+ for (const [name, { type, references }] of Object.entries(definition.fields)) {
55
+ if (references === void 0) continue;
56
+ const target = table(references.model);
57
+ const targetKey = target?.key.length === 1 ? target.fields[target.key[0]] : void 0;
58
+ if (targetKey === void 0) add(`field "${name}" references "${references.model}", which is not a single-key table of this module`);
59
+ else if (targetKey.type !== type) add(`field "${name}" and the key of "${references.model}" differ in type`);
60
+ if (references.onDelete === "cascade" && !Object.values(definition.indexes).some(({ eq }) => eq.length === 1 && eq[0] === name)) add(`cascade on "${name}" needs an index whose eq is exactly [${name}]`);
61
+ }
62
+ };
63
+ /** An aggregate's identity, metrics, and shards. */
64
+ const aggregateProblems = (definition, add) => {
65
+ const identity = Object.keys(definition.fields);
66
+ if (definition.key.join("\0") !== identity.join("\0")) add(`key must list the identity fields in declaration order: ${identity.join(", ")}`);
67
+ if (metricsOf(definition).length === 0) add("aggregate has no metrics");
68
+ if (definition.distinct.length > 0 && definition.counters.length + definition.gauges.length > 0) add("distinct sketches need an aggregate of their own");
69
+ const { shards } = definition;
70
+ if (!Number.isSafeInteger(shards) || shards < 1 || shards > 64) add(`shards must be 1–64`);
71
+ };
72
+ /** Every problem in one model's declaration, its roots and references included. */
73
+ const problemsOf = (module, model, definition) => {
74
+ const problems = [];
75
+ const add = (message) => problems.push(`${module.id}.${model}: ${message}`);
76
+ const table = (name) => {
77
+ const target = module.schema[name];
78
+ return target?.kind === "table" ? target : void 0;
79
+ };
80
+ if (!NAME.test(model)) add("model names use lowercase letters, digits, and _");
81
+ fieldProblems(definition, add);
82
+ for (const [name, index] of Object.entries(definition.indexes)) {
83
+ const columns = [...index.eq, ...index.sort];
84
+ if (!INDEX_NAME.test(name)) add(`index "${name}" must match ${INDEX_NAME.source}`);
85
+ if (columns.length === 0) add(`index "${name}" has no fields`);
86
+ if (index.unique && index.sort.length > 0) add(`unique index "${name}" cannot sort`);
87
+ if (columns.filter((column) => {
88
+ const type = fieldType(definition, column);
89
+ if (type === void 0) add(`index "${name}" names undeclared field "${column}"`);
90
+ else if (type.type === "json") add(`index "${name}" names json field "${column}"`);
91
+ else if (type.multi && index.sort.includes(column)) add(`index "${name}" sorts by multi-valued field "${column}"`);
92
+ return type?.type !== "json" && type?.multi;
93
+ }).length > 1) add(`index "${name}" has more than one multi-valued field`);
94
+ if (index.root === void 0) continue;
95
+ const root = table(index.root.model);
96
+ if (root === void 0) add(`index "${name}" is rooted at unknown table "${index.root.model}"`);
97
+ else if (root.key.length > index.eq.length || root.key.some((field, position) => fieldType(definition, index.eq[position])?.type !== root.fields[field].type)) add(`index "${name}" eq must start with the key of "${index.root.model}"`);
98
+ }
99
+ if (definition.kind === "table") tableProblems(definition, add, table);
100
+ else aggregateProblems(definition, add);
101
+ return problems;
102
+ };
103
+ /** Rejects invalid module schemas at startup, listing every problem. */
104
+ const validateSchema = (modules) => {
105
+ const problems = [];
106
+ const owners = /* @__PURE__ */ new Map();
107
+ for (const module of modules) for (const [model, definition] of Object.entries(module.schema)) {
108
+ const name = tableName(module, model);
109
+ const owner = owners.get(name);
110
+ if (owner !== void 0) problems.push(`${module.id}.${model}: table "${name}" is also declared by ${owner}`);
111
+ owners.set(name, `${module.id}.${model}`);
112
+ problems.push(...problemsOf(module, model, definition));
113
+ }
114
+ if (problems.length > 0) throw new _hot_updater_plugin_core_internal.DatabaseSchemaError(`Invalid database schema:\n- ${problems.join("\n- ")}`);
115
+ };
116
+ const indexesOf = (definition) => [...Object.entries(definition.indexes).map(([name, index]) => ({
117
+ name,
118
+ eq: [...index.eq],
119
+ sort: [...index.sort],
120
+ ...index.unique ? { unique: true } : {}
121
+ })), ...Object.entries(definition.fields).flatMap(([name, field]) => field.unique ? [{
122
+ name,
123
+ eq: [name],
124
+ sort: [],
125
+ unique: true
126
+ }] : [])];
127
+ /** Validates the modules, then resolves them into physical tables with engine columns. */
128
+ const resolveSchema = (modules) => {
129
+ validateSchema(modules);
130
+ const references = [];
131
+ for (const module of modules) for (const [model, definition] of Object.entries(module.schema)) {
132
+ if (definition.kind !== "table") continue;
133
+ const table = tableName(module, model);
134
+ for (const [field, { references: to }] of Object.entries(definition.fields)) {
135
+ if (to === void 0) continue;
136
+ const { onDelete } = to;
137
+ const target = tableName(module, to.model);
138
+ const counter = onDelete === "none" ? {} : { counter: `_refs_${table}_${field}` };
139
+ references.push({
140
+ table,
141
+ field,
142
+ target,
143
+ onDelete,
144
+ ...counter
145
+ });
146
+ }
147
+ }
148
+ const models = /* @__PURE__ */ new Map();
149
+ for (const module of modules) for (const [model, definition] of Object.entries(module.schema)) {
150
+ const name = tableName(module, model);
151
+ const referencedBy = references.filter(({ target }) => target === name);
152
+ const columns = Object.entries(definition.fields).map(([field, { type, required, maxLength, ascii }]) => ({
153
+ name: field,
154
+ type,
155
+ nullable: required === false,
156
+ ...maxLength === void 0 ? {} : { maxLength },
157
+ ...ascii ? { ascii } : {}
158
+ }));
159
+ if (definition.kind === "table") for (const [field, { type, multi }] of Object.entries(definition.derived)) columns.push({
160
+ name: field,
161
+ type,
162
+ nullable: true,
163
+ ...multi ? { multi } : {}
164
+ });
165
+ else columns.push(integer(SHARD_COLUMN), ...[...definition.counters, ...definition.gauges].map((metric) => integer(metric)), ...definition.distinct.map((metric) => ({
166
+ name: metric,
167
+ type: "string",
168
+ nullable: true
169
+ })));
170
+ for (const { counter } of referencedBy) if (counter !== void 0) columns.push(integer(counter, true));
171
+ columns.push(integer(_hot_updater_plugin_core_internal.DATABASE_VERSION_COLUMN, true));
172
+ models.set(name, {
173
+ module: module.id,
174
+ model,
175
+ definition,
176
+ table: {
177
+ name,
178
+ columns,
179
+ key: definition.kind === "aggregate" ? [...definition.key, SHARD_COLUMN] : [...definition.key],
180
+ indexes: indexesOf(definition)
181
+ },
182
+ references: references.filter(({ table }) => table === name),
183
+ referencedBy,
184
+ roots: new Map(Object.entries(definition.indexes).flatMap(([index, { root }]) => root === void 0 ? [] : [[index, tableName(module, root.model)]]))
185
+ });
186
+ }
187
+ return {
188
+ models,
189
+ tables: [...models.values()].map(({ table }) => table)
190
+ };
191
+ };
192
+ //#endregion
193
+ exports.MAX_SHARDS = MAX_SHARDS;
194
+ exports.SHARD_COLUMN = SHARD_COLUMN;
195
+ exports.resolveSchema = resolveSchema;
196
+ exports.validateSchema = validateSchema;