@hot-updater/server 1.0.0-rc.14 → 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 (514) 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 -8
  152. package/dist/db/index.d.cts +10 -3
  153. package/dist/db/index.d.mts +10 -3
  154. package/dist/db/index.mjs +16 -8
  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/handler.cjs +72 -43
  172. package/dist/handler.d.cts +3 -5
  173. package/dist/handler.d.mts +3 -5
  174. package/dist/handler.mjs +73 -43
  175. package/dist/handlerAdminRoutes.cjs +375 -0
  176. package/dist/handlerAdminRoutes.mjs +373 -0
  177. package/dist/handlerParameters.cjs +6 -11
  178. package/dist/handlerParameters.mjs +6 -10
  179. package/dist/handlerReleaseCatalogRoutes.cjs +11 -13
  180. package/dist/handlerReleaseCatalogRoutes.mjs +11 -13
  181. package/dist/handlerTypes.d.cts +2 -55
  182. package/dist/handlerTypes.d.mts +2 -55
  183. package/dist/handlerVersionRoutes.cjs +20 -4
  184. package/dist/handlerVersionRoutes.mjs +20 -4
  185. package/dist/index.cjs +4 -7
  186. package/dist/index.d.cts +8 -7
  187. package/dist/index.d.mts +8 -7
  188. package/dist/index.mjs +4 -4
  189. package/dist/insights/domain.d.cts +12 -0
  190. package/dist/insights/domain.d.mts +12 -0
  191. package/dist/insights/errors.cjs +34 -0
  192. package/dist/insights/errors.mjs +34 -1
  193. package/dist/insights/eventInput.cjs +14 -19
  194. package/dist/insights/eventInput.mjs +15 -20
  195. package/dist/insights/provider.cjs +47 -23
  196. package/dist/insights/provider.mjs +47 -24
  197. package/dist/insights/routes.cjs +79 -14
  198. package/dist/insights/routes.mjs +77 -14
  199. package/dist/node.d.cts +1 -1
  200. package/dist/node.d.mts +1 -1
  201. package/dist/package.cjs +1 -1
  202. package/dist/package.mjs +1 -1
  203. package/dist/plugins/api-keys/index.cjs +50 -0
  204. package/dist/plugins/api-keys/index.d.cts +85 -0
  205. package/dist/plugins/api-keys/index.d.mts +85 -0
  206. package/dist/plugins/api-keys/index.mjs +47 -0
  207. package/dist/plugins/api-keys/model.cjs +58 -0
  208. package/dist/plugins/api-keys/model.d.cts +8 -0
  209. package/dist/plugins/api-keys/model.d.mts +8 -0
  210. package/dist/plugins/api-keys/model.mjs +58 -0
  211. package/dist/plugins/api-keys/schema.cjs +38 -0
  212. package/dist/plugins/api-keys/schema.d.cts +44 -0
  213. package/dist/plugins/api-keys/schema.d.mts +44 -0
  214. package/dist/plugins/api-keys/schema.mjs +39 -0
  215. package/dist/plugins/builtIn.cjs +7 -0
  216. package/dist/plugins/builtIn.mjs +6 -0
  217. package/dist/plugins/definePlugin.cjs +5 -0
  218. package/dist/plugins/definePlugin.d.cts +73 -0
  219. package/dist/plugins/definePlugin.d.mts +73 -0
  220. package/dist/plugins/definePlugin.mjs +5 -0
  221. package/dist/plugins/index.cjs +17 -0
  222. package/dist/plugins/index.d.cts +9 -0
  223. package/dist/plugins/index.d.mts +9 -0
  224. package/dist/plugins/index.mjs +7 -0
  225. package/dist/plugins/insights/index.cjs +48 -0
  226. package/dist/plugins/insights/index.d.cts +295 -0
  227. package/dist/plugins/insights/index.d.mts +295 -0
  228. package/dist/plugins/insights/index.mjs +44 -0
  229. package/dist/plugins/insights/model.cjs +17 -0
  230. package/dist/plugins/insights/model.d.cts +10 -0
  231. package/dist/plugins/insights/model.d.mts +10 -0
  232. package/dist/plugins/insights/model.mjs +17 -0
  233. package/dist/plugins/insights/reads.cjs +471 -0
  234. package/dist/plugins/insights/reads.mjs +466 -0
  235. package/dist/plugins/insights/recordEvent.cjs +135 -0
  236. package/dist/plugins/insights/recordEvent.d.cts +13 -0
  237. package/dist/plugins/insights/recordEvent.d.mts +13 -0
  238. package/dist/plugins/insights/recordEvent.mjs +132 -0
  239. package/dist/plugins/insights/schema.cjs +347 -0
  240. package/dist/plugins/insights/schema.d.cts +258 -0
  241. package/dist/plugins/insights/schema.d.mts +258 -0
  242. package/dist/plugins/insights/schema.mjs +344 -0
  243. package/dist/types/index.d.cts +2 -28
  244. package/dist/types/index.d.mts +2 -28
  245. package/package.json +28 -5
  246. package/src/adapters/drizzle.conformance.integration.spec.ts +34 -0
  247. package/src/adapters/drizzle.readBudgets.integration.spec.ts +41 -0
  248. package/src/adapters/drizzle.spec.ts +270 -399
  249. package/src/adapters/drizzle.ts +48 -140
  250. package/src/adapters/drizzleExecutor.ts +166 -0
  251. package/src/adapters/kysely.conformance.integration.spec.ts +36 -0
  252. package/src/adapters/kysely.readBudgets.integration.spec.ts +42 -0
  253. package/src/adapters/kysely.spec.ts +204 -171
  254. package/src/adapters/kysely.ts +32 -93
  255. package/src/adapters/kyselyExecutor.ts +53 -0
  256. package/src/adapters/mongodb.integration.spec.ts +143 -446
  257. package/src/adapters/mongodb.readBudgets.integration.spec.ts +61 -0
  258. package/src/adapters/mongodb.ts +36 -123
  259. package/src/adapters/mongodbAdapter.ts +293 -0
  260. package/src/adapters/prisma.conformance.integration.spec.ts +36 -0
  261. package/src/adapters/prisma.integration.spec.ts +138 -0
  262. package/src/adapters/prisma.readBudgets.integration.spec.ts +40 -0
  263. package/src/adapters/prisma.spec.ts +216 -433
  264. package/src/adapters/prisma.ts +60 -524
  265. package/src/adapters/prismaExecutor.ts +107 -0
  266. package/src/adapters/prismaTestClients.ts +175 -0
  267. package/src/adapters/sqlProviders.ts +14 -0
  268. package/src/apiKeys.integration.spec.ts +19 -119
  269. package/src/apiKeys.spec.ts +39 -35
  270. package/src/apiKeys.ts +2 -8
  271. package/src/assembly/assemblePlugins.ts +269 -0
  272. package/src/assembly/assembly.spec.ts +325 -0
  273. package/src/assembly/assembly.types.spec.ts +155 -0
  274. package/src/assembly/builtInRoutes.spec.ts +213 -0
  275. package/src/assembly/databasePlugins.spec.ts +71 -0
  276. package/src/assembly/databasePlugins.ts +96 -0
  277. package/src/core/api.ts +139 -0
  278. package/src/core/baseCandidates.spec.ts +378 -0
  279. package/src/core/baseCandidates.ts +136 -0
  280. package/src/core/index.ts +44 -0
  281. package/src/core/operations.spec.ts +415 -0
  282. package/src/core/operations.ts +551 -0
  283. package/src/core/reads.spec.ts +300 -0
  284. package/src/core/reads.ts +417 -0
  285. package/src/core/releases.spec.ts +308 -0
  286. package/src/core/releases.ts +345 -0
  287. package/src/core/schema.ts +173 -0
  288. package/src/core/writes.ts +160 -0
  289. package/src/createHotUpdaterCore.ts +191 -181
  290. package/src/database/cursor.ts +65 -0
  291. package/src/database/database.ts +335 -0
  292. package/src/database/database.types.spec.ts +135 -0
  293. package/src/database/definitions.ts +72 -0
  294. package/src/database/engine.ts +62 -0
  295. package/src/database/engineAggregates.spec.ts +539 -0
  296. package/src/database/engineAggregates.ts +193 -0
  297. package/src/database/engineReads.spec.ts +219 -0
  298. package/src/database/engineReads.ts +302 -0
  299. package/src/database/engineTransaction.spec.ts +710 -0
  300. package/src/database/engineTransaction.ts +588 -0
  301. package/src/database/errors.ts +30 -0
  302. package/src/database/fence.spec.ts +223 -0
  303. package/src/database/fence.ts +171 -0
  304. package/src/database/index.ts +154 -0
  305. package/src/database/kv/kvAdapter.conformance.integration.spec.ts +17 -0
  306. package/src/database/kv/kvAdapter.readBudgets.integration.spec.ts +17 -0
  307. package/src/database/kv/kvAdapter.spec.ts +468 -0
  308. package/src/database/kv/kvAdapter.ts +450 -0
  309. package/src/database/kv/kvTestStore.ts +91 -0
  310. package/src/database/memory.readBudgets.integration.spec.ts +13 -0
  311. package/src/database/resolveSchema.spec.ts +230 -0
  312. package/src/database/resolveSchema.ts +372 -0
  313. package/src/database/schema.ts +169 -0
  314. package/src/database/schema.types.spec.ts +94 -0
  315. package/src/database/sql/docker-compose.yml +36 -0
  316. package/src/database/sql/sqlAdapter.integration.spec.ts +148 -0
  317. package/src/database/sql/sqlAdapter.readBudgets.integration.spec.ts +109 -0
  318. package/src/database/sql/sqlAdapter.spec.ts +255 -0
  319. package/src/database/sql/sqlAdapter.ts +532 -0
  320. package/src/database/sql/sqlSchema.ts +205 -0
  321. package/src/database/sql/sqlTestExecutors.ts +183 -0
  322. package/src/databaseTestSuite.spec.ts +39 -0
  323. package/src/db/builtInDatabase.ts +149 -0
  324. package/src/db/bundleRows.spec.ts +3 -3
  325. package/src/db/createBundleDiff.spec.ts +43 -29
  326. package/src/db/createBundleDiff.ts +13 -7
  327. package/src/db/engineDrizzleSchema.ts +72 -0
  328. package/src/db/engineMigrator.ts +105 -0
  329. package/src/db/enginePrismaSchema.ts +147 -0
  330. package/src/db/engineSql.spec.ts +129 -0
  331. package/src/db/engineSql.ts +48 -0
  332. package/src/db/engineSqlMigrator.ts +116 -0
  333. package/src/db/fixedMigratorShared.ts +1 -20
  334. package/src/db/index.spec.ts +116 -829
  335. package/src/db/index.ts +43 -14
  336. package/src/db/pluginTables.spec.ts +218 -0
  337. package/src/db/releaseCatalog.ts +48 -90
  338. package/src/db/schemaSettings.ts +104 -0
  339. package/src/db/settingsMigrator.spec.ts +65 -0
  340. package/src/db/settingsMigrator.ts +152 -0
  341. package/src/db/types.ts +25 -171
  342. package/src/db/updateArtifacts.spec.ts +170 -294
  343. package/src/db/updateArtifacts.ts +74 -142
  344. package/src/db/updateCheck.bench.ts +47 -0
  345. package/src/handler-standalone.integration.spec.ts +204 -410
  346. package/src/handler.spec.ts +134 -51
  347. package/src/handler.testFixtures.ts +14 -19
  348. package/src/handler.ts +163 -75
  349. package/src/handlerAdminRoutes.spec.ts +183 -0
  350. package/src/handlerAdminRoutes.ts +536 -0
  351. package/src/handlerAuth.integration.spec.ts +3 -3
  352. package/src/handlerManagement.spec.ts +136 -196
  353. package/src/handlerReleaseCatalogRoutes.ts +15 -17
  354. package/src/handlerTypes.ts +3 -80
  355. package/src/handlerVersionRoutes.ts +20 -7
  356. package/src/index.ts +5 -12
  357. package/src/insights/domain.ts +12 -0
  358. package/src/insights/errors.spec.ts +48 -0
  359. package/src/insights/errors.ts +51 -0
  360. package/src/insights/eventInput.ts +27 -24
  361. package/src/insights/insights.integration.spec.ts +228 -78
  362. package/src/insights/provider.spec.ts +203 -25
  363. package/src/insights/provider.ts +88 -32
  364. package/src/insights/routes.ts +95 -20
  365. package/src/lintRules.spec.ts +76 -0
  366. package/src/plugins/api-keys/apiKeysPlugin.spec.ts +172 -0
  367. package/src/plugins/api-keys/index.ts +66 -0
  368. package/src/plugins/api-keys/model.ts +69 -0
  369. package/src/plugins/api-keys/schema.ts +22 -0
  370. package/src/plugins/builtIn.ts +5 -0
  371. package/src/plugins/definePlugin.ts +100 -0
  372. package/src/plugins/index.ts +55 -0
  373. package/src/plugins/insights/index.ts +86 -0
  374. package/src/plugins/insights/insightsRollout.integration.spec.ts +187 -0
  375. package/src/plugins/insights/model.spec.ts +66 -0
  376. package/src/plugins/insights/model.ts +19 -0
  377. package/src/plugins/insights/reads.spec.ts +725 -0
  378. package/src/plugins/insights/reads.ts +707 -0
  379. package/src/plugins/insights/recordEvent.spec.ts +443 -0
  380. package/src/plugins/insights/recordEvent.ts +238 -0
  381. package/src/plugins/insights/schema.ts +229 -0
  382. package/src/plugins/pluginTestHarness.spec.ts +56 -0
  383. package/src/readBudgets.testFixtures.ts +15 -0
  384. package/src/releaseCatalogRoutes.integration.spec.ts +47 -92
  385. package/src/runtime.spec.ts +91 -77
  386. package/src/runtime.testFixtures.ts +28 -44
  387. package/src/runtimeBundles.integration.spec.ts +112 -0
  388. package/src/testUtilsMutation.integration.spec.ts +215 -0
  389. package/src/testUtilsPackage.integration.spec.ts +176 -0
  390. package/src/types/index.ts +0 -32
  391. package/dist/adapters/databaseConstraintErrors.cjs +0 -22
  392. package/dist/adapters/databaseConstraintErrors.mjs +0 -21
  393. package/dist/adapters/databasePluginUtils.cjs +0 -130
  394. package/dist/adapters/databasePluginUtils.mjs +0 -118
  395. package/dist/adapters/drizzleCrud.cjs +0 -340
  396. package/dist/adapters/drizzleCrud.mjs +0 -337
  397. package/dist/adapters/drizzleLazyDB.cjs +0 -103
  398. package/dist/adapters/drizzleLazyDB.mjs +0 -103
  399. package/dist/adapters/drizzleQuery.cjs +0 -69
  400. package/dist/adapters/drizzleQuery.mjs +0 -69
  401. package/dist/adapters/kyselyCrud.cjs +0 -293
  402. package/dist/adapters/kyselyCrud.mjs +0 -292
  403. package/dist/adapters/kyselyQuery.cjs +0 -56
  404. package/dist/adapters/kyselyQuery.mjs +0 -56
  405. package/dist/adapters/mongodbCollections.cjs +0 -38
  406. package/dist/adapters/mongodbCollections.mjs +0 -32
  407. package/dist/adapters/mongodbQuery.cjs +0 -90
  408. package/dist/adapters/mongodbQuery.mjs +0 -83
  409. package/dist/adapters/mongodbReads.cjs +0 -206
  410. package/dist/adapters/mongodbReads.mjs +0 -206
  411. package/dist/adapters/mongodbWrites.cjs +0 -133
  412. package/dist/adapters/mongodbWrites.mjs +0 -133
  413. package/dist/adapters/prismaInsights.cjs +0 -99
  414. package/dist/adapters/prismaInsights.mjs +0 -97
  415. package/dist/adapters/prismaQuery.cjs +0 -57
  416. package/dist/adapters/prismaQuery.mjs +0 -56
  417. package/dist/adapters/prismaRows.cjs +0 -197
  418. package/dist/adapters/prismaRows.mjs +0 -188
  419. package/dist/db/databasePluginCore.cjs +0 -137
  420. package/dist/db/databasePluginCore.mjs +0 -137
  421. package/dist/db/fixedMigrator.cjs +0 -79
  422. package/dist/db/fixedMigrator.mjs +0 -78
  423. package/dist/db/fixedMigratorMongo.cjs +0 -321
  424. package/dist/db/fixedMigratorMongo.mjs +0 -321
  425. package/dist/db/mongoMigrationExecution.cjs +0 -11
  426. package/dist/db/mongoMigrationExecution.mjs +0 -11
  427. package/dist/db/schema/insightsCollation.cjs +0 -14
  428. package/dist/db/schema/insightsCollation.mjs +0 -14
  429. package/dist/db/schema/mongodb.cjs +0 -25
  430. package/dist/db/schema/mongodb.mjs +0 -25
  431. package/dist/db/schema/registry.cjs +0 -21
  432. package/dist/db/schema/registry.mjs +0 -17
  433. package/dist/db/schema/sql.cjs +0 -105
  434. package/dist/db/schema/sql.mjs +0 -97
  435. package/dist/db/schema/sqlOperations.cjs +0 -27
  436. package/dist/db/schema/sqlOperations.mjs +0 -26
  437. package/dist/db/schemaGenerators.cjs +0 -276
  438. package/dist/db/schemaGenerators.mjs +0 -274
  439. package/dist/db/schemaReadiness.cjs +0 -26
  440. package/dist/db/schemaReadiness.d.cts +0 -9
  441. package/dist/db/schemaReadiness.d.mts +0 -9
  442. package/dist/db/schemaReadiness.mjs +0 -25
  443. package/dist/db/sqlMigrationExecution.cjs +0 -67
  444. package/dist/db/sqlMigrationExecution.mjs +0 -67
  445. package/dist/handlerBundleRoutes.cjs +0 -155
  446. package/dist/handlerBundleRoutes.mjs +0 -155
  447. package/dist/handlerReleaseManagementRoutes.cjs +0 -124
  448. package/dist/handlerReleaseManagementRoutes.mjs +0 -124
  449. package/dist/schema/dsl.cjs +0 -103
  450. package/dist/schema/dsl.mjs +0 -87
  451. package/dist/schema/index.cjs +0 -20
  452. package/dist/schema/index.mjs +0 -7
  453. package/dist/schema/settings.cjs +0 -9
  454. package/dist/schema/settings.mjs +0 -9
  455. package/dist/schema/types.cjs +0 -8
  456. package/dist/schema/types.mjs +0 -6
  457. package/dist/schema/v1_0_0.cjs +0 -393
  458. package/dist/schema/v1_0_0.mjs +0 -385
  459. package/src/adapters/databaseConstraintErrors.ts +0 -25
  460. package/src/adapters/databasePluginTestDatabase.ts +0 -116
  461. package/src/adapters/databasePluginUtils.spec.ts +0 -29
  462. package/src/adapters/databasePluginUtils.ts +0 -238
  463. package/src/adapters/drizzleCrud.ts +0 -610
  464. package/src/adapters/drizzleLazyDB.ts +0 -284
  465. package/src/adapters/drizzleQuery.ts +0 -164
  466. package/src/adapters/kyselyCrud.ts +0 -696
  467. package/src/adapters/kyselyInsights.spec.ts +0 -168
  468. package/src/adapters/kyselyQuery.ts +0 -128
  469. package/src/adapters/mongodb.spec.ts +0 -230
  470. package/src/adapters/mongodbCollections.ts +0 -78
  471. package/src/adapters/mongodbQuery.ts +0 -245
  472. package/src/adapters/mongodbReads.ts +0 -387
  473. package/src/adapters/mongodbRows.spec.ts +0 -64
  474. package/src/adapters/mongodbRows.ts +0 -118
  475. package/src/adapters/mongodbTestClient.ts +0 -443
  476. package/src/adapters/mongodbTestFilter.ts +0 -170
  477. package/src/adapters/mongodbWrites.ts +0 -261
  478. package/src/adapters/prismaInsights.ts +0 -190
  479. package/src/adapters/prismaQuery.ts +0 -129
  480. package/src/adapters/prismaRows.spec.ts +0 -98
  481. package/src/adapters/prismaRows.ts +0 -308
  482. package/src/adapters/prismaTestClient.ts +0 -478
  483. package/src/calculatePagination.ts +0 -34
  484. package/src/db/databasePluginCore.spec.ts +0 -62
  485. package/src/db/databasePluginCore.testFixtures.ts +0 -76
  486. package/src/db/databasePluginCore.ts +0 -185
  487. package/src/db/databasePluginUpdateCheck.bench.ts +0 -117
  488. package/src/db/fixedMigrator.spec.ts +0 -294
  489. package/src/db/fixedMigrator.ts +0 -147
  490. package/src/db/fixedMigratorMongo.spec.ts +0 -253
  491. package/src/db/fixedMigratorMongo.ts +0 -425
  492. package/src/db/hotUpdaterSchema.ts +0 -5
  493. package/src/db/mongoMigrationExecution.ts +0 -23
  494. package/src/db/schema/definitions.ts +0 -1
  495. package/src/db/schema/insightsCollation.ts +0 -21
  496. package/src/db/schema/mongodb.ts +0 -40
  497. package/src/db/schema/registry.ts +0 -55
  498. package/src/db/schema/sql.ts +0 -244
  499. package/src/db/schema/sqlOperations.ts +0 -63
  500. package/src/db/schema/types.ts +0 -1
  501. package/src/db/schemaGenerators.ts +0 -495
  502. package/src/db/schemaReadiness.ts +0 -34
  503. package/src/db/sqlMigrationExecution.spec.ts +0 -65
  504. package/src/db/sqlMigrationExecution.ts +0 -108
  505. package/src/db/types.spec.ts +0 -63
  506. package/src/handlerBundleRoutes.ts +0 -259
  507. package/src/handlerReleaseManagementRoutes.ts +0 -213
  508. package/src/schema/dsl-all-versions.spec.ts +0 -35
  509. package/src/schema/dsl.ts +0 -187
  510. package/src/schema/index.ts +0 -10
  511. package/src/schema/settings.ts +0 -15
  512. package/src/schema/types.ts +0 -79
  513. package/src/schema/v1_0_0.spec.ts +0 -220
  514. package/src/schema/v1_0_0.ts +0 -511
