@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
@@ -2,111 +2,164 @@ import {
2
2
  assertStorageOperations,
3
3
  type StoragePlugin,
4
4
  } from "@hot-updater/plugin-core";
5
+ import type { DatabaseAdapter } from "@hot-updater/plugin-core/internal";
5
6
 
6
7
  import {
7
- authenticateApiKey,
8
- createApiKeyManagement,
9
- normalizeApiKeyHeaderName,
10
- } from "./apiKeys";
11
- import type { ApiKeyManagementAPI } from "./apiKeys";
12
- import { createDatabasePluginCore } from "./db/databasePluginCore";
13
- import { createSchemaReadinessChecker } from "./db/schemaReadiness";
8
+ assemblePlugins,
9
+ HotUpdaterConfigError,
10
+ } from "./assembly/assemblePlugins";
11
+ import type { CoreApi } from "./core/api";
12
+ import { toolingTargetOf } from "./db/builtInDatabase";
13
+ import type { ToolingDatabase, ToolingTarget } from "./db/types";
14
14
  import {
15
- type DatabaseAdapterCapabilities,
16
- type DatabaseAPI,
17
- type DatabasePlugin,
18
- isDatabasePlugin,
19
- } from "./db/types";
20
- import { createHotUpdaterHandlers, type HotUpdaterHandlers } from "./handler";
21
- import { createInsightsProvider } from "./insights/bounded/provider";
22
- import type { InsightsProvider } from "./insights/types";
15
+ type ClientRoutePolicy,
16
+ createHotUpdaterHandlers,
17
+ type HotUpdaterHandlers,
18
+ } from "./handler";
19
+ import type { AnyHotUpdaterPlugin, PluginApis } from "./plugins/definePlugin";
23
20
  import { createStorageAccess } from "./storageAccess";
24
21
 
