@hot-updater/server 1.0.0-rc.14 → 1.0.0-rc.17

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 (519) hide show
  1. package/dist/adapters/drizzle.cjs +35 -74
  2. package/dist/adapters/drizzle.d.cts +13 -5
  3. package/dist/adapters/drizzle.d.mts +13 -5
  4. package/dist/adapters/drizzle.mjs +34 -75
  5. package/dist/adapters/drizzleExecutor.cjs +114 -0
  6. package/dist/adapters/drizzleExecutor.d.cts +9 -0
  7. package/dist/adapters/drizzleExecutor.d.mts +9 -0
  8. package/dist/adapters/drizzleExecutor.mjs +112 -0
  9. package/dist/adapters/kysely.cjs +25 -31
  10. package/dist/adapters/kysely.d.cts +10 -6
  11. package/dist/adapters/kysely.d.mts +10 -6
  12. package/dist/adapters/kysely.mjs +25 -32
  13. package/dist/adapters/kyselyExecutor.cjs +32 -0
  14. package/dist/adapters/kyselyExecutor.d.cts +12 -0
  15. package/dist/adapters/kyselyExecutor.d.mts +12 -0
  16. package/dist/adapters/kyselyExecutor.mjs +32 -0
  17. package/dist/adapters/mongodb.cjs +28 -62
  18. package/dist/adapters/mongodb.d.cts +10 -5
  19. package/dist/adapters/mongodb.d.mts +10 -5
  20. package/dist/adapters/mongodb.mjs +28 -63
  21. package/dist/adapters/mongodbAdapter.cjs +174 -0
  22. package/dist/adapters/mongodbAdapter.d.cts +9 -0
  23. package/dist/adapters/mongodbAdapter.d.mts +9 -0
  24. package/dist/adapters/mongodbAdapter.mjs +173 -0
  25. package/dist/adapters/prisma.cjs +38 -257
  26. package/dist/adapters/prisma.d.cts +12 -7
  27. package/dist/adapters/prisma.d.mts +12 -7
  28. package/dist/adapters/prisma.mjs +38 -257
  29. package/dist/adapters/prismaExecutor.cjs +64 -0
  30. package/dist/adapters/prismaExecutor.mjs +64 -0
  31. package/dist/adapters/sqlProviders.cjs +9 -0
  32. package/dist/adapters/sqlProviders.mjs +9 -0
  33. package/dist/apiKeys.cjs +2 -6
  34. package/dist/apiKeys.d.cts +1 -23
  35. package/dist/apiKeys.d.mts +1 -23
  36. package/dist/apiKeys.mjs +2 -6
  37. package/dist/assembly/assemblePlugins.cjs +147 -0
  38. package/dist/assembly/assemblePlugins.d.cts +12 -0
  39. package/dist/assembly/assemblePlugins.d.mts +12 -0
  40. package/dist/assembly/assemblePlugins.mjs +146 -0
  41. package/dist/assembly/databasePlugins.cjs +23 -0
  42. package/dist/assembly/databasePlugins.d.cts +43 -0
  43. package/dist/assembly/databasePlugins.d.mts +43 -0
  44. package/dist/assembly/databasePlugins.mjs +22 -0
  45. package/dist/core/api.cjs +91 -0
  46. package/dist/core/api.d.cts +65 -0
  47. package/dist/core/api.d.mts +65 -0
  48. package/dist/core/api.mjs +87 -0
  49. package/dist/core/baseCandidates.cjs +71 -0
  50. package/dist/core/baseCandidates.d.cts +17 -0
  51. package/dist/core/baseCandidates.d.mts +17 -0
  52. package/dist/core/baseCandidates.mjs +69 -0
  53. package/dist/core/operations.cjs +350 -0
  54. package/dist/core/operations.mjs +350 -0
  55. package/dist/core/reads.cjs +273 -0
  56. package/dist/core/reads.d.cts +48 -0
  57. package/dist/core/reads.d.mts +48 -0
  58. package/dist/core/reads.mjs +267 -0
  59. package/dist/core/releases.cjs +193 -0
  60. package/dist/core/releases.mjs +190 -0
  61. package/dist/core/schema.cjs +279 -0
  62. package/dist/core/schema.d.cts +307 -0
  63. package/dist/core/schema.d.mts +307 -0
  64. package/dist/core/schema.mjs +277 -0
  65. package/dist/core/writes.cjs +96 -0
  66. package/dist/core/writes.mjs +91 -0
  67. package/dist/createHotUpdaterCore.cjs +58 -75
  68. package/dist/createHotUpdaterCore.d.cts +52 -44
  69. package/dist/createHotUpdaterCore.d.mts +52 -44
  70. package/dist/createHotUpdaterCore.mjs +59 -75
  71. package/dist/database/cursor.cjs +44 -0
  72. package/dist/database/cursor.d.cts +7 -0
  73. package/dist/database/cursor.d.mts +7 -0
  74. package/dist/database/cursor.mjs +40 -0
  75. package/dist/database/database.cjs +44 -0
  76. package/dist/database/database.d.cts +123 -0
  77. package/dist/database/database.d.mts +123 -0
  78. package/dist/database/database.mjs +44 -0
  79. package/dist/database/definitions.d.cts +68 -0
  80. package/dist/database/definitions.d.mts +68 -0
  81. package/dist/database/engine.cjs +37 -0
  82. package/dist/database/engine.d.cts +40 -0
  83. package/dist/database/engine.d.mts +40 -0
  84. package/dist/database/engine.mjs +37 -0
  85. package/dist/database/engineAggregates.cjs +115 -0
  86. package/dist/database/engineAggregates.mjs +112 -0
  87. package/dist/database/engineReads.cjs +180 -0
  88. package/dist/database/engineReads.d.cts +35 -0
  89. package/dist/database/engineReads.d.mts +35 -0
  90. package/dist/database/engineReads.mjs +179 -0
  91. package/dist/database/engineTransaction.cjs +403 -0
  92. package/dist/database/engineTransaction.d.cts +26 -0
  93. package/dist/database/engineTransaction.d.mts +26 -0
  94. package/dist/database/engineTransaction.mjs +402 -0
  95. package/dist/database/errors.cjs +27 -0
  96. package/dist/database/errors.d.cts +21 -0
  97. package/dist/database/errors.d.mts +21 -0
  98. package/dist/database/errors.mjs +24 -0
  99. package/dist/database/fence.cjs +124 -0
  100. package/dist/database/fence.d.cts +42 -0
  101. package/dist/database/fence.d.mts +42 -0
  102. package/dist/database/fence.mjs +116 -0
  103. package/dist/database/index.cjs +127 -0
  104. package/dist/database/index.d.cts +17 -0
  105. package/dist/database/index.d.mts +17 -0
  106. package/dist/database/index.mjs +15 -0
  107. package/dist/database/kv/kvAdapter.cjs +273 -0
  108. package/dist/database/kv/kvAdapter.d.cts +101 -0
  109. package/dist/database/kv/kvAdapter.d.mts +101 -0
  110. package/dist/database/kv/kvAdapter.mjs +272 -0
  111. package/dist/database/resolveSchema.cjs +196 -0
  112. package/dist/database/resolveSchema.d.cts +42 -0
  113. package/dist/database/resolveSchema.d.mts +42 -0
  114. package/dist/database/resolveSchema.mjs +193 -0
  115. package/dist/database/schema.cjs +21 -0
  116. package/dist/database/schema.d.cts +61 -0
  117. package/dist/database/schema.d.mts +61 -0
  118. package/dist/database/schema.mjs +20 -0
  119. package/dist/database/sql/sqlAdapter.cjs +282 -0
  120. package/dist/database/sql/sqlAdapter.d.cts +46 -0
  121. package/dist/database/sql/sqlAdapter.d.mts +46 -0
  122. package/dist/database/sql/sqlAdapter.mjs +279 -0
  123. package/dist/database/sql/sqlSchema.cjs +115 -0
  124. package/dist/database/sql/sqlSchema.d.cts +8 -0
  125. package/dist/database/sql/sqlSchema.d.mts +8 -0
  126. package/dist/database/sql/sqlSchema.mjs +111 -0
  127. package/dist/db/builtInDatabase.cjs +104 -0
  128. package/dist/db/builtInDatabase.d.cts +38 -0
  129. package/dist/db/builtInDatabase.d.mts +38 -0
  130. package/dist/db/builtInDatabase.mjs +97 -0
  131. package/dist/db/createBundleDiff.cjs +4 -4
  132. package/dist/db/createBundleDiff.d.cts +3 -2
  133. package/dist/db/createBundleDiff.d.mts +3 -2
  134. package/dist/db/createBundleDiff.mjs +5 -5
  135. package/dist/db/engineDrizzleSchema.cjs +54 -0
  136. package/dist/db/engineDrizzleSchema.mjs +54 -0
  137. package/dist/db/engineMigrator.cjs +53 -0
  138. package/dist/db/engineMigrator.mjs +53 -0
  139. package/dist/db/enginePrismaSchema.cjs +85 -0
  140. package/dist/db/enginePrismaSchema.d.cts +5 -0
  141. package/dist/db/enginePrismaSchema.d.mts +5 -0
  142. package/dist/db/enginePrismaSchema.mjs +84 -0
  143. package/dist/db/engineSql.cjs +26 -0
  144. package/dist/db/engineSql.d.cts +17 -0
  145. package/dist/db/engineSql.d.mts +17 -0
  146. package/dist/db/engineSql.mjs +25 -0
  147. package/dist/db/engineSqlMigrator.cjs +66 -0
  148. package/dist/db/engineSqlMigrator.mjs +66 -0
  149. package/dist/db/fixedMigratorShared.cjs +0 -11
  150. package/dist/db/fixedMigratorShared.mjs +1 -8
  151. package/dist/db/index.cjs +23 -10
  152. package/dist/db/index.d.cts +10 -4
  153. package/dist/db/index.d.mts +10 -4
  154. package/dist/db/index.mjs +16 -9
  155. package/dist/db/releaseCatalog.cjs +20 -43
  156. package/dist/db/releaseCatalog.d.cts +2 -2
  157. package/dist/db/releaseCatalog.d.mts +2 -2
  158. package/dist/db/releaseCatalog.mjs +20 -44
  159. package/dist/db/schemaSettings.cjs +63 -0
  160. package/dist/db/schemaSettings.d.cts +12 -0
  161. package/dist/db/schemaSettings.d.mts +12 -0
  162. package/dist/db/schemaSettings.mjs +62 -0
  163. package/dist/db/settingsMigrator.cjs +92 -0
  164. package/dist/db/settingsMigrator.mjs +89 -0
  165. package/dist/db/types.cjs +1 -12
  166. package/dist/db/types.d.cts +26 -66
  167. package/dist/db/types.d.mts +26 -66
  168. package/dist/db/types.mjs +2 -11
  169. package/dist/db/updateArtifacts.cjs +38 -67
  170. package/dist/db/updateArtifacts.mjs +40 -69
  171. package/dist/diff.cjs +3 -0
  172. package/dist/diff.d.cts +2 -0
  173. package/dist/diff.d.mts +2 -0
  174. package/dist/diff.mjs +2 -0
  175. package/dist/handler.cjs +72 -43
  176. package/dist/handler.d.cts +3 -5
  177. package/dist/handler.d.mts +3 -5
  178. package/dist/handler.mjs +73 -43
  179. package/dist/handlerAdminRoutes.cjs +375 -0
  180. package/dist/handlerAdminRoutes.mjs +373 -0
  181. package/dist/handlerParameters.cjs +6 -11
  182. package/dist/handlerParameters.mjs +6 -10
  183. package/dist/handlerReleaseCatalogRoutes.cjs +11 -13
  184. package/dist/handlerReleaseCatalogRoutes.mjs +11 -13
  185. package/dist/handlerTypes.d.cts +2 -55
  186. package/dist/handlerTypes.d.mts +2 -55
  187. package/dist/handlerVersionRoutes.cjs +20 -4
  188. package/dist/handlerVersionRoutes.mjs +20 -4
  189. package/dist/index.cjs +4 -7
  190. package/dist/index.d.cts +8 -7
  191. package/dist/index.d.mts +8 -7
  192. package/dist/index.mjs +4 -4
  193. package/dist/insights/domain.d.cts +12 -0
  194. package/dist/insights/domain.d.mts +12 -0
  195. package/dist/insights/errors.cjs +34 -0
  196. package/dist/insights/errors.mjs +34 -1
  197. package/dist/insights/eventInput.cjs +14 -19
  198. package/dist/insights/eventInput.mjs +15 -20
  199. package/dist/insights/provider.cjs +47 -23
  200. package/dist/insights/provider.mjs +47 -24
  201. package/dist/insights/routes.cjs +79 -14
  202. package/dist/insights/routes.mjs +77 -14
  203. package/dist/node.d.cts +1 -1
  204. package/dist/node.d.mts +1 -1
  205. package/dist/package.cjs +1 -1
  206. package/dist/package.mjs +1 -1
  207. package/dist/plugins/api-keys/index.cjs +50 -0
  208. package/dist/plugins/api-keys/index.d.cts +85 -0
  209. package/dist/plugins/api-keys/index.d.mts +85 -0
  210. package/dist/plugins/api-keys/index.mjs +47 -0
  211. package/dist/plugins/api-keys/model.cjs +58 -0
  212. package/dist/plugins/api-keys/model.d.cts +8 -0
  213. package/dist/plugins/api-keys/model.d.mts +8 -0
  214. package/dist/plugins/api-keys/model.mjs +58 -0
  215. package/dist/plugins/api-keys/schema.cjs +38 -0
  216. package/dist/plugins/api-keys/schema.d.cts +44 -0
  217. package/dist/plugins/api-keys/schema.d.mts +44 -0
  218. package/dist/plugins/api-keys/schema.mjs +39 -0
  219. package/dist/plugins/builtIn.cjs +7 -0
  220. package/dist/plugins/builtIn.mjs +6 -0
  221. package/dist/plugins/definePlugin.cjs +5 -0
  222. package/dist/plugins/definePlugin.d.cts +73 -0
  223. package/dist/plugins/definePlugin.d.mts +73 -0
  224. package/dist/plugins/definePlugin.mjs +5 -0
  225. package/dist/plugins/index.cjs +17 -0
  226. package/dist/plugins/index.d.cts +9 -0
  227. package/dist/plugins/index.d.mts +9 -0
  228. package/dist/plugins/index.mjs +7 -0
  229. package/dist/plugins/insights/index.cjs +48 -0
  230. package/dist/plugins/insights/index.d.cts +295 -0
  231. package/dist/plugins/insights/index.d.mts +295 -0
  232. package/dist/plugins/insights/index.mjs +44 -0
  233. package/dist/plugins/insights/model.cjs +17 -0
  234. package/dist/plugins/insights/model.d.cts +10 -0
  235. package/dist/plugins/insights/model.d.mts +10 -0
  236. package/dist/plugins/insights/model.mjs +17 -0
  237. package/dist/plugins/insights/reads.cjs +471 -0
  238. package/dist/plugins/insights/reads.mjs +466 -0
  239. package/dist/plugins/insights/recordEvent.cjs +135 -0
  240. package/dist/plugins/insights/recordEvent.d.cts +13 -0
  241. package/dist/plugins/insights/recordEvent.d.mts +13 -0
  242. package/dist/plugins/insights/recordEvent.mjs +132 -0
  243. package/dist/plugins/insights/schema.cjs +347 -0
  244. package/dist/plugins/insights/schema.d.cts +258 -0
  245. package/dist/plugins/insights/schema.d.mts +258 -0
  246. package/dist/plugins/insights/schema.mjs +344 -0
  247. package/dist/types/index.d.cts +2 -28
  248. package/dist/types/index.d.mts +2 -28
  249. package/package.json +32 -5
  250. package/src/adapters/drizzle.conformance.integration.spec.ts +34 -0
  251. package/src/adapters/drizzle.readBudgets.integration.spec.ts +41 -0
  252. package/src/adapters/drizzle.spec.ts +270 -399
  253. package/src/adapters/drizzle.ts +48 -140
  254. package/src/adapters/drizzleExecutor.ts +166 -0
  255. package/src/adapters/kysely.conformance.integration.spec.ts +36 -0
  256. package/src/adapters/kysely.readBudgets.integration.spec.ts +42 -0
  257. package/src/adapters/kysely.spec.ts +204 -171
  258. package/src/adapters/kysely.ts +32 -93
  259. package/src/adapters/kyselyExecutor.ts +53 -0
  260. package/src/adapters/mongodb.integration.spec.ts +143 -446
  261. package/src/adapters/mongodb.readBudgets.integration.spec.ts +61 -0
  262. package/src/adapters/mongodb.ts +36 -123
  263. package/src/adapters/mongodbAdapter.ts +293 -0
  264. package/src/adapters/prisma.conformance.integration.spec.ts +36 -0
  265. package/src/adapters/prisma.integration.spec.ts +138 -0
  266. package/src/adapters/prisma.readBudgets.integration.spec.ts +40 -0
  267. package/src/adapters/prisma.spec.ts +216 -433
  268. package/src/adapters/prisma.ts +60 -524
  269. package/src/adapters/prismaExecutor.ts +107 -0
  270. package/src/adapters/prismaTestClients.ts +175 -0
  271. package/src/adapters/sqlProviders.ts +14 -0
  272. package/src/apiKeys.integration.spec.ts +19 -119
  273. package/src/apiKeys.spec.ts +39 -35
  274. package/src/apiKeys.ts +2 -8
  275. package/src/assembly/assemblePlugins.ts +269 -0
  276. package/src/assembly/assembly.spec.ts +325 -0
  277. package/src/assembly/assembly.types.spec.ts +155 -0
  278. package/src/assembly/builtInRoutes.spec.ts +213 -0
  279. package/src/assembly/databasePlugins.spec.ts +71 -0
  280. package/src/assembly/databasePlugins.ts +96 -0
  281. package/src/core/api.ts +139 -0
  282. package/src/core/baseCandidates.spec.ts +378 -0
  283. package/src/core/baseCandidates.ts +136 -0
  284. package/src/core/index.ts +44 -0
  285. package/src/core/operations.spec.ts +415 -0
  286. package/src/core/operations.ts +551 -0
  287. package/src/core/reads.spec.ts +300 -0
  288. package/src/core/reads.ts +417 -0
  289. package/src/core/releases.spec.ts +308 -0
  290. package/src/core/releases.ts +345 -0
  291. package/src/core/schema.ts +173 -0
  292. package/src/core/writes.ts +160 -0
  293. package/src/createHotUpdaterCore.ts +191 -181
  294. package/src/database/cursor.ts +65 -0
  295. package/src/database/database.ts +335 -0
  296. package/src/database/database.types.spec.ts +135 -0
  297. package/src/database/definitions.ts +72 -0
  298. package/src/database/engine.ts +62 -0
  299. package/src/database/engineAggregates.spec.ts +539 -0
  300. package/src/database/engineAggregates.ts +193 -0
  301. package/src/database/engineReads.spec.ts +219 -0
  302. package/src/database/engineReads.ts +302 -0
  303. package/src/database/engineTransaction.spec.ts +710 -0
  304. package/src/database/engineTransaction.ts +588 -0
  305. package/src/database/errors.ts +30 -0
  306. package/src/database/fence.spec.ts +223 -0
  307. package/src/database/fence.ts +171 -0
  308. package/src/database/index.ts +154 -0
  309. package/src/database/kv/kvAdapter.conformance.integration.spec.ts +17 -0
  310. package/src/database/kv/kvAdapter.readBudgets.integration.spec.ts +17 -0
  311. package/src/database/kv/kvAdapter.spec.ts +468 -0
  312. package/src/database/kv/kvAdapter.ts +450 -0
  313. package/src/database/kv/kvTestStore.ts +91 -0
  314. package/src/database/memory.readBudgets.integration.spec.ts +13 -0
  315. package/src/database/resolveSchema.spec.ts +230 -0
  316. package/src/database/resolveSchema.ts +372 -0
  317. package/src/database/schema.ts +169 -0
  318. package/src/database/schema.types.spec.ts +94 -0
  319. package/src/database/sql/docker-compose.yml +36 -0
  320. package/src/database/sql/sqlAdapter.integration.spec.ts +148 -0
  321. package/src/database/sql/sqlAdapter.readBudgets.integration.spec.ts +109 -0
  322. package/src/database/sql/sqlAdapter.spec.ts +255 -0
  323. package/src/database/sql/sqlAdapter.ts +532 -0
  324. package/src/database/sql/sqlSchema.ts +205 -0
  325. package/src/database/sql/sqlTestExecutors.ts +183 -0
  326. package/src/databaseTestSuite.spec.ts +39 -0
  327. package/src/db/builtInDatabase.ts +149 -0
  328. package/src/db/bundleRows.spec.ts +3 -3
  329. package/src/db/createBundleDiff.spec.ts +43 -29
  330. package/src/db/createBundleDiff.ts +13 -7
  331. package/src/db/engineDrizzleSchema.ts +72 -0
  332. package/src/db/engineMigrator.ts +105 -0
  333. package/src/db/enginePrismaSchema.ts +147 -0
  334. package/src/db/engineSql.spec.ts +129 -0
  335. package/src/db/engineSql.ts +48 -0
  336. package/src/db/engineSqlMigrator.ts +116 -0
  337. package/src/db/fixedMigratorShared.ts +1 -20
  338. package/src/db/index.spec.ts +116 -829
  339. package/src/db/index.ts +43 -15
  340. package/src/db/pluginTables.spec.ts +218 -0
  341. package/src/db/releaseCatalog.ts +48 -90
  342. package/src/db/schemaSettings.ts +104 -0
  343. package/src/db/settingsMigrator.spec.ts +65 -0
  344. package/src/db/settingsMigrator.ts +152 -0
  345. package/src/db/types.ts +25 -171
  346. package/src/db/updateArtifacts.spec.ts +170 -294
  347. package/src/db/updateArtifacts.ts +74 -142
  348. package/src/db/updateCheck.bench.ts +47 -0
  349. package/src/diff.ts +6 -0
  350. package/src/handler-standalone.integration.spec.ts +204 -410
  351. package/src/handler.spec.ts +134 -51
  352. package/src/handler.testFixtures.ts +14 -19
  353. package/src/handler.ts +163 -75
  354. package/src/handlerAdminRoutes.spec.ts +183 -0
  355. package/src/handlerAdminRoutes.ts +536 -0
  356. package/src/handlerAuth.integration.spec.ts +3 -3
  357. package/src/handlerManagement.spec.ts +136 -196
  358. package/src/handlerReleaseCatalogRoutes.ts +15 -17
  359. package/src/handlerTypes.ts +3 -80
  360. package/src/handlerVersionRoutes.ts +20 -7
  361. package/src/index.ts +5 -12
  362. package/src/insights/domain.ts +12 -0
  363. package/src/insights/errors.spec.ts +48 -0
  364. package/src/insights/errors.ts +51 -0
  365. package/src/insights/eventInput.ts +27 -24
  366. package/src/insights/insights.integration.spec.ts +228 -78
  367. package/src/insights/provider.spec.ts +203 -25
  368. package/src/insights/provider.ts +88 -32
  369. package/src/insights/routes.ts +95 -20
  370. package/src/lintRules.spec.ts +76 -0
  371. package/src/plugins/api-keys/apiKeysPlugin.spec.ts +172 -0
  372. package/src/plugins/api-keys/index.ts +66 -0
  373. package/src/plugins/api-keys/model.ts +69 -0
  374. package/src/plugins/api-keys/schema.ts +22 -0
  375. package/src/plugins/builtIn.ts +5 -0
  376. package/src/plugins/definePlugin.ts +100 -0
  377. package/src/plugins/index.ts +55 -0
  378. package/src/plugins/insights/index.ts +86 -0
  379. package/src/plugins/insights/insightsRollout.integration.spec.ts +187 -0
  380. package/src/plugins/insights/model.spec.ts +66 -0
  381. package/src/plugins/insights/model.ts +19 -0
  382. package/src/plugins/insights/reads.spec.ts +725 -0
  383. package/src/plugins/insights/reads.ts +707 -0
  384. package/src/plugins/insights/recordEvent.spec.ts +443 -0
  385. package/src/plugins/insights/recordEvent.ts +238 -0
  386. package/src/plugins/insights/schema.ts +229 -0
  387. package/src/plugins/pluginTestHarness.spec.ts +56 -0
  388. package/src/readBudgets.testFixtures.ts +15 -0
  389. package/src/releaseCatalogRoutes.integration.spec.ts +47 -92
  390. package/src/runtime.spec.ts +91 -77
  391. package/src/runtime.testFixtures.ts +28 -44
  392. package/src/runtimeBundles.integration.spec.ts +112 -0
  393. package/src/testUtilsMutation.integration.spec.ts +215 -0
  394. package/src/testUtilsPackage.integration.spec.ts +176 -0
  395. package/src/types/index.ts +0 -32
  396. package/dist/adapters/databaseConstraintErrors.cjs +0 -22
  397. package/dist/adapters/databaseConstraintErrors.mjs +0 -21
  398. package/dist/adapters/databasePluginUtils.cjs +0 -130
  399. package/dist/adapters/databasePluginUtils.mjs +0 -118
  400. package/dist/adapters/drizzleCrud.cjs +0 -340
  401. package/dist/adapters/drizzleCrud.mjs +0 -337
  402. package/dist/adapters/drizzleLazyDB.cjs +0 -103
  403. package/dist/adapters/drizzleLazyDB.mjs +0 -103
  404. package/dist/adapters/drizzleQuery.cjs +0 -69
  405. package/dist/adapters/drizzleQuery.mjs +0 -69
  406. package/dist/adapters/kyselyCrud.cjs +0 -293
  407. package/dist/adapters/kyselyCrud.mjs +0 -292
  408. package/dist/adapters/kyselyQuery.cjs +0 -56
  409. package/dist/adapters/kyselyQuery.mjs +0 -56
  410. package/dist/adapters/mongodbCollections.cjs +0 -38
  411. package/dist/adapters/mongodbCollections.mjs +0 -32
  412. package/dist/adapters/mongodbQuery.cjs +0 -90
  413. package/dist/adapters/mongodbQuery.mjs +0 -83
  414. package/dist/adapters/mongodbReads.cjs +0 -206
  415. package/dist/adapters/mongodbReads.mjs +0 -206
  416. package/dist/adapters/mongodbWrites.cjs +0 -133
  417. package/dist/adapters/mongodbWrites.mjs +0 -133
  418. package/dist/adapters/prismaInsights.cjs +0 -99
  419. package/dist/adapters/prismaInsights.mjs +0 -97
  420. package/dist/adapters/prismaQuery.cjs +0 -57
  421. package/dist/adapters/prismaQuery.mjs +0 -56
  422. package/dist/adapters/prismaRows.cjs +0 -197
  423. package/dist/adapters/prismaRows.mjs +0 -188
  424. package/dist/db/databasePluginCore.cjs +0 -137
  425. package/dist/db/databasePluginCore.mjs +0 -137
  426. package/dist/db/fixedMigrator.cjs +0 -79
  427. package/dist/db/fixedMigrator.mjs +0 -78
  428. package/dist/db/fixedMigratorMongo.cjs +0 -321
  429. package/dist/db/fixedMigratorMongo.mjs +0 -321
  430. package/dist/db/mongoMigrationExecution.cjs +0 -11
  431. package/dist/db/mongoMigrationExecution.mjs +0 -11
  432. package/dist/db/schema/insightsCollation.cjs +0 -14
  433. package/dist/db/schema/insightsCollation.mjs +0 -14
  434. package/dist/db/schema/mongodb.cjs +0 -25
  435. package/dist/db/schema/mongodb.mjs +0 -25
  436. package/dist/db/schema/registry.cjs +0 -21
  437. package/dist/db/schema/registry.mjs +0 -17
  438. package/dist/db/schema/sql.cjs +0 -105
  439. package/dist/db/schema/sql.mjs +0 -97
  440. package/dist/db/schema/sqlOperations.cjs +0 -27
  441. package/dist/db/schema/sqlOperations.mjs +0 -26
  442. package/dist/db/schemaGenerators.cjs +0 -276
  443. package/dist/db/schemaGenerators.mjs +0 -274
  444. package/dist/db/schemaReadiness.cjs +0 -26
  445. package/dist/db/schemaReadiness.d.cts +0 -9
  446. package/dist/db/schemaReadiness.d.mts +0 -9
  447. package/dist/db/schemaReadiness.mjs +0 -25
  448. package/dist/db/sqlMigrationExecution.cjs +0 -67
  449. package/dist/db/sqlMigrationExecution.mjs +0 -67
  450. package/dist/handlerBundleRoutes.cjs +0 -155
  451. package/dist/handlerBundleRoutes.mjs +0 -155
  452. package/dist/handlerReleaseManagementRoutes.cjs +0 -124
  453. package/dist/handlerReleaseManagementRoutes.mjs +0 -124
  454. package/dist/schema/dsl.cjs +0 -103
  455. package/dist/schema/dsl.mjs +0 -87
  456. package/dist/schema/index.cjs +0 -20
  457. package/dist/schema/index.mjs +0 -7
  458. package/dist/schema/settings.cjs +0 -9
  459. package/dist/schema/settings.mjs +0 -9
  460. package/dist/schema/types.cjs +0 -8
  461. package/dist/schema/types.mjs +0 -6
  462. package/dist/schema/v1_0_0.cjs +0 -393
  463. package/dist/schema/v1_0_0.mjs +0 -385
  464. package/src/adapters/databaseConstraintErrors.ts +0 -25
  465. package/src/adapters/databasePluginTestDatabase.ts +0 -116
  466. package/src/adapters/databasePluginUtils.spec.ts +0 -29
  467. package/src/adapters/databasePluginUtils.ts +0 -238
  468. package/src/adapters/drizzleCrud.ts +0 -610
  469. package/src/adapters/drizzleLazyDB.ts +0 -284
  470. package/src/adapters/drizzleQuery.ts +0 -164
  471. package/src/adapters/kyselyCrud.ts +0 -696
  472. package/src/adapters/kyselyInsights.spec.ts +0 -168
  473. package/src/adapters/kyselyQuery.ts +0 -128
  474. package/src/adapters/mongodb.spec.ts +0 -230
  475. package/src/adapters/mongodbCollections.ts +0 -78
  476. package/src/adapters/mongodbQuery.ts +0 -245
  477. package/src/adapters/mongodbReads.ts +0 -387
  478. package/src/adapters/mongodbRows.spec.ts +0 -64
  479. package/src/adapters/mongodbRows.ts +0 -118
  480. package/src/adapters/mongodbTestClient.ts +0 -443
  481. package/src/adapters/mongodbTestFilter.ts +0 -170
  482. package/src/adapters/mongodbWrites.ts +0 -261
  483. package/src/adapters/prismaInsights.ts +0 -190
  484. package/src/adapters/prismaQuery.ts +0 -129
  485. package/src/adapters/prismaRows.spec.ts +0 -98
  486. package/src/adapters/prismaRows.ts +0 -308
  487. package/src/adapters/prismaTestClient.ts +0 -478
  488. package/src/calculatePagination.ts +0 -34
  489. package/src/db/databasePluginCore.spec.ts +0 -62
  490. package/src/db/databasePluginCore.testFixtures.ts +0 -76
  491. package/src/db/databasePluginCore.ts +0 -185
  492. package/src/db/databasePluginUpdateCheck.bench.ts +0 -117
  493. package/src/db/fixedMigrator.spec.ts +0 -294
  494. package/src/db/fixedMigrator.ts +0 -147
  495. package/src/db/fixedMigratorMongo.spec.ts +0 -253
  496. package/src/db/fixedMigratorMongo.ts +0 -425
  497. package/src/db/hotUpdaterSchema.ts +0 -5
  498. package/src/db/mongoMigrationExecution.ts +0 -23
  499. package/src/db/schema/definitions.ts +0 -1
  500. package/src/db/schema/insightsCollation.ts +0 -21
  501. package/src/db/schema/mongodb.ts +0 -40
  502. package/src/db/schema/registry.ts +0 -55
  503. package/src/db/schema/sql.ts +0 -244
  504. package/src/db/schema/sqlOperations.ts +0 -63
  505. package/src/db/schema/types.ts +0 -1
  506. package/src/db/schemaGenerators.ts +0 -495
  507. package/src/db/schemaReadiness.ts +0 -34
  508. package/src/db/sqlMigrationExecution.spec.ts +0 -65
  509. package/src/db/sqlMigrationExecution.ts +0 -108
  510. package/src/db/types.spec.ts +0 -63
  511. package/src/handlerBundleRoutes.ts +0 -259
  512. package/src/handlerReleaseManagementRoutes.ts +0 -213
  513. package/src/schema/dsl-all-versions.spec.ts +0 -35
  514. package/src/schema/dsl.ts +0 -187
  515. package/src/schema/index.ts +0 -10
  516. package/src/schema/settings.ts +0 -15
  517. package/src/schema/types.ts +0 -79
  518. package/src/schema/v1_0_0.spec.ts +0 -220
  519. package/src/schema/v1_0_0.ts +0 -511