@@ -7,11 +7,20 @@ const MAX_PAGE_LIMIT = 100;
7
7
  const MAX_EVENT_ID_LENGTH = 1024;
8
8
  const MAX_IDENTITY_LENGTH = 255;
9
9
  const MAX_CURSOR_LENGTH = 8192;
10
+ const HOUR_MS = 36e5;
10
11
  const WINDOW_MS = {
11
12
  "24h": 864e5,
12
13
  "7d": 6048e5,
13
14
  "30d": 2592e6
14
15
  };
16
+ /**
17
+ * The longest receipt range, `[sinceMs, beforeReceivedAtMs)`, of a global or
18
+ * bundle event list, and the range one covers without `sinceMs`: raw events
19
+ * are listed inside a time range, as analytics products list them. It is a
20
+ * duration, so a range that ends mid-day touches 91 UTC days. Installation
21
+ * history is one index range and reads back to `sinceMs`.
22
+ */
23
+ const EVENT_LIST_RANGE_MS = 2160 * HOUR_MS;
15
24
  const isRecord = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
16
25
  const requireString = (value, label, maximumLength) => {
17
26
  if (typeof value !== "string" || value.length === 0 || value.length > maximumLength || new TextDecoder("utf-8", { ignoreBOM: true }).decode(new TextEncoder().encode(value)) !== value) throw new InsightsBadRequestError(`Invalid ${label}.`);
@@ -160,36 +169,50 @@ const toInstallationRow = (row) => ({
160
169
  userId: row.user_id,
161
170
  username: row.metadata.username
162
171
  });
172
+ /**
173
+ * Where a list without `sinceMs` starts: 90 days before its cutoff for the
174
+ * global and bundle lists, at the first event for installation history.
175
+ */
176
+ const defaultEventStart = (filter, beforeReceivedAtMs) => filter.kind === "installationMovement" ? 0 : Math.max(0, beforeReceivedAtMs - EVENT_LIST_RANGE_MS);
177
+ /** Whether a cursor's row lies inside the list's range. */
178
+ const isInsideBounds = ({ after }, bounds) => after.receivedAtMs >= bounds.sinceMs && after.receivedAtMs < bounds.beforeReceivedAtMs;
179
+ /** A page's range: its cursor's, which the request may repeat but not change. */
180
+ const readEventBounds = (input, cursor, filter) => {
181
+ const beforeReceivedAtMs = cursor?.beforeReceivedAtMs ?? (input.beforeReceivedAtMs === void 0 ? Date.now() : requireTimestamp(input.beforeReceivedAtMs, "event cutoff"));
182
+ if (cursor !== void 0 && input.beforeReceivedAtMs !== void 0 && input.beforeReceivedAtMs !== beforeReceivedAtMs) throw new InsightsBadRequestError("Insights cursor does not match the requested event cutoff.");
183
+ const sinceMs = cursor?.sinceMs ?? (input.sinceMs === void 0 ? defaultEventStart(filter, beforeReceivedAtMs) : requireTimestamp(input.sinceMs, "event start"));
184
+ const bounds = {
185
+ beforeReceivedAtMs,
186
+ sinceMs
187
+ };
188
+ if (sinceMs > beforeReceivedAtMs || input.sinceMs !== void 0 && input.sinceMs !== sinceMs || cursor !== void 0 && !isInsideBounds(cursor, bounds)) throw new InsightsBadRequestError("Insights cursor or range does not match the requested event start.");
189
+ if (filter.kind !== "installationMovement" && beforeReceivedAtMs - sinceMs > 7776e6) throw new InsightsBadRequestError("Insights event lists cover at most 90 days: send a sinceMs no more than 90 days before beforeReceivedAtMs.");
190
+ return bounds;
191
+ };
163
192
  const pageEventRows = async (model, input, filter, map) => {
164
193
  const limit = readLimit(input.limit);
165
194
  const cursor = input.cursor === void 0 ? void 0 : readEventCursor(input.cursor, filter);
166
- const beforeReceivedAtMs = cursor?.beforeReceivedAtMs ?? (input.beforeReceivedAtMs === void 0 ? Date.now() : requireTimestamp(input.beforeReceivedAtMs, "event cutoff"));
167
- if (cursor !== void 0 && input.beforeReceivedAtMs !== void 0 && input.beforeReceivedAtMs !== beforeReceivedAtMs) throw new InsightsBadRequestError("Insights cursor does not match the requested event cutoff.");
168
- const sinceMs = cursor?.sinceMs ?? (input.sinceMs === void 0 ? 0 : requireTimestamp(input.sinceMs, "event start"));
169
- if (sinceMs > beforeReceivedAtMs || input.sinceMs !== void 0 && input.sinceMs !== sinceMs || cursor !== void 0 && (cursor.after.receivedAtMs < sinceMs || cursor.after.receivedAtMs >= beforeReceivedAtMs)) throw new InsightsBadRequestError("Insights cursor or range does not match the requested event start.");
170
- const databaseInput = {
195
+ const bounds = readEventBounds(input, cursor, filter);
196
+ const query = {
171
197
  filter,
172
- sinceMs,
173
- beforeReceivedAtMs,
198
+ ...bounds,
174
199
  ...cursor === void 0 ? {} : { after: cursor.after },
175
- limit: limit + 1
200
+ limit
176
201
  };
177
- const rows = await model.listEvents(databaseInput);
178
- assertEventRows(rows, databaseInput);
179
- const pageRows = rows.slice(0, limit);
180
- const last = pageRows.at(-1);
202
+ const rows = await model.listEvents(query);
203
+ assertEventRows(rows, query);
204
+ const last = rows.at(-1);
181
205
  return {
182
- beforeReceivedAtMs,
183
- data: pageRows.map(map),
184
- nextCursor: rows.length > limit && last ? encodeCursor({
206
+ beforeReceivedAtMs: bounds.beforeReceivedAtMs,
207
+ data: rows.map(map),
208
+ nextCursor: rows.length === limit && last ? encodeCursor({
185
209
  after: {
186
210
  id: last.id,
187
211
  receivedAtMs: last.received_at_ms
188
212
  },
189
- beforeReceivedAtMs,
213
+ ...bounds,
190
214
  kind: "events",
191
215
  filter,
192
- sinceMs,
193
216
  version: 2
194
217
  }) : null
195
218
  };
@@ -236,15 +259,14 @@ const createInsightsProvider = (model) => Object.freeze({
236
259
  const databaseInput = {
237
260
  userId,
238
261
  ...cursor === void 0 ? {} : { afterInstallId: cursor.afterInstallId },
239
- limit: limit + 1
262
+ limit
240
263
  };
241
264
  const rows = await model.findLatestEvents(databaseInput);
242
265
  assertInstallationRows(rows, databaseInput);
243
- const pageRows = rows.slice(0, limit);
244
- const last = pageRows.at(-1);
266
+ const last = rows.at(-1);
245
267
  return {
246
- data: pageRows.map(toInstallationRow),
247
- nextCursor: rows.length > limit && last ? encodeCursor({
268
+ data: rows.map(toInstallationRow),
269
+ nextCursor: rows.length === limit && last ? encodeCursor({
248
270
  afterInstallId: last.install_id,
249
271
  kind: "user-installations",
250
272
  userId,
@@ -256,7 +278,8 @@ const createInsightsProvider = (model) => Object.freeze({
256
278
  const scope = readScope(input);
257
279
  const { window } = input;
258
280
  if (!Object.hasOwn(WINDOW_MS, window)) throw new InsightsBadRequestError("Invalid reporting installation window.");
259
- const beforeReceivedAtMs = Date.now();
281
+ const now = Date.now();
282
+ const beforeReceivedAtMs = now - now % HOUR_MS + (now % HOUR_MS === 0 ? 0 : HOUR_MS);
260
283
  const sinceMs = Math.max(0, beforeReceivedAtMs - WINDOW_MS[window]);
261
284
  const measure = async (count) => {
262
285
  const value = await count;
@@ -329,4 +352,4 @@ const createInsightsProvider = (model) => Object.freeze({
329
352
  }
330
353
  });
331
354
  //#endregion
332
- export { createInsightsProvider };
355
+ export { EVENT_LIST_RANGE_MS, createInsightsProvider };
@@ -2,8 +2,13 @@ const require_errors = require("./errors.cjs");
2
2
  const require_eventInput = require("./eventInput.cjs");
3
3
  const require_queryInput = require("./queryInput.cjs");
4
4
  //#region src/insights/routes.ts
5
- const json = (body, status) => Response.json(body, {
6
- headers: { "cache-control": "private, no-store" },
5
+ /** Seconds a client waits before it resends a request the busy database refused. */
6
+ const RETRY_AFTER_SECONDS = 5;
7
+ const json = (body, status, headers = {}) => Response.json(body, {
8
+ headers: {
9
+ "cache-control": "private, no-store",
10
+ ...headers
11
+ },
7
12
  status
8
13
  });
9
14
  const requireParam = (params, key) => {
@@ -21,10 +26,78 @@ const run = async (operation) => {
21
26
  } catch (error) {
22
27
  if (error instanceof require_errors.InsightsBadRequestError) return json({ error: error.message }, 400);
23
28
  if (error instanceof require_errors.InsightsPayloadTooLargeError) return json({ error: error.message }, 413);
29
+ if (require_errors.isDatabaseBusyError(error)) {
30
+ console.warn("[hot-updater] Insights answered 503: the database is busy.", error);
31
+ return json({ error: "Service unavailable" }, 503, { "retry-after": String(RETRY_AFTER_SECONDS) });
32
+ }
24
33
  throw error;
25
34
  }
26
35
  };
27
36
  const query = (operation) => run(async () => json(await operation(), 200));
37
+ /** Every Insights route: where it mounts, and the handler it runs. */
38
+ const INSIGHTS_ROUTES = [
39
+ {
40
+ access: "client",
41
+ method: "POST",
42
+ path: "/events",
43
+ handler: "appendBundleEvent"
44
+ },
45
+ {
46
+ access: "admin",
47
+ method: "GET",
48
+ path: "/events",
49
+ handler: "listEvents"
50
+ },
51
+ {
52
+ access: "admin",
53
+ method: "GET",
54
+ path: "/overview",
55
+ handler: "getReportingOverview"
56
+ },
57
+ {
58
+ access: "admin",
59
+ method: "GET",
60
+ path: "/installations",
61
+ handler: "pageInstallationsByCurrentUserId"
62
+ },
63
+ {
64
+ access: "admin",
65
+ method: "GET",
66
+ path: "/installations/:installId/events",
67
+ handler: "listInstallationEvents"
68
+ },
69
+ {
70
+ access: "admin",
71
+ method: "GET",
72
+ path: "/installations/:installId",
73
+ handler: "getInstallation"
74
+ }
75
+ ];
76
+ /** Without the insights plugin, its routes answer 204 and say Insights is off. */
77
+ const insightsDisabled = async () => new Response(null, {
78
+ headers: {
79
+ "cache-control": "private, no-store",
80
+ "x-hot-updater-insights": "disabled"
81
+ },
82
+ status: 204
83
+ });
84
+ /** What a server without the insights plugin logs on the first event it drops. */
85
+ const INSIGHTS_OFF_WARNING = "[hot-updater] Insights is off, so POST /events answered 204 and stored nothing. Add insights() from @hot-updater/server/plugins/insights to plugins to record app events, or set insights: false in the app's HotUpdater.init to stop sending them. This warning prints once per server.";
86
+ /**
87
+ * The client's `POST /events` without the insights plugin. It answers as
88
+ * {@link insightsDisabled} does, so apps need no change, and warns on the
89
+ * first event it drops, so a server that left out `insights()` says so.
90
+ */
91
+ const createDroppedEventHandler = () => {
92
+ let warned = false;
93
+ return (params, request) => {
94
+ if (!warned) {
95
+ warned = true;
96
+ console.warn(INSIGHTS_OFF_WARNING);
97
+ }
98
+ return insightsDisabled(params, request);
99
+ };
100
+ };
28
101
  const createInsightsRouteHandlers = (provider) => ({
29
102
  appendBundleEvent: async (_params, request) => run(async () => {
30
103
  await provider.appendBundleEvent(await require_eventInput.parseBundleEventRequest(request));
@@ -42,17 +115,9 @@ const createInsightsRouteHandlers = (provider) => ({
42
115
  })),
43
116
  pageInstallationsByCurrentUserId: (_params, request) => query(() => provider.pageInstallationsByCurrentUserId(require_queryInput.parseUserInstallationPageInput(request)))
44
117
  });
45
- const registerInsightsClientRoutes = (add) => {
46
- add("POST", "/events", "appendBundleEvent");
47
- };
48
- const registerInsightsAdminRoutes = (add) => {
49
- add("GET", "/events", "listEvents");
50
- add("GET", "/overview", "getReportingOverview");
51
- add("GET", "/installations", "pageInstallationsByCurrentUserId");
52
- add("GET", "/installations/:installId/events", "listInstallationEvents");
53
- add("GET", "/installations/:installId", "getInstallation");
54
- };
55
118
  //#endregion
119
+ exports.INSIGHTS_OFF_WARNING = INSIGHTS_OFF_WARNING;
120
+ exports.INSIGHTS_ROUTES = INSIGHTS_ROUTES;
121
+ exports.createDroppedEventHandler = createDroppedEventHandler;
56
122
  exports.createInsightsRouteHandlers = createInsightsRouteHandlers;
57
- exports.registerInsightsAdminRoutes = registerInsightsAdminRoutes;
58
- exports.registerInsightsClientRoutes = registerInsightsClientRoutes;
123
+ exports.insightsDisabled = insightsDisabled;
@@ -1,9 +1,14 @@
1
- import { InsightsBadRequestError, InsightsPayloadTooLargeError } from "./errors.mjs";
1
+ import { InsightsBadRequestError, InsightsPayloadTooLargeError, isDatabaseBusyError } from "./errors.mjs";
2
2
  import { parseBundleEventRequest } from "./eventInput.mjs";
3
3
  import { parseEventPageInput, parseReportingOverviewInput, parseUserInstallationPageInput } from "./queryInput.mjs";
4
4
  //#region src/insights/routes.ts
5
- const json = (body, status) => Response.json(body, {
6
- headers: { "cache-control": "private, no-store" },
5
+ /** Seconds a client waits before it resends a request the busy database refused. */
6
+ const RETRY_AFTER_SECONDS = 5;
7
+ const json = (body, status, headers = {}) => Response.json(body, {
8
+ headers: {
9
+ "cache-control": "private, no-store",
10
+ ...headers
11
+ },
7
12
  status
8
13
  });
9
14
  const requireParam = (params, key) => {
@@ -21,10 +26,78 @@ const run = async (operation) => {
21
26
  } catch (error) {
22
27
  if (error instanceof InsightsBadRequestError) return json({ error: error.message }, 400);
23
28
  if (error instanceof InsightsPayloadTooLargeError) return json({ error: error.message }, 413);
29
+ if (isDatabaseBusyError(error)) {
30
+ console.warn("[hot-updater] Insights answered 503: the database is busy.", error);
31
+ return json({ error: "Service unavailable" }, 503, { "retry-after": String(RETRY_AFTER_SECONDS) });
32
+ }
24
33
  throw error;
25
34
  }
26
35
  };
27
36
  const query = (operation) => run(async () => json(await operation(), 200));
37
+ /** Every Insights route: where it mounts, and the handler it runs. */
38
+ const INSIGHTS_ROUTES = [
39
+ {
40
+ access: "client",
41
+ method: "POST",
42
+ path: "/events",
43
+ handler: "appendBundleEvent"
44
+ },
45
+ {
46
+ access: "admin",
47
+ method: "GET",
48
+ path: "/events",
49
+ handler: "listEvents"
50
+ },
51
+ {
52
+ access: "admin",
53
+ method: "GET",
54
+ path: "/overview",
55
+ handler: "getReportingOverview"
56
+ },
57
+ {
58
+ access: "admin",
59
+ method: "GET",
60
+ path: "/installations",
61
+ handler: "pageInstallationsByCurrentUserId"
62
+ },
63
+ {
64
+ access: "admin",
65
+ method: "GET",
66
+ path: "/installations/:installId/events",
67
+ handler: "listInstallationEvents"
68
+ },
69
+ {
70
+ access: "admin",
71
+ method: "GET",
72
+ path: "/installations/:installId",
73
+ handler: "getInstallation"
74
+ }
75
+ ];
76
+ /** Without the insights plugin, its routes answer 204 and say Insights is off. */
77
+ const insightsDisabled = async () => new Response(null, {
78
+ headers: {
79
+ "cache-control": "private, no-store",
80
+ "x-hot-updater-insights": "disabled"
81
+ },
82
+ status: 204
83
+ });
84
+ /** What a server without the insights plugin logs on the first event it drops. */
85
+ const INSIGHTS_OFF_WARNING = "[hot-updater] Insights is off, so POST /events answered 204 and stored nothing. Add insights() from @hot-updater/server/plugins/insights to plugins to record app events, or set insights: false in the app's HotUpdater.init to stop sending them. This warning prints once per server.";
86
+ /**
87
+ * The client's `POST /events` without the insights plugin. It answers as
88
+ * {@link insightsDisabled} does, so apps need no change, and warns on the
89
+ * first event it drops, so a server that left out `insights()` says so.
90
+ */
91
+ const createDroppedEventHandler = () => {
92
+ let warned = false;
93
+ return (params, request) => {
94
+ if (!warned) {
95
+ warned = true;
96
+ console.warn(INSIGHTS_OFF_WARNING);
97
+ }
98
+ return insightsDisabled(params, request);
99
+ };
100
+ };
28
101
  const createInsightsRouteHandlers = (provider) => ({
29
102
  appendBundleEvent: async (_params, request) => run(async () => {
30
103
  await provider.appendBundleEvent(await parseBundleEventRequest(request));
@@ -42,15 +115,5 @@ const createInsightsRouteHandlers = (provider) => ({
42
115
  })),
43
116
  pageInstallationsByCurrentUserId: (_params, request) => query(() => provider.pageInstallationsByCurrentUserId(parseUserInstallationPageInput(request)))
44
117
  });
45
- const registerInsightsClientRoutes = (add) => {
46
- add("POST", "/events", "appendBundleEvent");
47
- };
48
- const registerInsightsAdminRoutes = (add) => {
49
- add("GET", "/events", "listEvents");
50
- add("GET", "/overview", "getReportingOverview");
51
- add("GET", "/installations", "pageInstallationsByCurrentUserId");
52
- add("GET", "/installations/:installId/events", "listInstallationEvents");
53
- add("GET", "/installations/:installId", "getInstallation");
54
- };
55
118
  //#endregion
56
- export { createInsightsRouteHandlers, registerInsightsAdminRoutes, registerInsightsClientRoutes };
119
+ export { INSIGHTS_OFF_WARNING, INSIGHTS_ROUTES, createDroppedEventHandler, createInsightsRouteHandlers, insightsDisabled };
package/dist/node.d.cts CHANGED
@@ -1,5 +1,5 @@
1
- import { HotUpdaterHandler } from "./handlerTypes.cjs";
2
1
  import { HOT_UPDATER_SERVER_VERSION } from "./version.cjs";
2
+ import { HotUpdaterHandler } from "./handlerTypes.cjs";
3
3
  import { HOT_UPDATER_INFRASTRUCTURE_GENERATION } from "./handlerVersionRoutes.cjs";
4
4
  //#region src/node.d.ts
5
5
  /**
package/dist/node.d.mts CHANGED
@@ -1,5 +1,5 @@
1
- import { HotUpdaterHandler } from "./handlerTypes.mjs";
2
1
  import { HOT_UPDATER_SERVER_VERSION } from "./version.mjs";
2
+ import { HotUpdaterHandler } from "./handlerTypes.mjs";
3
3
  import { HOT_UPDATER_INFRASTRUCTURE_GENERATION } from "./handlerVersionRoutes.mjs";
4
4
  //#region src/node.d.ts
5
5
  /**
package/dist/package.cjs CHANGED
@@ -1,5 +1,5 @@
1
1
  //#region package.json
2
- var version = "1.0.0-rc.14";
2
+ var version = "1.0.0-rc.16";
3
3
  //#endregion
4
4
  Object.defineProperty(exports, "version", {
5
5
  enumerable: true,
package/dist/package.mjs CHANGED
@@ -1,4 +1,4 @@
1
1
  //#region package.json
2
- var version = "1.0.0-rc.14";
2
+ var version = "1.0.0-rc.16";
3
3
  //#endregion
4
4
  export { version };
@@ -0,0 +1,50 @@
1
+ Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
2
+ const require_apiKeys = require("../../apiKeys.cjs");
3
+ const require_builtIn = require("../builtIn.cjs");
4
+ const require_definePlugin = require("../definePlugin.cjs");
5
+ const require_model = require("./model.cjs");
6
+ const require_schema = require("./schema.cjs");
7
+ //#region src/plugins/api-keys/index.ts
8
+ /**
9
+ * Built-in API keys: protects client routes with keys whose SHA-256 digests
10
+ * are stored, and manages them in-process.
11
+ */
12
+ const apiKeys = (options = {}) => {
13
+ const headerName = require_apiKeys.normalizeApiKeyHeaderName(options.headerName ?? "x-api-key");
14
+ return require_builtIn.markBuiltIn(require_definePlugin.definePlugin({
15
+ id: "apiKeys",
16
+ provides: { clientAuth: true },
17
+ schemaVersion: "1.0.0",
18
+ schema: require_schema.apiKeysSchema,
19
+ init: ({ db }) => {
20
+ const model = require_model.createApiKeyModel(db);
21
+ return {
22
+ api: {
23
+ ...require_apiKeys.createApiKeyManagement({ apiKeys: model }),
24
+ /** Registers a known plaintext key idempotently, for managed init. */
25
+ register: (input) => require_apiKeys.registerApiKey({
26
+ ...input,
27
+ apiKeys: model
28
+ }),
29
+ /** Reuses a saved key or creates one, for managed init. */
30
+ provision: (input) => require_apiKeys.provisionApiKey({
31
+ ...input,
32
+ apiKeys: model
33
+ })
34
+ },
35
+ clientAuth: {
36
+ varyHeaders: [headerName],
37
+ authenticate: (headers) => require_apiKeys.authenticateApiKey({
38
+ apiKeys: model,
39
+ headerName,
40
+ request: { headers }
41
+ })
42
+ }
43
+ };
44
+ }
45
+ }));
46
+ };
47
+ //#endregion
48
+ exports.apiKeys = apiKeys;
49
+ exports.apiKeysSchema = require_schema.apiKeysSchema;
50
+ exports.createApiKeyModel = require_model.createApiKeyModel;
@@ -0,0 +1,85 @@
1
+ import { TableDefinition } from "../../database/schema.cjs";
2
+ import { HotUpdaterPlugin } from "../definePlugin.cjs";
3
+ import { ApiKeyMetadata, CreatedApiKey } from "../../apiKeys.cjs";
4
+ import "../../index.cjs";
5
+ import "../index.cjs";
6
+ import { ApiKeysSchema, apiKeysSchema } from "./schema.cjs";
7
+ import { createApiKeyModel } from "./model.cjs";
8
+ //#region src/plugins/api-keys/index.d.ts
9
+ interface ApiKeysOptions {
10
+ /** The request header that carries the key; defaults to `x-api-key`. */
11
+ readonly headerName?: string;
12
+ }
13
+ /**
14
+ * Built-in API keys: protects client routes with keys whose SHA-256 digests
15
+ * are stored, and manages them in-process.
16
+ */
17
+ declare const apiKeys: (options?: ApiKeysOptions) => HotUpdaterPlugin<"apiKeys", {
18
+ readonly api_keys: TableDefinition<{
19
+ readonly id: {
20
+ readonly type: "string";
21
+ readonly maxLength: 255;
22
+ };
23
+ readonly hash: {
24
+ readonly type: "string";
25
+ readonly maxLength: 64;
26
+ readonly unique: true;
27
+ };
28
+ readonly name: {
29
+ readonly type: "string";
30
+ readonly maxLength: 64;
31
+ };
32
+ readonly prefix: {
33
+ readonly type: "string";
34
+ readonly maxLength: 16;
35
+ };
36
+ readonly role: {
37
+ readonly type: "string";
38
+ readonly maxLength: 16;
39
+ };
40
+ readonly created_at_ms: {
41
+ readonly type: "integer";
42
+ };
43
+ readonly revoked_at_ms: {
44
+ readonly type: "integer";
45
+ readonly required: false;
46
+ };
47
+ }, {}, {
48
+ readonly byCreated: {
49
+ readonly eq: readonly [];
50
+ readonly sort: readonly ["created_at_ms"];
51
+ };
52
+ }, readonly ["id"]>;
53
+ }, {
54
+ api: {
55
+ /** Registers a known plaintext key idempotently, for managed init. */
56
+ register: (input: {
57
+ readonly apiKey: string;
58
+ readonly name: string;
59
+ readonly createdAtMs?: number;
60
+ }) => Promise<CreatedApiKey>;
61
+ /** Reuses a saved key or creates one, for managed init. */
62
+ provision: (input: {
63
+ readonly existingApiKey?: string;
64
+ readonly name: string;
65
+ }) => Promise<CreatedApiKey>;
66
+ create(input: {
67
+ readonly name: string;
68
+ }): Promise<{
69
+ readonly apiKey: string;
70
+ readonly record: ApiKeyMetadata;
71
+ }>;
72
+ list(): Promise<readonly ApiKeyMetadata[]>;
73
+ revoke(input: {
74
+ readonly id: string;
75
+ }): Promise<ApiKeyMetadata | null>;
76
+ };
77
+ clientAuth: {
78
+ varyHeaders: string[];
79
+ authenticate: (headers: Headers) => Promise<boolean>;
80
+ };
81
+ }, {
82
+ readonly clientAuth: true;
83
+ }>;
84
+ //#endregion
85
+ export { ApiKeysOptions, type ApiKeysSchema, apiKeys, apiKeysSchema, createApiKeyModel };
@@ -0,0 +1,85 @@
1
+ import { TableDefinition } from "../../database/schema.mjs";
2
+ import { HotUpdaterPlugin } from "../definePlugin.mjs";
3
+ import { ApiKeyMetadata, CreatedApiKey } from "../../apiKeys.mjs";
4
+ import "../../index.mjs";
5
+ import "../index.mjs";
6
+ import { ApiKeysSchema, apiKeysSchema } from "./schema.mjs";
7
+ import { createApiKeyModel } from "./model.mjs";
8
+ //#region src/plugins/api-keys/index.d.ts
9
+ interface ApiKeysOptions {
10
+ /** The request header that carries the key; defaults to `x-api-key`. */
11
+ readonly headerName?: string;
12
+ }
13
+ /**
14
+ * Built-in API keys: protects client routes with keys whose SHA-256 digests
15
+ * are stored, and manages them in-process.
16
+ */
17
+ declare const apiKeys: (options?: ApiKeysOptions) => HotUpdaterPlugin<"apiKeys", {
18
+ readonly api_keys: TableDefinition<{
19
+ readonly id: {
20
+ readonly type: "string";
21
+ readonly maxLength: 255;
22
+ };
23
+ readonly hash: {
24
+ readonly type: "string";
25
+ readonly maxLength: 64;
26
+ readonly unique: true;
27
+ };
28
+ readonly name: {
29
+ readonly type: "string";
30
+ readonly maxLength: 64;
31
+ };
32
+ readonly prefix: {
33
+ readonly type: "string";
34
+ readonly maxLength: 16;
35
+ };
36
+ readonly role: {
37
+ readonly type: "string";
38
+ readonly maxLength: 16;
39
+ };
40
+ readonly created_at_ms: {
41
+ readonly type: "integer";
42
+ };
43
+ readonly revoked_at_ms: {
44
+ readonly type: "integer";
45
+ readonly required: false;
46
+ };
47
+ }, {}, {
48
+ readonly byCreated: {
49
+ readonly eq: readonly [];
50
+ readonly sort: readonly ["created_at_ms"];
51
+ };
52
+ }, readonly ["id"]>;
53
+ }, {
54
+ api: {
55
+ /** Registers a known plaintext key idempotently, for managed init. */
56
+ register: (input: {
57
+ readonly apiKey: string;
58
+ readonly name: string;
59
+ readonly createdAtMs?: number;
60
+ }) => Promise<CreatedApiKey>;
61
+ /** Reuses a saved key or creates one, for managed init. */
62
+ provision: (input: {
63
+ readonly existingApiKey?: string;
64
+ readonly name: string;
65
+ }) => Promise<CreatedApiKey>;
66
+ create(input: {
67
+ readonly name: string;
68
+ }): Promise<{
69
+ readonly apiKey: string;
70
+ readonly record: ApiKeyMetadata;
71
+ }>;
72
+ list(): Promise<readonly ApiKeyMetadata[]>;
73
+ revoke(input: {
74
+ readonly id: string;
75
+ }): Promise<ApiKeyMetadata | null>;
76
+ };
77
+ clientAuth: {
78
+ varyHeaders: string[];
79
+ authenticate: (headers: Headers) => Promise<boolean>;
80
+ };
81
+ }, {
82
+ readonly clientAuth: true;
83
+ }>;
84
+ //#endregion
85
+ export { ApiKeysOptions, type ApiKeysSchema, apiKeys, apiKeysSchema, createApiKeyModel };
@@ -0,0 +1,47 @@
1
+ import { authenticateApiKey, createApiKeyManagement, normalizeApiKeyHeaderName, provisionApiKey, registerApiKey } from "../../apiKeys.mjs";
2
+ import { markBuiltIn } from "../builtIn.mjs";
3
+ import { definePlugin } from "../definePlugin.mjs";
4
+ import { createApiKeyModel } from "./model.mjs";
5
+ import { apiKeysSchema } from "./schema.mjs";
6
+ //#region src/plugins/api-keys/index.ts
7
+ /**
8
+ * Built-in API keys: protects client routes with keys whose SHA-256 digests
9
+ * are stored, and manages them in-process.
10
+ */
11
+ const apiKeys = (options = {}) => {
12
+ const headerName = normalizeApiKeyHeaderName(options.headerName ?? "x-api-key");
13
+ return markBuiltIn(definePlugin({
14
+ id: "apiKeys",
15
+ provides: { clientAuth: true },
16
+ schemaVersion: "1.0.0",
17
+ schema: apiKeysSchema,
18
+ init: ({ db }) => {
19
+ const model = createApiKeyModel(db);
20
+ return {
21
+ api: {
22
+ ...createApiKeyManagement({ apiKeys: model }),
23
+ /** Registers a known plaintext key idempotently, for managed init. */
24
+ register: (input) => registerApiKey({
25
+ ...input,
26
+ apiKeys: model
27
+ }),
28
+ /** Reuses a saved key or creates one, for managed init. */
29
+ provision: (input) => provisionApiKey({
30
+ ...input,
31
+ apiKeys: model
32
+ })
33
+ },
34
+ clientAuth: {
35
+ varyHeaders: [headerName],
36
+ authenticate: (headers) => authenticateApiKey({
37
+ apiKeys: model,
38
+ headerName,
39
+ request: { headers }
40
+ })
41
+ }
42
+ };
43
+ }
44
+ }));
45
+ };
46
+ //#endregion
47
+ export { apiKeys, apiKeysSchema, createApiKeyModel };