25
- export type RuntimeHotUpdaterAPI = DatabaseAPI & {
22
+ export type RuntimeHotUpdaterAPI<
23
+ TPlugins extends readonly AnyHotUpdaterPlugin[] =
24
+ readonly AnyHotUpdaterPlugin[],
25
+ > = {
26
26
  readonly handlers: HotUpdaterHandlers;
27
+ /** Core's reads and typed writes: bundles, Releases, Catalogs, and channels. */
28
+ readonly core: CoreApi;
29
+ /** Each plugin's API by plugin id. */
30
+ readonly api: PluginApis<TPlugins>;
31
+ /** The database's name, which `hot-updater db` commands read. */
27
32
  readonly adapterName: string;
28
- /**
29
- * Built-in Insights provider. Client ingestion and admin query routes are
30
- * always mounted; React Native clients report lifecycle events by default
31
- * and can opt out with `HotUpdater.init({ insights: false })`.
32
- */
33
- readonly insights: InsightsProvider;
34
- /**
35
- * In-process API key lifecycle operations for trusted server tooling.
36
- * Creation returns the plaintext once; list and revoke expose only metadata.
37
- * This capability is never mounted on the client or admin HTTP handlers.
38
- */
39
- readonly apiKeys: ApiKeyManagementAPI;
40
33
  };
41
34
 
42
35
  export type HotUpdaterAPI = RuntimeHotUpdaterAPI;
43
36
 
37
+ const REMOVED_CLIENT_ACCESS =
38
+ 'clientAccess objects were removed in 1.0: set clientAccess: "public", or add apiKeys() from @hot-updater/server/plugins/api-keys to plugins';
39
+
40
+ /**
41
+ * A `clientAccess` object from before 1.0. Its `type` names the fix, so
42
+ * TypeScript reports it where the object is written.
43
+ */
44
+ export interface RemovedClientAccess {
45
+ readonly type: typeof REMOVED_CLIENT_ACCESS;
46
+ readonly headerName?: string;
47
+ }
48
+
44
49
  export type ClientAccessPolicy =
45
- | {
46
- /**
47
- * Leaves Release Catalog, artifact, and Insights ingestion routes
48
- * publicly accessible without a client credential.
49
- */
50
- readonly type: "public";
51
- }
52
- | {
53
- /**
54
- * Requires a key registered in `database.models.apiKeys` for
55
- * Release Catalog, artifact, and Insights ingestion requests.
56
- */
57
- readonly type: "api-key";
58
- /**
59
- * Request header containing the API key. Defaults to
60
- * `x-api-key`. Clients must send the same header; Release Catalog
61
- * responses include it in `Vary` to preserve cache isolation.
62
- */
63
- readonly headerName?: string;
64
- };
65
-
66
- export interface CreateHotUpdaterOptions {
67
- readonly database: DatabasePlugin;
68
- /**
69
- * Required client-route access policy. This choice is explicit so a server
70
- * cannot accidentally change between public and authenticated OTA access.
71
- * `/version`, storage downloads, and admin-handler routes are unaffected.
72
- */
73
- readonly clientAccess: ClientAccessPolicy;
50
+ /** Leaves client routes public; required when no plugin provides clientAuth. */
51
+ "public" | RemovedClientAccess;
52
+
53
+ type ProvidesClientAuth<TPlugin> = TPlugin extends {
54
+ readonly provides?: infer TProvides;
55
+ }
56
+ ? TProvides extends { readonly clientAuth: true }
57
+ ? true
58
+ : false
59
+ : false;
60
+
61
+ type ClientAuthIds<
62
+ TPlugins extends readonly unknown[],
63
+ TFound extends string[] = [],
64
+ > = TPlugins extends readonly [infer THead, ...infer TTail]
65
+ ? ClientAuthIds<
66
+ TTail,
67
+ ProvidesClientAuth<THead> extends true
68
+ ? [
69
+ ...TFound,
70
+ THead extends { readonly id: infer TId extends string }
71
+ ? TId
72
+ : string,
73
+ ]
74
+ : TFound
75
+ >
76
+ : TFound;
77
+
78
+ type JoinIds<TIds extends string[]> = TIds extends [
79
+ infer TFirst extends string,
80
+ ...infer TRest extends string[],
81
+ ]
82
+ ? TRest extends []
83
+ ? `"${TFirst}"`
84
+ : `"${TFirst}", ${JoinIds<TRest>}`
85
+ : "";
86
+
87
+ /**
88
+ * Client routes have one policy source: exactly one plugin that provides
89
+ * clientAuth, or an explicit `clientAccess`. Tuples are counted here; an
90
+ * untyped list that may hold a clientAuth plugin is left to startup.
91
+ */
92
+ export type ClientAccessRule<TPlugins extends readonly AnyHotUpdaterPlugin[]> =
93
+ number extends TPlugins["length"]
94
+ ? true extends ProvidesClientAuth<TPlugins[number]>
95
+ ? {
96
+ readonly clientAccess?: "Remove clientAccess: a plugin in this list may provide clientAuth";
97
+ }
98
+ : { readonly clientAccess: ClientAccessPolicy }
99
+ : ClientAuthIds<TPlugins> extends []
100
+ ? { readonly clientAccess: ClientAccessPolicy }
101
+ : ClientAuthIds<TPlugins> extends [infer TId extends string]
102
+ ? {
103
+ readonly clientAccess?: `Remove clientAccess: plugin "${TId}" provides clientAuth`;
104
+ }
105
+ : {
106
+ readonly clientAuth: `Keep one clientAuth plugin: ${JoinIds<ClientAuthIds<TPlugins>>} all provide it`;
107
+ };
108
+
109
+ export type CreateHotUpdaterOptions<
110
+ TPlugins extends readonly AnyHotUpdaterPlugin[] = readonly [],
111
+ > = {
112
+ /** A provider's database on the storage engine, such as `kyselyAdapter(...)` or `postgres(...)`. */
113
+ readonly database: ToolingDatabase;
74
114
  /** Storage implementations used to read provider-specific storage URIs. */
75
115
  readonly storage?: readonly StoragePlugin[];
76
- }
116
+ /** Built-in and third-party plugins; at most one provides clientAuth. Defaults to none. */
117
+ readonly plugins?: TPlugins;
118
+ } & ClientAccessRule<TPlugins>;
77
119
 
78
- const normalizeClientAccess = (
79
- value: unknown,
80
- ):
81
- | { readonly type: "public" }
82
- | {
83
- readonly type: "api-key";
84
- readonly headerName: string;
85
- } => {
86
- if (value === null || typeof value !== "object" || Array.isArray(value)) {
87
- throw new TypeError("clientAccess must be an object.");
88
- }
89
- const policy = value as {
90
- readonly headerName?: unknown;
91
- readonly type?: unknown;
92
- };
93
- if (policy.type === "public") return { type: "public" };
94
- if (policy.type === "api-key") {
95
- return {
96
- headerName: normalizeApiKeyHeaderName(policy.headerName),
97
- type: "api-key",
98
- };
120
+ const isRecord = (value: unknown): value is Record<string, unknown> =>
121
+ typeof value === "object" && value !== null;
122
+
123
+ const isAdapter = (value: unknown): value is DatabaseAdapter =>
124
+ isRecord(value) &&
125
+ ["fits", "get", "query", "write"].every(
126
+ (method) => typeof value[method] === "function",
127
+ );
128
+
129
+ /** The configured database, when it runs on the storage engine. */
130
+ const databaseOf = (value: unknown): ToolingDatabase => {
131
+ if (isRecord(value) && typeof value.name === "string") {
132
+ if (isAdapter(value.adapter)) return value as unknown as ToolingDatabase;
133
+ if ("core" in value && "fetchAdmin" in value) {
134
+ throw new HotUpdaterConfigError(
135
+ "standaloneRepository reaches a server's admin API from the CLI and console. createHotUpdater needs the server's own database, such as kyselyAdapter(...).",
136
+ );
137
+ }
99
138
  }
100
- throw new TypeError(
101
- 'clientAccess.type must be either "public" or "api-key".',
139
+ throw new HotUpdaterConfigError(
140
+ "database must be a Hot Updater 1.0 database, such as kyselyAdapter(...) or postgres(...). Upgrade the provider package that created it.",
102
141
  );
103
142
  };
104
143
 
105
- type DatabasePluginCore = {
106
- readonly api: DatabaseAPI;
107
- readonly adapterName: string;
108
- readonly createMigrator: () => never;
109
- readonly generateSchema: () => never;
144
+ /** A release candidate's config moving to 1.0 also needs `insights()`. */
145
+ const KEEP_INSIGHTS =
146
+ "To keep Insights, which the release candidates ran by default, add insights() from @hot-updater/server/plugins/insights to plugins.";
147
+
148
+ /** `"public"`, or nothing; a `clientAccess` object names what replaced it. */
149
+ const isPublic = (value: unknown): boolean => {
150
+ if (value === undefined) return false;
151
+ if (value === "public") return true;
152
+ if (isRecord(value)) {
153
+ const type = value.type;
154
+ throw new HotUpdaterConfigError(
155
+ type === "api-key"
156
+ ? `clientAccess: { type: "api-key" } was removed in 1.0. Remove it and add apiKeys(${value.headerName === undefined ? "" : `{ headerName: ${JSON.stringify(value.headerName)} }`}) from @hot-updater/server/plugins/api-keys to plugins, which protects client routes the same way. ${KEEP_INSIGHTS}`
157
+ : `clientAccess objects were removed in 1.0. Use clientAccess: "public", or add apiKeys() from @hot-updater/server/plugins/api-keys to plugins. ${KEEP_INSIGHTS}`,
158
+ );
159
+ }
160
+ throw new HotUpdaterConfigError(
161
+ 'clientAccess must be "public"; to protect client routes, add apiKeys() from @hot-updater/server/plugins/api-keys to plugins.',
162
+ );
110
163
  };
111
164
 
112
165
  export const hotUpdaterCoreMetadata = Symbol.for(
@@ -114,14 +167,10 @@ export const hotUpdaterCoreMetadata = Symbol.for(
114
167
  );
115
168
 
116
169
  export type HotUpdaterCoreMetadata = {
117
- readonly adapterCapabilities: DatabaseAdapterCapabilities;
118
- readonly core: DatabasePluginCore;
119
- };
120
-
121
- export type HotUpdaterCore = {
122
- readonly api: RuntimeHotUpdaterAPI;
123
- readonly adapterCapabilities: DatabaseAdapterCapabilities;
124
- readonly core: DatabasePluginCore;
170
+ /** The configured database, with the tooling `hot-updater db` runs. */
171
+ readonly database: ToolingDatabase;
172
+ /** The tables and settings rows that tooling creates for this server's plugins. */
173
+ readonly target: ToolingTarget;
125
174
  };
126
175
 
127
176
  export function getHotUpdaterCoreMetadata(
@@ -134,9 +183,11 @@ export function getHotUpdaterCoreMetadata(
134
183
  )[hotUpdaterCoreMetadata];
135
184
  }
136
185
 
137
- export function createHotUpdaterCore(
138
- options: CreateHotUpdaterOptions,
139
- ): HotUpdaterCore {
186
+ export function createHotUpdater<
187
+ const TPlugins extends readonly AnyHotUpdaterPlugin[] = readonly [],
188
+ >(
189
+ options: CreateHotUpdaterOptions<TPlugins>,
190
+ ): RuntimeHotUpdaterAPI<NoInfer<TPlugins>> {
140
191
  for (const key of ["authorityId", "catalogId"]) {
141
192
  if (Object.hasOwn(options, key)) {
142
193
  throw new TypeError(
@@ -144,89 +195,62 @@ export function createHotUpdaterCore(
144
195
  );
145
196
  }
146
197
  }
147
- const database = options.database;
198
+ const database = databaseOf(options.database);
148
199
  const storagePlugins = (options.storage ?? []).map((storage) => {
149
200
  assertStorageOperations(storage, ["get", "getDownloadUrl"]);
150
201
  return storage;
151
202
  });
152
203
  const { downloadStorageObject, readStorageText, resolveFileUrl } =
153
204
  createStorageAccess(storagePlugins);
154
- const adapterCapabilities: DatabaseAdapterCapabilities = database;
155
-
156
- if (!isDatabasePlugin(database)) {
157
- throw new Error("@hot-updater/server only supports database plugins.");
158
- }
159
-
160
- const plugin: DatabasePlugin = database;
161
- const adapterName = adapterCapabilities.adapterName ?? plugin.name;
162
- const assertSchemaReady = createSchemaReadinessChecker(
163
- adapterName,
164
- adapterCapabilities.createMigrator,
205
+ const publicClients = isPublic(
206
+ (options as { readonly clientAccess?: unknown }).clientAccess,
165
207
  );
166
- const core = createDatabasePluginCore(plugin, resolveFileUrl, {
167
- beforeOperation: assertSchemaReady,
168
- readStorageText,
169
- });
170
- const clientAccess = normalizeClientAccess(options.clientAccess);
171
- const insights = createInsightsProvider({
172
- async append(row) {
173
- await assertSchemaReady();
174
- return plugin.models.insights.append(row);
175
- },
176
- async scan(input) {
177
- await assertSchemaReady();
178
- return plugin.models.insights.scan(input);
179
- },
180
- });
181
- const apiKeys = createApiKeyManagement({
182
- apiKeys: plugin.models.apiKeys,
183
- beforeOperation: assertSchemaReady,
208
+ const plugins = assemblePlugins(options.plugins ?? [], database.adapter, {
209
+ storage: { readStorageText, resolveFileUrl },
210
+ ...(database.onCachedRoutesChange === undefined
211
+ ? {}
212
+ : { onCachedRoutesChange: () => database.onCachedRoutesChange!() }),
184
213
  });
185
-
186
- const handlers = createHotUpdaterHandlers(
187
- core.api,
188
- insights,
189
- clientAccess.type === "api-key"
190
- ? {
191
- authenticate: (request) =>
192
- authenticateApiKey({
193
- apiKeys: plugin.models.apiKeys,
194
- beforeLookup: assertSchemaReady,
195
- headerName: clientAccess.headerName,
196
- request,
197
- }),
198
- headerName: clientAccess.headerName,
199
- }
200
- : undefined,
214
+ const clientAuth = plugins.clientAuth;
215
+ if (clientAuth !== undefined && publicClients) {
216
+ throw new HotUpdaterConfigError(
217
+ `Plugin "${clientAuth.plugin}" provides clientAuth, so remove clientAccess.`,
218
+ );
219
+ }
220
+ if (clientAuth === undefined && !publicClients) {
221
+ throw new HotUpdaterConfigError(
222
+ 'Set clientAccess to "public", or add a plugin that provides clientAuth.',
223
+ );
224
+ }
225
+ const clientPolicy: ClientRoutePolicy | undefined =
226
+ clientAuth === undefined
227
+ ? undefined
228
+ : {
229
+ varyHeaders: clientAuth.varyHeaders.map((header) =>
230
+ header.toLowerCase(),
231
+ ),
232
+ authenticate: (request) => clientAuth.authenticate(request.headers),
233
+ };
234
+ const handlers = createHotUpdaterHandlers({
235
+ api: { core: plugins.core },
236
+ ...(clientPolicy === undefined ? {} : { clientPolicy }),
201
237
  downloadStorageObject,
202
- );
238
+ endpoints: plugins.endpoints,
239
+ plugins: Object.keys(plugins.api),
240
+ });
203
241
 
204
- const api: RuntimeHotUpdaterAPI = Object.assign(
205
- {
206
- adapterName: adapterCapabilities.adapterName ?? core.adapterName,
207
- insights,
208
- apiKeys,
209
- handlers,
210
- },
211
- core.api,
212
- );
242
+ const api = {
243
+ adapterName: database.name,
244
+ handlers,
245
+ core: plugins.core,
246
+ api: plugins.api as PluginApis<TPlugins>,
247
+ };
213
248
  Object.defineProperty(api, hotUpdaterCoreMetadata, {
214
249
  enumerable: false,
215
250
  value: {
216
- adapterCapabilities,
217
- core,
251
+ database,
252
+ target: toolingTargetOf(options.plugins ?? []),
218
253
  } satisfies HotUpdaterCoreMetadata,
219
254
  });
220
-
221
- return {
222
- api,
223
- adapterCapabilities,
224
- core,
225
- };
226
- }
227
-
228
- export function createHotUpdater(
229
- options: CreateHotUpdaterOptions,
230
- ): RuntimeHotUpdaterAPI {
231
- return createHotUpdaterCore(options).api;
255
+ return api;
232
256
  }
@@ -0,0 +1,65 @@
1
+ import {
2
+ type DatabaseKey,
3
+ isKeyValue,
4
+ } from "@hot-updater/plugin-core/internal";
5
+
6
+ export class DatabaseCursorError extends Error {
7
+ readonly name = "DatabaseCursorError";
8
+ }
9
+
10
+ const encoder = new TextEncoder();
11
+ const decoder = new TextDecoder();
12
+
13
+ const toBase64Url = (text: string): string => {
14
+ let binary = "";
15
+ for (const byte of encoder.encode(text)) binary += String.fromCharCode(byte);
16
+ return btoa(binary)
17
+ .replaceAll("+", "-")
18
+ .replaceAll("/", "_")
19
+ .replace(/=+$/u, "");
20
+ };
21
+
22
+ const fromBase64Url = (value: string): string => {
23
+ const binary = atob(value.replaceAll("-", "+").replaceAll("_", "/"));
24
+ return decoder.decode(Uint8Array.from(binary, (char) => char.charCodeAt(0)));
25
+ };
26
+
27
+ /** A stable 32-bit FNV-1a hash of the text's UTF-8 bytes. */
28
+ export const fnv1a = (text: string): number => {
29
+ let hash = 0x811c9dc5;
30
+ for (const byte of encoder.encode(text)) {
31
+ hash = Math.imul(hash ^ byte, 0x01000193) >>> 0;
32
+ }
33
+ return hash;
34
+ };
35
+
36
+ /** A hash of the request's identity; a cursor only resumes the same read. */
37
+ export const cursorScope = (parts: readonly unknown[]): string =>
38
+ fnv1a(JSON.stringify(parts)).toString(36);
39
+
40
+ export const encodeCursor = (scope: string, after: DatabaseKey): string =>
41
+ toBase64Url(JSON.stringify([scope, after]));
42
+
43
+ /** The order tuple a cursor resumes after; rejects a cursor from another read. */
44
+ export const decodeCursor = (scope: string, cursor: string): DatabaseKey => {
45
+ let decoded: unknown;
46
+ try {
47
+ decoded = JSON.parse(fromBase64Url(cursor));
48
+ } catch {
49
+ decoded = undefined;
50
+ }
51
+ const [from, after] = Array.isArray(decoded) ? decoded : [];
52
+ if (
53
+ typeof from !== "string" ||
54
+ !Array.isArray(after) ||
55
+ !after.every(isKeyValue)
56
+ ) {
57
+ throw new DatabaseCursorError("The cursor is malformed.");
58
+ }
59
+ if (from !== scope) {
60
+ throw new DatabaseCursorError(
61
+ "The cursor belongs to a read with another model, index, filter, order, or range.",
62
+ );
63
+ }
64
+ return after;
65
+ };