@@ -0,0 +1,147 @@
1
+ const require_resolveSchema = require("../database/resolveSchema.cjs");
2
+ const require_database = require("../database/database.cjs");
3
+ const require_reads = require("../core/reads.cjs");
4
+ const require_schema = require("../core/schema.cjs");
5
+ const require_api = require("../core/api.cjs");
6
+ const require_fence = require("../database/fence.cjs");
7
+ const require_builtIn = require("../plugins/builtIn.cjs");
8
+ const require_builtInDatabase = require("../db/builtInDatabase.cjs");
9
+ //#region src/assembly/assemblePlugins.ts
10
+ /** A misconfigured `createHotUpdater` call, reported at startup. */
11
+ var HotUpdaterConfigError = class extends Error {
12
+ name = "HotUpdaterConfigError";
13
+ };
14
+ const PLUGIN_KEYS = /* @__PURE__ */ new Set([
15
+ "id",
16
+ "provides",
17
+ "schemaVersion",
18
+ "schema",
19
+ "init"
20
+ ]);
21
+ const INSTANCE_KEYS = /* @__PURE__ */ new Set([
22
+ "api",
23
+ "endpoints",
24
+ "clientAuth"
25
+ ]);
26
+ const METHODS = /* @__PURE__ */ new Set([
27
+ "GET",
28
+ "POST",
29
+ "PUT",
30
+ "PATCH",
31
+ "DELETE"
32
+ ]);
33
+ const BUILT_IN_ID = /^[a-z][A-Za-z0-9]*$/u;
34
+ const PLUGIN_ID = /^[a-z][a-z0-9_]*$/u;
35
+ const PATH = /^(\/(:?[A-Za-z0-9_.~-]+))+$/u;
36
+ const fail = (message) => {
37
+ throw new HotUpdaterConfigError(message);
38
+ };
39
+ const isRecord = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
40
+ const checkPlugin = (value, at) => {
41
+ if (!isRecord(value)) return fail(`${at} is not a plugin.`);
42
+ if ("kind" in value) fail(`${at} has a kind; core is built in and is never passed as a plugin.`);
43
+ const unknown = Object.keys(value).find((key) => !PLUGIN_KEYS.has(key));
44
+ if (unknown !== void 0) fail(`${at} has an unknown key "${unknown}".`);
45
+ const plugin = value;
46
+ const pattern = plugin[require_builtIn.builtInPlugin] ? BUILT_IN_ID : PLUGIN_ID;
47
+ if (typeof plugin.id !== "string" || !pattern.test(plugin.id)) fail(`${at} needs an id matching ${pattern.source}.`);
48
+ if (plugin.id === require_schema.coreModule.id) fail(`${at} uses the id "core", which is core's own.`);
49
+ if (typeof plugin.schemaVersion !== "string" || !isRecord(plugin.schema) || typeof plugin.init !== "function") fail(`Plugin "${plugin.id}" needs a schemaVersion, a schema, and init.`);
50
+ const provides = plugin.provides;
51
+ if (provides !== void 0 && (!isRecord(provides) || Object.entries(provides).some(([key, flag]) => key !== "clientAuth" || flag !== true))) fail(`Plugin "${plugin.id}" may only declare provides: { clientAuth: true }.`);
52
+ return plugin;
53
+ };
54
+ const checkEndpoint = (id, value) => {
55
+ const endpoint = isRecord(value) ? value : {};
56
+ if (!METHODS.has(endpoint.method) || typeof endpoint.path !== "string" || !PATH.test(endpoint.path) || endpoint.access !== "client" && endpoint.access !== "admin" || typeof endpoint.handler !== "function") fail(`Plugin "${id}" has an endpoint that needs a method, a path like /name/:param, access "client" or "admin", and a handler.`);
57
+ return {
58
+ ...endpoint,
59
+ plugin: id
60
+ };
61
+ };
62
+ const checkInstance = (plugin, instance) => {
63
+ const { id } = plugin;
64
+ if (!isRecord(instance)) return fail(`Plugin "${id}" init returned no instance.`);
65
+ if (typeof instance.then === "function") fail(`Plugin "${id}" init returned a promise; init must be synchronous.`);
66
+ const unknown = Object.keys(instance).find((key) => !INSTANCE_KEYS.has(key));
67
+ if (unknown !== void 0 || !("api" in instance)) fail(`Plugin "${id}" init must return { api, endpoints?, clientAuth? }${unknown === void 0 ? "" : `, not "${unknown}"`}.`);
68
+ const declared = plugin.provides?.clientAuth === true;
69
+ const clientAuth = instance.clientAuth;
70
+ if (declared !== (clientAuth !== void 0)) fail(declared ? `Plugin "${id}" declares provides: { clientAuth: true } but its instance has no clientAuth.` : `Plugin "${id}" returns clientAuth without declaring provides: { clientAuth: true }.`);
71
+ if (clientAuth !== void 0 && (typeof clientAuth.authenticate !== "function" || !Array.isArray(clientAuth.varyHeaders) || !clientAuth.varyHeaders.every((header) => typeof header === "string"))) fail(`Plugin "${id}" clientAuth needs varyHeaders and authenticate.`);
72
+ const endpoints = instance.endpoints ?? [];
73
+ if (!Array.isArray(endpoints)) fail(`Plugin "${id}" endpoints must be an array.`);
74
+ return {
75
+ api: instance.api,
76
+ clientAuth,
77
+ endpoints: endpoints.map((endpoint) => checkEndpoint(id, endpoint))
78
+ };
79
+ };
80
+ /**
81
+ * Checks every plugin, runs each `init` once against one engine over the
82
+ * database's storage adapter, and collects APIs, endpoints, and clientAuth.
83
+ * Core's reads run on the same engine, so plugins read core through `ctx.core`.
84
+ */
85
+ const assemblePlugins = (value, adapter, { now = Date.now, storage = { resolveFileUrl: async () => null }, verify = false, onCachedRoutesChange } = {}) => {
86
+ if (!Array.isArray(value)) return fail("plugins must be an array of plugins.");
87
+ const plugins = value.map((plugin, position) => checkPlugin(plugin, `plugins[${position}]`));
88
+ const ids = /* @__PURE__ */ new Set();
89
+ for (const { id } of plugins) {
90
+ if (ids.has(id)) fail(`Plugin "${id}" is registered twice.`);
91
+ ids.add(id);
92
+ }
93
+ const modules = plugins.map((plugin) => ({
94
+ id: plugin.id,
95
+ schema: plugin.schema,
96
+ ...plugin[require_builtIn.builtInPlugin] ? {} : { namespace: plugin.id }
97
+ }));
98
+ const added = modules.filter(({ namespace }) => namespace !== void 0);
99
+ if (added.length > 0) {
100
+ const taken = added.find(({ id }) => require_builtInDatabase.builtInModules.some((module) => module.id === id));
101
+ if (taken !== void 0) fail(`Plugin "${taken.id}" uses a built-in plugin's id.`);
102
+ require_resolveSchema.validateSchema([...require_builtInDatabase.builtInModules, ...added]);
103
+ }
104
+ const name = require_fence.fencedName(adapter);
105
+ const engine = require_database.createDatabaseEngine({
106
+ adapter: name === void 0 || added.length === 0 ? adapter : require_fence.withSchemaFence(adapter, name, require_builtInDatabase.addedSettings(plugins)),
107
+ schema: require_resolveSchema.resolveSchema([require_schema.coreModule, ...modules]),
108
+ verify
109
+ });
110
+ const coreDatabase = engine.database(require_schema.coreModule);
111
+ const core = require_api.createCoreApi(coreDatabase, storage, {
112
+ now,
113
+ ...onCachedRoutesChange === void 0 ? {} : { onCachedRoutesChange }
114
+ });
115
+ const reads = require_reads.createCoreReads(coreDatabase, storage);
116
+ const api = {};
117
+ const endpoints = [];
118
+ let clientAuth;
119
+ plugins.forEach((plugin, position) => {
120
+ const instance = checkInstance(plugin, plugin.init({
121
+ db: engine.database(modules[position]),
122
+ core: reads,
123
+ now
124
+ }));
125
+ if (instance.clientAuth !== void 0) {
126
+ if (clientAuth !== void 0) fail(`Plugins "${clientAuth.plugin}" and "${plugin.id}" both provide clientAuth; keep one.`);
127
+ const provided = instance.clientAuth;
128
+ clientAuth = {
129
+ plugin: plugin.id,
130
+ varyHeaders: provided.varyHeaders,
131
+ authenticate: (headers) => provided.authenticate(headers)
132
+ };
133
+ }
134
+ endpoints.push(...instance.endpoints);
135
+ api[plugin.id] = instance.api;
136
+ });
137
+ return {
138
+ core,
139
+ api,
140
+ endpoints,
141
+ ...clientAuth === void 0 ? {} : { clientAuth },
142
+ ...verify ? { measureReads: engine.measureReads } : {}
143
+ };
144
+ };
145
+ //#endregion
146
+ exports.HotUpdaterConfigError = HotUpdaterConfigError;
147
+ exports.assemblePlugins = assemblePlugins;
@@ -0,0 +1,12 @@
1
+ import "../database/engine.cjs";
2
+ import "../core/reads.cjs";
3
+ import "../core/api.cjs";
4
+ import "../plugins/definePlugin.cjs";
5
+ import { DatabaseAdapter } from "@hot-updater/plugin-core/internal";
6
+ //#region src/assembly/assemblePlugins.d.ts
7
+ /** A misconfigured `createHotUpdater` call, reported at startup. */
8
+ declare class HotUpdaterConfigError extends Error {
9
+ readonly name = "HotUpdaterConfigError";
10
+ }
11
+ //#endregion
12
+ export { HotUpdaterConfigError };
@@ -0,0 +1,12 @@
1
+ import "../database/engine.mjs";
2
+ import "../core/reads.mjs";
3
+ import "../core/api.mjs";
4
+ import "../plugins/definePlugin.mjs";
5
+ import { DatabaseAdapter } from "@hot-updater/plugin-core/internal";
6
+ //#region src/assembly/assemblePlugins.d.ts
7
+ /** A misconfigured `createHotUpdater` call, reported at startup. */
8
+ declare class HotUpdaterConfigError extends Error {
9
+ readonly name = "HotUpdaterConfigError";
10
+ }
11
+ //#endregion
12
+ export { HotUpdaterConfigError };
@@ -0,0 +1,146 @@
1
+ import { resolveSchema, validateSchema } from "../database/resolveSchema.mjs";
2
+ import { createDatabaseEngine } from "../database/database.mjs";
3
+ import { createCoreReads } from "../core/reads.mjs";
4
+ import { coreModule } from "../core/schema.mjs";
5
+ import { createCoreApi } from "../core/api.mjs";
6
+ import { fencedName, withSchemaFence } from "../database/fence.mjs";
7
+ import { builtInPlugin } from "../plugins/builtIn.mjs";
8
+ import { addedSettings, builtInModules } from "../db/builtInDatabase.mjs";
9
+ //#region src/assembly/assemblePlugins.ts
10
+ /** A misconfigured `createHotUpdater` call, reported at startup. */
11
+ var HotUpdaterConfigError = class extends Error {
12
+ name = "HotUpdaterConfigError";
13
+ };
14
+ const PLUGIN_KEYS = /* @__PURE__ */ new Set([
15
+ "id",
16
+ "provides",
17
+ "schemaVersion",
18
+ "schema",
19
+ "init"
20
+ ]);
21
+ const INSTANCE_KEYS = /* @__PURE__ */ new Set([
22
+ "api",
23
+ "endpoints",
24
+ "clientAuth"
25
+ ]);
26
+ const METHODS = /* @__PURE__ */ new Set([
27
+ "GET",
28
+ "POST",
29
+ "PUT",
30
+ "PATCH",
31
+ "DELETE"
32
+ ]);
33
+ const BUILT_IN_ID = /^[a-z][A-Za-z0-9]*$/u;
34
+ const PLUGIN_ID = /^[a-z][a-z0-9_]*$/u;
35
+ const PATH = /^(\/(:?[A-Za-z0-9_.~-]+))+$/u;
36
+ const fail = (message) => {
37
+ throw new HotUpdaterConfigError(message);
38
+ };
39
+ const isRecord = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
40
+ const checkPlugin = (value, at) => {
41
+ if (!isRecord(value)) return fail(`${at} is not a plugin.`);
42
+ if ("kind" in value) fail(`${at} has a kind; core is built in and is never passed as a plugin.`);
43
+ const unknown = Object.keys(value).find((key) => !PLUGIN_KEYS.has(key));
44
+ if (unknown !== void 0) fail(`${at} has an unknown key "${unknown}".`);
45
+ const plugin = value;
46
+ const pattern = plugin[builtInPlugin] ? BUILT_IN_ID : PLUGIN_ID;
47
+ if (typeof plugin.id !== "string" || !pattern.test(plugin.id)) fail(`${at} needs an id matching ${pattern.source}.`);
48
+ if (plugin.id === coreModule.id) fail(`${at} uses the id "core", which is core's own.`);
49
+ if (typeof plugin.schemaVersion !== "string" || !isRecord(plugin.schema) || typeof plugin.init !== "function") fail(`Plugin "${plugin.id}" needs a schemaVersion, a schema, and init.`);
50
+ const provides = plugin.provides;
51
+ if (provides !== void 0 && (!isRecord(provides) || Object.entries(provides).some(([key, flag]) => key !== "clientAuth" || flag !== true))) fail(`Plugin "${plugin.id}" may only declare provides: { clientAuth: true }.`);
52
+ return plugin;
53
+ };
54
+ const checkEndpoint = (id, value) => {
55
+ const endpoint = isRecord(value) ? value : {};
56
+ if (!METHODS.has(endpoint.method) || typeof endpoint.path !== "string" || !PATH.test(endpoint.path) || endpoint.access !== "client" && endpoint.access !== "admin" || typeof endpoint.handler !== "function") fail(`Plugin "${id}" has an endpoint that needs a method, a path like /name/:param, access "client" or "admin", and a handler.`);
57
+ return {
58
+ ...endpoint,
59
+ plugin: id
60
+ };
61
+ };
62
+ const checkInstance = (plugin, instance) => {
63
+ const { id } = plugin;
64
+ if (!isRecord(instance)) return fail(`Plugin "${id}" init returned no instance.`);
65
+ if (typeof instance.then === "function") fail(`Plugin "${id}" init returned a promise; init must be synchronous.`);
66
+ const unknown = Object.keys(instance).find((key) => !INSTANCE_KEYS.has(key));
67
+ if (unknown !== void 0 || !("api" in instance)) fail(`Plugin "${id}" init must return { api, endpoints?, clientAuth? }${unknown === void 0 ? "" : `, not "${unknown}"`}.`);
68
+ const declared = plugin.provides?.clientAuth === true;
69
+ const clientAuth = instance.clientAuth;
70
+ if (declared !== (clientAuth !== void 0)) fail(declared ? `Plugin "${id}" declares provides: { clientAuth: true } but its instance has no clientAuth.` : `Plugin "${id}" returns clientAuth without declaring provides: { clientAuth: true }.`);
71
+ if (clientAuth !== void 0 && (typeof clientAuth.authenticate !== "function" || !Array.isArray(clientAuth.varyHeaders) || !clientAuth.varyHeaders.every((header) => typeof header === "string"))) fail(`Plugin "${id}" clientAuth needs varyHeaders and authenticate.`);
72
+ const endpoints = instance.endpoints ?? [];
73
+ if (!Array.isArray(endpoints)) fail(`Plugin "${id}" endpoints must be an array.`);
74
+ return {
75
+ api: instance.api,
76
+ clientAuth,
77
+ endpoints: endpoints.map((endpoint) => checkEndpoint(id, endpoint))
78
+ };
79
+ };
80
+ /**
81
+ * Checks every plugin, runs each `init` once against one engine over the
82
+ * database's storage adapter, and collects APIs, endpoints, and clientAuth.
83
+ * Core's reads run on the same engine, so plugins read core through `ctx.core`.
84
+ */
85
+ const assemblePlugins = (value, adapter, { now = Date.now, storage = { resolveFileUrl: async () => null }, verify = false, onCachedRoutesChange } = {}) => {
86
+ if (!Array.isArray(value)) return fail("plugins must be an array of plugins.");
87
+ const plugins = value.map((plugin, position) => checkPlugin(plugin, `plugins[${position}]`));
88
+ const ids = /* @__PURE__ */ new Set();
89
+ for (const { id } of plugins) {
90
+ if (ids.has(id)) fail(`Plugin "${id}" is registered twice.`);
91
+ ids.add(id);
92
+ }
93
+ const modules = plugins.map((plugin) => ({
94
+ id: plugin.id,
95
+ schema: plugin.schema,
96
+ ...plugin[builtInPlugin] ? {} : { namespace: plugin.id }
97
+ }));
98
+ const added = modules.filter(({ namespace }) => namespace !== void 0);
99
+ if (added.length > 0) {
100
+ const taken = added.find(({ id }) => builtInModules.some((module) => module.id === id));
101
+ if (taken !== void 0) fail(`Plugin "${taken.id}" uses a built-in plugin's id.`);
102
+ validateSchema([...builtInModules, ...added]);
103
+ }
104
+ const name = fencedName(adapter);
105
+ const engine = createDatabaseEngine({
106
+ adapter: name === void 0 || added.length === 0 ? adapter : withSchemaFence(adapter, name, addedSettings(plugins)),
107
+ schema: resolveSchema([coreModule, ...modules]),
108
+ verify
109
+ });
110
+ const coreDatabase = engine.database(coreModule);
111
+ const core = createCoreApi(coreDatabase, storage, {
112
+ now,
113
+ ...onCachedRoutesChange === void 0 ? {} : { onCachedRoutesChange }
114
+ });
115
+ const reads = createCoreReads(coreDatabase, storage);
116
+ const api = {};
117
+ const endpoints = [];
118
+ let clientAuth;
119
+ plugins.forEach((plugin, position) => {
120
+ const instance = checkInstance(plugin, plugin.init({
121
+ db: engine.database(modules[position]),
122
+ core: reads,
123
+ now
124
+ }));
125
+ if (instance.clientAuth !== void 0) {
126
+ if (clientAuth !== void 0) fail(`Plugins "${clientAuth.plugin}" and "${plugin.id}" both provide clientAuth; keep one.`);
127
+ const provided = instance.clientAuth;
128
+ clientAuth = {
129
+ plugin: plugin.id,
130
+ varyHeaders: provided.varyHeaders,
131
+ authenticate: (headers) => provided.authenticate(headers)
132
+ };
133
+ }
134
+ endpoints.push(...instance.endpoints);
135
+ api[plugin.id] = instance.api;
136
+ });
137
+ return {
138
+ core,
139
+ api,
140
+ endpoints,
141
+ ...clientAuth === void 0 ? {} : { clientAuth },
142
+ ...verify ? { measureReads: engine.measureReads } : {}
143
+ };
144
+ };
145
+ //#endregion
146
+ export { HotUpdaterConfigError, assemblePlugins };
@@ -0,0 +1,23 @@
1
+ const require_api = require("../core/api.cjs");
2
+ const require_assemblePlugins = require("./assemblePlugins.cjs");
3
+ //#region src/assembly/databasePlugins.ts
4
+ function createDatabasePluginApis(database, plugins, options = {}) {
5
+ const adapter = require_api.engineAdapterOf(database);
6
+ if (adapter === void 0) throw new Error(require_api.OFF_ENGINE_DATABASE);
7
+ return require_assemblePlugins.assemblePlugins(plugins, adapter, options).api;
8
+ }
9
+ function createMeasuredDatabase(adapter, plugins, options = {}) {
10
+ const { core, api, clientAuth, measureReads } = require_assemblePlugins.assemblePlugins(plugins, adapter, {
11
+ ...options,
12
+ verify: true
13
+ });
14
+ return {
15
+ core,
16
+ api,
17
+ ...clientAuth === void 0 ? {} : { clientAuth },
18
+ measureReads
19
+ };
20
+ }
21
+ //#endregion
22
+ exports.createDatabasePluginApis = createDatabasePluginApis;
23
+ exports.createMeasuredDatabase = createMeasuredDatabase;
@@ -0,0 +1,43 @@
1
+ import { ReadMeasurement } from "../database/engine.cjs";
2
+ import { CoreStorage } from "../core/reads.cjs";
3
+ import { CoreApi } from "../core/api.cjs";
4
+ import { AnyHotUpdaterPlugin, ClientAuth, PluginApis } from "../plugins/definePlugin.cjs";
5
+ import { DatabaseAdapter } from "@hot-updater/plugin-core/internal";
6
+ //#region src/assembly/databasePlugins.d.ts
7
+ /**
8
+ * The plugins' APIs by plugin id over a configured database, assembled as
9
+ * `createHotUpdater` assembles them: how the console runs Insights and API
10
+ * keys in process, and how init provisions a key, on the tables the server
11
+ * uses. A database off the storage engine, `standaloneRepository` included,
12
+ * is refused: its server runs the plugins.
13
+ */
14
+ declare function createDatabasePluginApis<const TPlugins extends readonly AnyHotUpdaterPlugin[]>(database: unknown, plugins: TPlugins, options?: {
15
+ readonly now?: () => number;
16
+ }): PluginApis<TPlugins>;
17
+ declare function createDatabasePluginApis(database: unknown, plugins: readonly unknown[], options?: {
18
+ readonly now?: () => number;
19
+ }): Readonly<Record<string, unknown>>;
20
+ interface MeasuredDatabaseOptions {
21
+ readonly now?: () => number;
22
+ /** How core reads bundle manifests and resolves file URLs, for artifact resolution. */
23
+ readonly storage?: CoreStorage;
24
+ }
25
+ /** Core and the plugins' APIs on one engine in verify mode, and its read meter. */
26
+ interface MeasuredDatabase<TApi = Readonly<Record<string, unknown>>> {
27
+ readonly core: CoreApi;
28
+ readonly api: TApi;
29
+ /** The client-route policy, when a plugin provides one. */
30
+ readonly clientAuth?: ClientAuth;
31
+ /** Runs `read` and reports what it read at both boundaries. */
32
+ measureReads<T>(read: () => Promise<T>): Promise<ReadMeasurement<T>>;
33
+ }
34
+ /**
35
+ * Core and the plugins over a storage adapter, assembled as
36
+ * `createHotUpdater` assembles them but on an engine in verify mode, with
37
+ * that engine's `measureReads`: what read-budget suites measure. The adapter
38
+ * runs as given, without the schema fence.
39
+ */
40
+ declare function createMeasuredDatabase<const TPlugins extends readonly AnyHotUpdaterPlugin[]>(adapter: DatabaseAdapter, plugins: TPlugins, options?: MeasuredDatabaseOptions): MeasuredDatabase<PluginApis<TPlugins>>;
41
+ declare function createMeasuredDatabase(adapter: DatabaseAdapter, plugins: readonly unknown[], options?: MeasuredDatabaseOptions): MeasuredDatabase;
42
+ //#endregion
43
+ export { MeasuredDatabase, MeasuredDatabaseOptions, createDatabasePluginApis, createMeasuredDatabase };
@@ -0,0 +1,43 @@
1
+ import { ReadMeasurement } from "../database/engine.mjs";
2
+ import { CoreStorage } from "../core/reads.mjs";
3
+ import { CoreApi } from "../core/api.mjs";
4
+ import { AnyHotUpdaterPlugin, ClientAuth, PluginApis } from "../plugins/definePlugin.mjs";
5
+ import { DatabaseAdapter } from "@hot-updater/plugin-core/internal";
6
+ //#region src/assembly/databasePlugins.d.ts
7
+ /**
8
+ * The plugins' APIs by plugin id over a configured database, assembled as
9
+ * `createHotUpdater` assembles them: how the console runs Insights and API
10
+ * keys in process, and how init provisions a key, on the tables the server
11
+ * uses. A database off the storage engine, `standaloneRepository` included,
12
+ * is refused: its server runs the plugins.
13
+ */
14
+ declare function createDatabasePluginApis<const TPlugins extends readonly AnyHotUpdaterPlugin[]>(database: unknown, plugins: TPlugins, options?: {
15
+ readonly now?: () => number;
16
+ }): PluginApis<TPlugins>;
17
+ declare function createDatabasePluginApis(database: unknown, plugins: readonly unknown[], options?: {
18
+ readonly now?: () => number;
19
+ }): Readonly<Record<string, unknown>>;
20
+ interface MeasuredDatabaseOptions {
21
+ readonly now?: () => number;
22
+ /** How core reads bundle manifests and resolves file URLs, for artifact resolution. */
23
+ readonly storage?: CoreStorage;
24
+ }
25
+ /** Core and the plugins' APIs on one engine in verify mode, and its read meter. */
26
+ interface MeasuredDatabase<TApi = Readonly<Record<string, unknown>>> {
27
+ readonly core: CoreApi;
28
+ readonly api: TApi;
29
+ /** The client-route policy, when a plugin provides one. */
30
+ readonly clientAuth?: ClientAuth;
31
+ /** Runs `read` and reports what it read at both boundaries. */
32
+ measureReads<T>(read: () => Promise<T>): Promise<ReadMeasurement<T>>;
33
+ }
34
+ /**
35
+ * Core and the plugins over a storage adapter, assembled as
36
+ * `createHotUpdater` assembles them but on an engine in verify mode, with
37
+ * that engine's `measureReads`: what read-budget suites measure. The adapter
38
+ * runs as given, without the schema fence.
39
+ */
40
+ declare function createMeasuredDatabase<const TPlugins extends readonly AnyHotUpdaterPlugin[]>(adapter: DatabaseAdapter, plugins: TPlugins, options?: MeasuredDatabaseOptions): MeasuredDatabase<PluginApis<TPlugins>>;
41
+ declare function createMeasuredDatabase(adapter: DatabaseAdapter, plugins: readonly unknown[], options?: MeasuredDatabaseOptions): MeasuredDatabase;
42
+ //#endregion
43
+ export { MeasuredDatabase, MeasuredDatabaseOptions, createDatabasePluginApis, createMeasuredDatabase };
@@ -0,0 +1,22 @@
1
+ import { OFF_ENGINE_DATABASE, engineAdapterOf } from "../core/api.mjs";
2
+ import { assemblePlugins } from "./assemblePlugins.mjs";
3
+ //#region src/assembly/databasePlugins.ts
4
+ function createDatabasePluginApis(database, plugins, options = {}) {
5
+ const adapter = engineAdapterOf(database);
6
+ if (adapter === void 0) throw new Error(OFF_ENGINE_DATABASE);
7
+ return assemblePlugins(plugins, adapter, options).api;
8
+ }
9
+ function createMeasuredDatabase(adapter, plugins, options = {}) {
10
+ const { core, api, clientAuth, measureReads } = assemblePlugins(plugins, adapter, {
11
+ ...options,
12
+ verify: true
13
+ });
14
+ return {
15
+ core,
16
+ api,
17
+ ...clientAuth === void 0 ? {} : { clientAuth },
18
+ measureReads
19
+ };
20
+ }
21
+ //#endregion
22
+ export { createDatabasePluginApis, createMeasuredDatabase };
@@ -0,0 +1,91 @@
1
+ const require_resolveSchema = require("../database/resolveSchema.cjs");
2
+ const require_database = require("../database/database.cjs");
3
+ const require_reads = require("./reads.cjs");
4
+ const require_operations = require("./operations.cjs");
5
+ const require_schema = require("./schema.cjs");
6
+ //#region src/core/api.ts
7
+ /**
8
+ * The update check answers from one Release Catalog row, so a transaction
9
+ * changes what the cacheable client routes answer only when it writes one.
10
+ * The purge runs once, after the attempt that commits.
11
+ */
12
+ const purgingCachedRoutes = (db, onCachedRoutesChange) => {
13
+ if (onCachedRoutesChange === void 0) return db;
14
+ return {
15
+ ...db,
16
+ async transaction(fn) {
17
+ let changed = false;
18
+ const result = await db.transaction((tx) => {
19
+ changed = false;
20
+ return fn({
21
+ ...tx,
22
+ create: (model, row) => {
23
+ changed ||= model === "release_catalogs";
24
+ tx.create(model, row);
25
+ },
26
+ update: (model, row, set) => {
27
+ changed ||= model === "release_catalogs";
28
+ tx.update(model, row, set);
29
+ },
30
+ delete: (model, row) => {
31
+ changed ||= model === "release_catalogs";
32
+ return tx.delete(model, row);
33
+ }
34
+ });
35
+ });
36
+ if (changed) await onCachedRoutesChange();
37
+ return result;
38
+ }
39
+ };
40
+ };
41
+ /** Core's reads and typed writes over one database handle. */
42
+ const createCoreApi = (db, storage, options = {}) => {
43
+ const reads = require_reads.createCoreReads(db, storage);
44
+ return {
45
+ ...reads,
46
+ ...require_operations.createCoreOperations(purgingCachedRoutes(db, options.onCachedRoutesChange), options),
47
+ /** One read, which checks the schema settings first. */
48
+ ready: async () => {
49
+ await reads.listReleaseCatalogs({ limit: 1 });
50
+ }
51
+ };
52
+ };
53
+ /**
54
+ * Core's API in process, on a database's storage adapter: how the CLI reads
55
+ * and writes a database that runs on the storage engine.
56
+ */
57
+ const createInProcessCoreApi = (adapter, options = {}) => createCoreApi(require_database.createDatabaseEngine({
58
+ adapter,
59
+ schema: require_resolveSchema.resolveSchema([require_schema.coreModule])
60
+ }).database(require_schema.coreModule), { resolveFileUrl: async () => null }, options);
61
+ const isRecord = (value) => typeof value === "object" && value !== null;
62
+ const isAdapter = (value) => isRecord(value) && [
63
+ "fits",
64
+ "get",
65
+ "query",
66
+ "write"
67
+ ].every((method) => typeof value[method] === "function");
68
+ /** The storage adapter a configured database runs on, if it is on the engine. */
69
+ const engineAdapterOf = (database) => isRecord(database) && isAdapter(database.adapter) ? database.adapter : isAdapter(database) ? database : void 0;
70
+ const OFF_ENGINE_DATABASE = "This database does not run on Hot Updater's storage engine. Upgrade its provider package to 1.0.";
71
+ /**
72
+ * Core's API for a configured database, as the CLI uses it: a self-hosted
73
+ * server's admin API when the database is `standaloneRepository`, or the
74
+ * database's own storage adapter, in process.
75
+ */
76
+ const createDatabaseCoreApi = (database, options = {}) => {
77
+ if (isRecord(database) && isRecord(database.core)) return database.core;
78
+ const adapter = engineAdapterOf(database);
79
+ if (adapter === void 0) throw new Error(OFF_ENGINE_DATABASE);
80
+ const engineDatabase = database;
81
+ return createInProcessCoreApi(adapter, {
82
+ ...options,
83
+ ...typeof engineDatabase.onCachedRoutesChange === "function" ? { onCachedRoutesChange: () => engineDatabase.onCachedRoutesChange() } : {}
84
+ });
85
+ };
86
+ //#endregion
87
+ exports.OFF_ENGINE_DATABASE = OFF_ENGINE_DATABASE;
88
+ exports.createCoreApi = createCoreApi;
89
+ exports.createDatabaseCoreApi = createDatabaseCoreApi;
90
+ exports.createInProcessCoreApi = createInProcessCoreApi;
91
+ exports.engineAdapterOf = engineAdapterOf;
@@ -0,0 +1,65 @@
1
+ import { ReleaseCatalogRequest } from "../db/releaseCatalog.cjs";
2
+ import { CoreDatabase, CoreStorage } from "./reads.cjs";
3
+ import { HotUpdaterCoreApi } from "@hot-updater/plugin-core";
4
+ import { DatabaseAdapter } from "@hot-updater/plugin-core/internal";
5
+ //#region src/core/api.d.ts
6
+ interface CoreApiOptions {
7
+ readonly now?: () => number;
8
+ /** The database's CDN purge, called after a write that changes a Release Catalog. */
9
+ readonly onCachedRoutesChange?: () => Promise<void>;
10
+ }
11
+ /** Core's reads and typed writes over one database handle. */
12
+ declare const createCoreApi: (db: CoreDatabase, storage: CoreStorage, options?: CoreApiOptions) => {
13
+ /** One read, which checks the schema settings first. */
14
+ ready: () => Promise<void>;
15
+ deploy: (deployments: readonly import("@hot-updater/plugin-core").Deployment[]) => Promise<import("@hot-updater/plugin-core").ReleaseCatalogMutationResult[]>;
16
+ updateReleasePolicy: (input: import("@hot-updater/plugin-core").ReleaseTarget & {
17
+ readonly patch: import("@hot-updater/plugin-core").ReleasePolicyPatch;
18
+ }) => Promise<import("@hot-updater/plugin-core").ReleaseCatalogMutationResult>;
19
+ preflightReleasePolicy: (input: import("@hot-updater/plugin-core").ReleaseTarget & {
20
+ readonly patch: import("@hot-updater/plugin-core").ReleasePolicyPatch;
21
+ }) => Promise<import("@hot-updater/plugin-core").ReleaseCatalogMutationPreflight>;
22
+ deleteRelease: (input: import("@hot-updater/plugin-core").ReleaseTarget) => Promise<import("@hot-updater/plugin-core").ReleaseCatalogMutationResult>;
23
+ promoteRelease: (input: import("@hot-updater/plugin-core").ReleaseTarget & {
24
+ readonly targetChannel: string;
25
+ readonly action?: "copy" | "move";
26
+ }) => Promise<import("@hot-updater/plugin-core").PromoteReleaseResult>;
27
+ rebuildReleaseCatalog: (scopeKey: string) => Promise<import("@hot-updater/plugin-core").ReleaseCatalogRebuildResult>;
28
+ preflightReleaseCatalogRebuild: (scopeKey: string) => Promise<import("@hot-updater/plugin-core").ReleaseCatalogRebuildPreflight>;
29
+ ensureChannel: (name: string) => Promise<import("@hot-updater/plugin-core").ChannelRow>;
30
+ deleteChannel: (id: string) => Promise<import("@hot-updater/plugin-core").ChannelDeleteResult>;
31
+ updateBundle: (id: string, update: Partial<Omit<import("@hot-updater/core").Bundle, "id" | "patches">> & {
32
+ readonly patches?: import("@hot-updater/core").Bundle["patches"];
33
+ }) => Promise<void>;
34
+ deleteBundles: (ids: readonly string[]) => Promise<void>;
35
+ getReleaseCatalog(input: ReleaseCatalogRequest): Promise<import("@hot-updater/core").ReleaseCatalog | null>;
36
+ getArtifactInfo(targetBundleId: string, currentBundleId: string, artifactProtocolVersion: 1): Promise<import("@hot-updater/core").ArtifactInfo | null>;
37
+ getBundle(id: string): Promise<import("@hot-updater/plugin-core").BundleDetail | null>;
38
+ countBundleChildren(baseBundleIds: readonly string[]): Promise<Record<string, number>>;
39
+ listPatchesFromBase(baseBundleId: string, input: import("@hot-updater/plugin-core").KeysetInput): Promise<import("@hot-updater/plugin-core").BundlePatchRow[]>;
40
+ listBundles(input: import("@hot-updater/plugin-core").KeysetInput & {
41
+ readonly platform?: "ios" | "android";
42
+ }): Promise<import("@hot-updater/plugin-core").BundleDetail[]>;
43
+ countBundles(platform?: "ios" | "android"): Promise<number>;
44
+ findBaseBundleIds(candidateKey: string, bundleId: string, limit: number): Promise<string[]>;
45
+ getRelease(id: string): Promise<import("@hot-updater/plugin-core").ReleaseRow | null>;
46
+ listReleases(input: import("@hot-updater/plugin-core").KeysetInput & {
47
+ readonly filter: import("@hot-updater/plugin-core").ReleaseFilter;
48
+ }): Promise<import("@hot-updater/plugin-core").ReleaseRow[]>;
49
+ latestReleaseId(scopeKey: string): Promise<string | null>;
50
+ getReleaseCatalogRow(scopeKey: string): Promise<import("@hot-updater/plugin-core").ReleaseCatalogRow | null>;
51
+ listReleaseCatalogs(input: import("@hot-updater/plugin-core").KeysetInput): Promise<import("@hot-updater/plugin-core").ReleaseCatalogRow[]>;
52
+ listChannels(): Promise<import("@hot-updater/plugin-core").ChannelRow[]>;
53
+ findChannelByName(name: string): Promise<import("@hot-updater/plugin-core").ChannelRow | null>;
54
+ };
55
+ type CoreApi = ReturnType<typeof createCoreApi>;
56
+ /**
57
+ * Core's API for a configured database, as the CLI uses it: a self-hosted
58
+ * server's admin API when the database is `standaloneRepository`, or the
59
+ * database's own storage adapter, in process.
60
+ */
61
+ declare const createDatabaseCoreApi: (database: unknown, options?: {
62
+ readonly now?: () => number;
63
+ }) => HotUpdaterCoreApi;
64
+ //#endregion
65
+ export { CoreApi, CoreApiOptions, createCoreApi, createDatabaseCoreApi };