@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
@@ -1,57 +1,65 @@
1
- import { ApiKeyManagementAPI } from "./apiKeys.cjs";
1
+ import { ToolingDatabase } from "./db/types.cjs";
2
+ import { CoreApi } from "./core/api.cjs";
3
+ import { AnyHotUpdaterPlugin, PluginApis } from "./plugins/definePlugin.cjs";
2
4
  import { HotUpdaterHandlers } from "./handlerTypes.cjs";
3
- import { InsightsProvider } from "./insights/types.cjs";
4
- import { DatabaseAPI, DatabasePlugin as DatabasePlugin$1 } from "./db/types.cjs";
5
+ import "./handler.cjs";
5
6
  import { StoragePlugin } from "@hot-updater/plugin-core";
6
-
7
7
  //#region src/createHotUpdaterCore.d.ts
8
- type RuntimeHotUpdaterAPI = DatabaseAPI & {
8
+ type RuntimeHotUpdaterAPI<TPlugins extends readonly AnyHotUpdaterPlugin[] = readonly AnyHotUpdaterPlugin[]> = {
9
9
  readonly handlers: HotUpdaterHandlers;
10
+ /** Core's reads and typed writes: bundles, Releases, Catalogs, and channels. */
11
+ readonly core: CoreApi;
12
+ /** Each plugin's API by plugin id. */
13
+ readonly api: PluginApis<TPlugins>;
14
+ /** The database's name, which `hot-updater db` commands read. */
10
15
  readonly adapterName: string;
11
- /**
12
- * Built-in Insights provider. Client ingestion and admin query routes are
13
- * always mounted; React Native clients report lifecycle events by default
14
- * and can opt out with `HotUpdater.init({ insights: false })`.
15
- */
16
- readonly insights: InsightsProvider;
17
- /**
18
- * In-process API key lifecycle operations for trusted server tooling.
19
- * Creation returns the plaintext once; list and revoke expose only metadata.
20
- * This capability is never mounted on the client or admin HTTP handlers.
21
- */
22
- readonly apiKeys: ApiKeyManagementAPI;
23
16
  };
24
17
  type HotUpdaterAPI = RuntimeHotUpdaterAPI;
25
- type ClientAccessPolicy = {
26
- /**
27
- * Leaves Release Catalog, artifact, and Insights ingestion routes
28
- * publicly accessible without a client credential.
29
- */
30
- readonly type: "public";
31
- } | {
32
- /**
33
- * Requires a key registered in `database.models.apiKeys` for
34
- * Release Catalog, artifact, and Insights ingestion requests.
35
- */
36
- readonly type: "api-key";
37
- /**
38
- * Request header containing the API key. Defaults to
39
- * `x-api-key`. Clients must send the same header; Release Catalog
40
- * responses include it in `Vary` to preserve cache isolation.
41
- */
18
+ declare const REMOVED_CLIENT_ACCESS = "clientAccess objects were removed in 1.0: set clientAccess: \"public\", or add apiKeys() from @hot-updater/server/plugins/api-keys to plugins";
19
+ /**
20
+ * A `clientAccess` object from before 1.0. Its `type` names the fix, so
21
+ * TypeScript reports it where the object is written.
22
+ */
23
+ interface RemovedClientAccess {
24
+ readonly type: typeof REMOVED_CLIENT_ACCESS;
42
25
  readonly headerName?: string;
43
- };
44
- interface CreateHotUpdaterOptions {
45
- readonly database: DatabasePlugin$1;
46
- /**
47
- * Required client-route access policy. This choice is explicit so a server
48
- * cannot accidentally change between public and authenticated OTA access.
49
- * `/version`, storage downloads, and admin-handler routes are unaffected.
50
- */
26
+ }
27
+ type ClientAccessPolicy =
28
+ /** Leaves client routes public; required when no plugin provides clientAuth. */
29
+ "public" | RemovedClientAccess;
30
+ type ProvidesClientAuth<TPlugin> = TPlugin extends {
31
+ readonly provides?: infer TProvides;
32
+ } ? TProvides extends {
33
+ readonly clientAuth: true;
34
+ } ? true : false : false;
35
+ type ClientAuthIds<TPlugins extends readonly unknown[], TFound extends string[] = []> = TPlugins extends readonly [infer THead, ...infer TTail] ? ClientAuthIds<TTail, ProvidesClientAuth<THead> extends true ? [...TFound, THead extends {
36
+ readonly id: infer TId extends string;
37
+ } ? TId : string] : TFound> : TFound;
38
+ type JoinIds<TIds extends string[]> = TIds extends [infer TFirst extends string, ...infer TRest extends string[]] ? TRest extends [] ? `"${TFirst}"` : `"${TFirst}", ${JoinIds<TRest>}` : "";
39
+ /**
40
+ * Client routes have one policy source: exactly one plugin that provides
41
+ * clientAuth, or an explicit `clientAccess`. Tuples are counted here; an
42
+ * untyped list that may hold a clientAuth plugin is left to startup.
43
+ */
44
+ type ClientAccessRule<TPlugins extends readonly AnyHotUpdaterPlugin[]> = number extends TPlugins["length"] ? true extends ProvidesClientAuth<TPlugins[number]> ? {
45
+ readonly clientAccess?: "Remove clientAccess: a plugin in this list may provide clientAuth";
46
+ } : {
47
+ readonly clientAccess: ClientAccessPolicy;
48
+ } : ClientAuthIds<TPlugins> extends [] ? {
51
49
  readonly clientAccess: ClientAccessPolicy;
50
+ } : ClientAuthIds<TPlugins> extends [infer TId extends string] ? {
51
+ readonly clientAccess?: `Remove clientAccess: plugin "${TId}" provides clientAuth`;
52
+ } : {
53
+ readonly clientAuth: `Keep one clientAuth plugin: ${JoinIds<ClientAuthIds<TPlugins>>} all provide it`;
54
+ };
55
+ type CreateHotUpdaterOptions<TPlugins extends readonly AnyHotUpdaterPlugin[] = readonly []> = {
56
+ /** A provider's database on the storage engine, such as `kyselyAdapter(...)` or `postgres(...)`. */
57
+ readonly database: ToolingDatabase;
52
58
  /** Storage implementations used to read provider-specific storage URIs. */
53
59
  readonly storage?: readonly StoragePlugin[];
54
- }
55
- declare function createHotUpdater(options: CreateHotUpdaterOptions): RuntimeHotUpdaterAPI;
60
+ /** Built-in and third-party plugins; at most one provides clientAuth. Defaults to none. */
61
+ readonly plugins?: TPlugins;
62
+ } & ClientAccessRule<TPlugins>;
63
+ declare function createHotUpdater<const TPlugins extends readonly AnyHotUpdaterPlugin[] = readonly []>(options: CreateHotUpdaterOptions<TPlugins>): RuntimeHotUpdaterAPI<NoInfer<TPlugins>>;
56
64
  //#endregion
57
- export { ClientAccessPolicy, CreateHotUpdaterOptions, HotUpdaterAPI, RuntimeHotUpdaterAPI, createHotUpdater };
65
+ export { ClientAccessPolicy, ClientAccessRule, CreateHotUpdaterOptions, HotUpdaterAPI, RemovedClientAccess, RuntimeHotUpdaterAPI, createHotUpdater };
@@ -1,57 +1,65 @@
1
- import { ApiKeyManagementAPI } from "./apiKeys.mjs";
1
+ import { ToolingDatabase } from "./db/types.mjs";
2
+ import { CoreApi } from "./core/api.mjs";
3
+ import { AnyHotUpdaterPlugin, PluginApis } from "./plugins/definePlugin.mjs";
2
4
  import { HotUpdaterHandlers } from "./handlerTypes.mjs";
3
- import { InsightsProvider } from "./insights/types.mjs";
4
- import { DatabaseAPI, DatabasePlugin as DatabasePlugin$1 } from "./db/types.mjs";
5
+ import "./handler.mjs";
5
6
  import { StoragePlugin } from "@hot-updater/plugin-core";
6
-
7
7
  //#region src/createHotUpdaterCore.d.ts
8
- type RuntimeHotUpdaterAPI = DatabaseAPI & {
8
+ type RuntimeHotUpdaterAPI<TPlugins extends readonly AnyHotUpdaterPlugin[] = readonly AnyHotUpdaterPlugin[]> = {
9
9
  readonly handlers: HotUpdaterHandlers;
10
+ /** Core's reads and typed writes: bundles, Releases, Catalogs, and channels. */
11
+ readonly core: CoreApi;
12
+ /** Each plugin's API by plugin id. */
13
+ readonly api: PluginApis<TPlugins>;
14
+ /** The database's name, which `hot-updater db` commands read. */
10
15
  readonly adapterName: string;
11
- /**
12
- * Built-in Insights provider. Client ingestion and admin query routes are
13
- * always mounted; React Native clients report lifecycle events by default
14
- * and can opt out with `HotUpdater.init({ insights: false })`.
15
- */
16
- readonly insights: InsightsProvider;
17
- /**
18
- * In-process API key lifecycle operations for trusted server tooling.
19
- * Creation returns the plaintext once; list and revoke expose only metadata.
20
- * This capability is never mounted on the client or admin HTTP handlers.
21
- */
22
- readonly apiKeys: ApiKeyManagementAPI;
23
16
  };
24
17
  type HotUpdaterAPI = RuntimeHotUpdaterAPI;
25
- type ClientAccessPolicy = {
26
- /**
27
- * Leaves Release Catalog, artifact, and Insights ingestion routes
28
- * publicly accessible without a client credential.
29
- */
30
- readonly type: "public";
31
- } | {
32
- /**
33
- * Requires a key registered in `database.models.apiKeys` for
34
- * Release Catalog, artifact, and Insights ingestion requests.
35
- */
36
- readonly type: "api-key";
37
- /**
38
- * Request header containing the API key. Defaults to
39
- * `x-api-key`. Clients must send the same header; Release Catalog
40
- * responses include it in `Vary` to preserve cache isolation.
41
- */
18
+ declare const REMOVED_CLIENT_ACCESS = "clientAccess objects were removed in 1.0: set clientAccess: \"public\", or add apiKeys() from @hot-updater/server/plugins/api-keys to plugins";
19
+ /**
20
+ * A `clientAccess` object from before 1.0. Its `type` names the fix, so
21
+ * TypeScript reports it where the object is written.
22
+ */
23
+ interface RemovedClientAccess {
24
+ readonly type: typeof REMOVED_CLIENT_ACCESS;
42
25
  readonly headerName?: string;
43
- };
44
- interface CreateHotUpdaterOptions {
45
- readonly database: DatabasePlugin$1;
46
- /**
47
- * Required client-route access policy. This choice is explicit so a server
48
- * cannot accidentally change between public and authenticated OTA access.
49
- * `/version`, storage downloads, and admin-handler routes are unaffected.
50
- */
26
+ }
27
+ type ClientAccessPolicy =
28
+ /** Leaves client routes public; required when no plugin provides clientAuth. */
29
+ "public" | RemovedClientAccess;
30
+ type ProvidesClientAuth<TPlugin> = TPlugin extends {
31
+ readonly provides?: infer TProvides;
32
+ } ? TProvides extends {
33
+ readonly clientAuth: true;
34
+ } ? true : false : false;
35
+ type ClientAuthIds<TPlugins extends readonly unknown[], TFound extends string[] = []> = TPlugins extends readonly [infer THead, ...infer TTail] ? ClientAuthIds<TTail, ProvidesClientAuth<THead> extends true ? [...TFound, THead extends {
36
+ readonly id: infer TId extends string;
37
+ } ? TId : string] : TFound> : TFound;
38
+ type JoinIds<TIds extends string[]> = TIds extends [infer TFirst extends string, ...infer TRest extends string[]] ? TRest extends [] ? `"${TFirst}"` : `"${TFirst}", ${JoinIds<TRest>}` : "";
39
+ /**
40
+ * Client routes have one policy source: exactly one plugin that provides
41
+ * clientAuth, or an explicit `clientAccess`. Tuples are counted here; an
42
+ * untyped list that may hold a clientAuth plugin is left to startup.
43
+ */
44
+ type ClientAccessRule<TPlugins extends readonly AnyHotUpdaterPlugin[]> = number extends TPlugins["length"] ? true extends ProvidesClientAuth<TPlugins[number]> ? {
45
+ readonly clientAccess?: "Remove clientAccess: a plugin in this list may provide clientAuth";
46
+ } : {
47
+ readonly clientAccess: ClientAccessPolicy;
48
+ } : ClientAuthIds<TPlugins> extends [] ? {
51
49
  readonly clientAccess: ClientAccessPolicy;
50
+ } : ClientAuthIds<TPlugins> extends [infer TId extends string] ? {
51
+ readonly clientAccess?: `Remove clientAccess: plugin "${TId}" provides clientAuth`;
52
+ } : {
53
+ readonly clientAuth: `Keep one clientAuth plugin: ${JoinIds<ClientAuthIds<TPlugins>>} all provide it`;
54
+ };
55
+ type CreateHotUpdaterOptions<TPlugins extends readonly AnyHotUpdaterPlugin[] = readonly []> = {
56
+ /** A provider's database on the storage engine, such as `kyselyAdapter(...)` or `postgres(...)`. */
57
+ readonly database: ToolingDatabase;
52
58
  /** Storage implementations used to read provider-specific storage URIs. */
53
59
  readonly storage?: readonly StoragePlugin[];
54
- }
55
- declare function createHotUpdater(options: CreateHotUpdaterOptions): RuntimeHotUpdaterAPI;
60
+ /** Built-in and third-party plugins; at most one provides clientAuth. Defaults to none. */
61
+ readonly plugins?: TPlugins;
62
+ } & ClientAccessRule<TPlugins>;
63
+ declare function createHotUpdater<const TPlugins extends readonly AnyHotUpdaterPlugin[] = readonly []>(options: CreateHotUpdaterOptions<TPlugins>): RuntimeHotUpdaterAPI<NoInfer<TPlugins>>;
56
64
  //#endregion
57
- export { ClientAccessPolicy, CreateHotUpdaterOptions, HotUpdaterAPI, RuntimeHotUpdaterAPI, createHotUpdater };
65
+ export { ClientAccessPolicy, ClientAccessRule, CreateHotUpdaterOptions, HotUpdaterAPI, RemovedClientAccess, RuntimeHotUpdaterAPI, createHotUpdater };
@@ -1,86 +1,84 @@
1
+ import { toolingTargetOf } from "./db/builtInDatabase.mjs";
2
+ import { HotUpdaterConfigError, assemblePlugins } from "./assembly/assemblePlugins.mjs";
1
3
  import { createHotUpdaterHandlers } from "./handler.mjs";
2
- import { createInsightsProvider } from "./insights/bounded/provider.mjs";
3
- import { authenticateApiKey, createApiKeyManagement, normalizeApiKeyHeaderName } from "./apiKeys.mjs";
4
- import { createDatabasePluginCore } from "./db/databasePluginCore.mjs";
5
- import { createSchemaReadinessChecker } from "./db/schemaReadiness.mjs";
6
- import { isDatabasePlugin } from "./db/types.mjs";
7
4
  import { createStorageAccess } from "./storageAccess.mjs";
8
5
  import { assertStorageOperations } from "@hot-updater/plugin-core";
9
6
  //#region src/createHotUpdaterCore.ts
10
- const normalizeClientAccess = (value) => {
11
- if (value === null || typeof value !== "object" || Array.isArray(value)) throw new TypeError("clientAccess must be an object.");
12
- const policy = value;
13
- if (policy.type === "public") return { type: "public" };
14
- if (policy.type === "api-key") return {
15
- headerName: normalizeApiKeyHeaderName(policy.headerName),
16
- type: "api-key"
17
- };
18
- throw new TypeError("clientAccess.type must be either \"public\" or \"api-key\".");
7
+ const isRecord = (value) => typeof value === "object" && value !== null;
8
+ const isAdapter = (value) => isRecord(value) && [
9
+ "fits",
10
+ "get",
11
+ "query",
12
+ "write"
13
+ ].every((method) => typeof value[method] === "function");
14
+ /** The configured database, when it runs on the storage engine. */
15
+ const databaseOf = (value) => {
16
+ if (isRecord(value) && typeof value.name === "string") {
17
+ if (isAdapter(value.adapter)) return value;
18
+ if ("core" in value && "fetchAdmin" in value) throw new HotUpdaterConfigError("standaloneRepository reaches a server's admin API from the CLI and console. createHotUpdater needs the server's own database, such as kyselyAdapter(...).");
19
+ }
20
+ throw new HotUpdaterConfigError("database must be a Hot Updater 1.0 database, such as kyselyAdapter(...) or postgres(...). Upgrade the provider package that created it.");
21
+ };
22
+ /** A release candidate's config moving to 1.0 also needs `insights()`. */
23
+ const KEEP_INSIGHTS = "To keep Insights, which the release candidates ran by default, add insights() from @hot-updater/server/plugins/insights to plugins.";
24
+ /** `"public"`, or nothing; a `clientAccess` object names what replaced it. */
25
+ const isPublic = (value) => {
26
+ if (value === void 0) return false;
27
+ if (value === "public") return true;
28
+ if (isRecord(value)) {
29
+ const type = value.type;
30
+ throw new HotUpdaterConfigError(type === "api-key" ? `clientAccess: { type: "api-key" } was removed in 1.0. Remove it and add apiKeys(${value.headerName === void 0 ? "" : `{ headerName: ${JSON.stringify(value.headerName)} }`}) from @hot-updater/server/plugins/api-keys to plugins, which protects client routes the same way. ${KEEP_INSIGHTS}` : `clientAccess objects were removed in 1.0. Use clientAccess: "public", or add apiKeys() from @hot-updater/server/plugins/api-keys to plugins. ${KEEP_INSIGHTS}`);
31
+ }
32
+ throw new HotUpdaterConfigError("clientAccess must be \"public\"; to protect client routes, add apiKeys() from @hot-updater/server/plugins/api-keys to plugins.");
19
33
  };
20
34
  const hotUpdaterCoreMetadata = Symbol.for("@hot-updater/server/core-metadata");
21
35
  function getHotUpdaterCoreMetadata(hotUpdater) {
22
36
  return hotUpdater[hotUpdaterCoreMetadata];
23
37
  }
24
- function createHotUpdaterCore(options) {
38
+ function createHotUpdater(options) {
25
39
  for (const key of ["authorityId", "catalogId"]) if (Object.hasOwn(options, key)) throw new TypeError(`Remove ${key} from createHotUpdater options. Catalog identity is managed internally.`);
26
- const database = options.database;
27
- const { downloadStorageObject, readStorageText, resolveFileUrl } = createStorageAccess((options.storage ?? []).map((storage) => {
40
+ const database = databaseOf(options.database);
41
+ const storagePlugins = (options.storage ?? []).map((storage) => {
28
42
  assertStorageOperations(storage, ["get", "getDownloadUrl"]);
29
43
  return storage;
30
- }));
31
- const adapterCapabilities = database;
32
- if (!isDatabasePlugin(database)) throw new Error("@hot-updater/server only supports database plugins.");
33
- const plugin = database;
34
- const assertSchemaReady = createSchemaReadinessChecker(adapterCapabilities.adapterName ?? plugin.name, adapterCapabilities.createMigrator);
35
- const core = createDatabasePluginCore(plugin, resolveFileUrl, {
36
- beforeOperation: assertSchemaReady,
37
- readStorageText
38
44
  });
39
- const clientAccess = normalizeClientAccess(options.clientAccess);
40
- const insights = createInsightsProvider({
41
- async append(row) {
42
- await assertSchemaReady();
43
- return plugin.models.insights.append(row);
45
+ const { downloadStorageObject, readStorageText, resolveFileUrl } = createStorageAccess(storagePlugins);
46
+ const publicClients = isPublic(options.clientAccess);
47
+ const plugins = assemblePlugins(options.plugins ?? [], database.adapter, {
48
+ storage: {
49
+ readStorageText,
50
+ resolveFileUrl
44
51
  },
45
- async scan(input) {
46
- await assertSchemaReady();
47
- return plugin.models.insights.scan(input);
48
- }
52
+ ...database.onCachedRoutesChange === void 0 ? {} : { onCachedRoutesChange: () => database.onCachedRoutesChange() }
49
53
  });
50
- const apiKeys = createApiKeyManagement({
51
- apiKeys: plugin.models.apiKeys,
52
- beforeOperation: assertSchemaReady
54
+ const clientAuth = plugins.clientAuth;
55
+ if (clientAuth !== void 0 && publicClients) throw new HotUpdaterConfigError(`Plugin "${clientAuth.plugin}" provides clientAuth, so remove clientAccess.`);
56
+ if (clientAuth === void 0 && !publicClients) throw new HotUpdaterConfigError("Set clientAccess to \"public\", or add a plugin that provides clientAuth.");
57
+ const clientPolicy = clientAuth === void 0 ? void 0 : {
58
+ varyHeaders: clientAuth.varyHeaders.map((header) => header.toLowerCase()),
59
+ authenticate: (request) => clientAuth.authenticate(request.headers)
60
+ };
61
+ const handlers = createHotUpdaterHandlers({
62
+ api: { core: plugins.core },
63
+ ...clientPolicy === void 0 ? {} : { clientPolicy },
64
+ downloadStorageObject,
65
+ endpoints: plugins.endpoints,
66
+ plugins: Object.keys(plugins.api)
53
67
  });
54
- const handlers = createHotUpdaterHandlers(core.api, insights, clientAccess.type === "api-key" ? {
55
- authenticate: (request) => authenticateApiKey({
56
- apiKeys: plugin.models.apiKeys,
57
- beforeLookup: assertSchemaReady,
58
- headerName: clientAccess.headerName,
59
- request
60
- }),
61
- headerName: clientAccess.headerName
62
- } : void 0, downloadStorageObject);
63
- const api = Object.assign({
64
- adapterName: adapterCapabilities.adapterName ?? core.adapterName,
65
- insights,
66
- apiKeys,
67
- handlers
68
- }, core.api);
68
+ const api = {
69
+ adapterName: database.name,
70
+ handlers,
71
+ core: plugins.core,
72
+ api: plugins.api
73
+ };
69
74
  Object.defineProperty(api, hotUpdaterCoreMetadata, {
70
75
  enumerable: false,
71
76
  value: {
72
- adapterCapabilities,
73
- core
77
+ database,
78
+ target: toolingTargetOf(options.plugins ?? [])
74
79
  }
75
80
  });
76
- return {
77
- api,
78
- adapterCapabilities,
79
- core
80
- };
81
- }
82
- function createHotUpdater(options) {
83
- return createHotUpdaterCore(options).api;
81
+ return api;
84
82
  }
85
83
  //#endregion
86
- export { createHotUpdater, getHotUpdaterCoreMetadata };
84
+ export { createHotUpdater, getHotUpdaterCoreMetadata, hotUpdaterCoreMetadata };
@@ -0,0 +1,44 @@
1
+ let _hot_updater_plugin_core_internal = require("@hot-updater/plugin-core/internal");
2
+ //#region src/database/cursor.ts
3
+ var DatabaseCursorError = class extends Error {
4
+ name = "DatabaseCursorError";
5
+ };
6
+ const encoder = new TextEncoder();
7
+ const decoder = new TextDecoder();
8
+ const toBase64Url = (text) => {
9
+ let binary = "";
10
+ for (const byte of encoder.encode(text)) binary += String.fromCharCode(byte);
11
+ return btoa(binary).replaceAll("+", "-").replaceAll("/", "_").replace(/=+$/u, "");
12
+ };
13
+ const fromBase64Url = (value) => {
14
+ const binary = atob(value.replaceAll("-", "+").replaceAll("_", "/"));
15
+ return decoder.decode(Uint8Array.from(binary, (char) => char.charCodeAt(0)));
16
+ };
17
+ /** A stable 32-bit FNV-1a hash of the text's UTF-8 bytes. */
18
+ const fnv1a = (text) => {
19
+ let hash = 2166136261;
20
+ for (const byte of encoder.encode(text)) hash = Math.imul(hash ^ byte, 16777619) >>> 0;
21
+ return hash;
22
+ };
23
+ /** A hash of the request's identity; a cursor only resumes the same read. */
24
+ const cursorScope = (parts) => fnv1a(JSON.stringify(parts)).toString(36);
25
+ const encodeCursor = (scope, after) => toBase64Url(JSON.stringify([scope, after]));
26
+ /** The order tuple a cursor resumes after; rejects a cursor from another read. */
27
+ const decodeCursor = (scope, cursor) => {
28
+ let decoded;
29
+ try {
30
+ decoded = JSON.parse(fromBase64Url(cursor));
31
+ } catch {
32
+ decoded = void 0;
33
+ }
34
+ const [from, after] = Array.isArray(decoded) ? decoded : [];
35
+ if (typeof from !== "string" || !Array.isArray(after) || !after.every(_hot_updater_plugin_core_internal.isKeyValue)) throw new DatabaseCursorError("The cursor is malformed.");
36
+ if (from !== scope) throw new DatabaseCursorError("The cursor belongs to a read with another model, index, filter, order, or range.");
37
+ return after;
38
+ };
39
+ //#endregion
40
+ exports.DatabaseCursorError = DatabaseCursorError;
41
+ exports.cursorScope = cursorScope;
42
+ exports.decodeCursor = decodeCursor;
43
+ exports.encodeCursor = encodeCursor;
44
+ exports.fnv1a = fnv1a;
@@ -0,0 +1,7 @@
1
+ import "@hot-updater/plugin-core/internal";
2
+ //#region src/database/cursor.d.ts
3
+ declare class DatabaseCursorError extends Error {
4
+ readonly name = "DatabaseCursorError";
5
+ }
6
+ //#endregion
7
+ export { DatabaseCursorError };
@@ -0,0 +1,7 @@
1
+ import "@hot-updater/plugin-core/internal";
2
+ //#region src/database/cursor.d.ts
3
+ declare class DatabaseCursorError extends Error {
4
+ readonly name = "DatabaseCursorError";
5
+ }
6
+ //#endregion
7
+ export { DatabaseCursorError };
@@ -0,0 +1,40 @@
1
+ import { isKeyValue } from "@hot-updater/plugin-core/internal";
2
+ //#region src/database/cursor.ts
3
+ var DatabaseCursorError = class extends Error {
4
+ name = "DatabaseCursorError";
5
+ };
6
+ const encoder = new TextEncoder();
7
+ const decoder = new TextDecoder();
8
+ const toBase64Url = (text) => {
9
+ let binary = "";
10
+ for (const byte of encoder.encode(text)) binary += String.fromCharCode(byte);
11
+ return btoa(binary).replaceAll("+", "-").replaceAll("/", "_").replace(/=+$/u, "");
12
+ };
13
+ const fromBase64Url = (value) => {
14
+ const binary = atob(value.replaceAll("-", "+").replaceAll("_", "/"));
15
+ return decoder.decode(Uint8Array.from(binary, (char) => char.charCodeAt(0)));
16
+ };
17
+ /** A stable 32-bit FNV-1a hash of the text's UTF-8 bytes. */
18
+ const fnv1a = (text) => {
19
+ let hash = 2166136261;
20
+ for (const byte of encoder.encode(text)) hash = Math.imul(hash ^ byte, 16777619) >>> 0;
21
+ return hash;
22
+ };
23
+ /** A hash of the request's identity; a cursor only resumes the same read. */
24
+ const cursorScope = (parts) => fnv1a(JSON.stringify(parts)).toString(36);
25
+ const encodeCursor = (scope, after) => toBase64Url(JSON.stringify([scope, after]));
26
+ /** The order tuple a cursor resumes after; rejects a cursor from another read. */
27
+ const decodeCursor = (scope, cursor) => {
28
+ let decoded;
29
+ try {
30
+ decoded = JSON.parse(fromBase64Url(cursor));
31
+ } catch {
32
+ decoded = void 0;
33
+ }
34
+ const [from, after] = Array.isArray(decoded) ? decoded : [];
35
+ if (typeof from !== "string" || !Array.isArray(after) || !after.every(isKeyValue)) throw new DatabaseCursorError("The cursor is malformed.");
36
+ if (from !== scope) throw new DatabaseCursorError("The cursor belongs to a read with another model, index, filter, order, or range.");
37
+ return after;
38
+ };
39
+ //#endregion
40
+ export { DatabaseCursorError, cursorScope, decodeCursor, encodeCursor, fnv1a };
@@ -0,0 +1,44 @@
1
+ const require_engineTransaction = require("./engineTransaction.cjs");
2
+ const require_engine = require("./engine.cjs");
3
+ let _hot_updater_plugin_core_internal = require("@hot-updater/plugin-core/internal");
4
+ //#region src/database/database.ts
5
+ /** The engine plus `database(module)`, which hands a module its typed handle. */
6
+ const createDatabaseEngine = (options) => {
7
+ const engine = require_engine.createEngine(options);
8
+ const { reads } = engine;
9
+ const outside = (read) => (...args) => {
10
+ require_engineTransaction.assertOutsideTransaction();
11
+ return read(...args);
12
+ };
13
+ /** No read outside a transaction returns `_v`, which a key-value index copy lacks. */
14
+ const bare = (row) => row && Object.fromEntries(Object.entries(row).filter(([column]) => column !== _hot_updater_plugin_core_internal.DATABASE_VERSION_COLUMN));
15
+ const barePage = async (page) => {
16
+ const { rows, next } = await page;
17
+ return {
18
+ rows: rows.map(bare),
19
+ ...next === void 0 ? {} : { next }
20
+ };
21
+ };
22
+ return {
23
+ ...engine,
24
+ database(module) {
25
+ const name = (model) => module.namespace ? `${module.namespace}_${model}` : model;
26
+ return {
27
+ findOne: outside(async (model, lookup) => bare(await reads.findOne(name(model), lookup))),
28
+ findByKeys: outside(async (model, keys) => (await reads.findByKeys(name(model), keys)).map(bare)),
29
+ findMany: outside((model, input) => barePage(reads.findMany(name(model), input))),
30
+ findAggregates: outside((model, input) => barePage(reads.findAggregates(name(model), input))),
31
+ transaction: (fn) => engine.transaction((tx) => fn({
32
+ findOne: (model, lookup) => tx.findOne(name(model), lookup),
33
+ findMany: (model, input) => tx.findMany(name(model), input),
34
+ create: (model, row) => tx.create(name(model), row),
35
+ update: (model, row, set) => tx.update(name(model), row, set),
36
+ delete: (model, row) => tx.delete(name(model), row),
37
+ aggregate: (model, identity, changes, options) => tx.aggregate(name(model), identity, changes, options)
38
+ }))
39
+ };
40
+ }
41
+ };
42
+ };
43
+ //#endregion
44
+ exports.createDatabaseEngine = createDatabaseEngine;