@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.
- package/dist/adapters/drizzle.cjs +35 -74
- package/dist/adapters/drizzle.d.cts +13 -5
- package/dist/adapters/drizzle.d.mts +13 -5
- package/dist/adapters/drizzle.mjs +34 -75
- package/dist/adapters/drizzleExecutor.cjs +114 -0
- package/dist/adapters/drizzleExecutor.d.cts +9 -0
- package/dist/adapters/drizzleExecutor.d.mts +9 -0
- package/dist/adapters/drizzleExecutor.mjs +112 -0
- package/dist/adapters/kysely.cjs +25 -31
- package/dist/adapters/kysely.d.cts +10 -6
- package/dist/adapters/kysely.d.mts +10 -6
- package/dist/adapters/kysely.mjs +25 -32
- package/dist/adapters/kyselyExecutor.cjs +32 -0
- package/dist/adapters/kyselyExecutor.d.cts +12 -0
- package/dist/adapters/kyselyExecutor.d.mts +12 -0
- package/dist/adapters/kyselyExecutor.mjs +32 -0
- package/dist/adapters/mongodb.cjs +28 -62
- package/dist/adapters/mongodb.d.cts +10 -5
- package/dist/adapters/mongodb.d.mts +10 -5
- package/dist/adapters/mongodb.mjs +28 -63
- package/dist/adapters/mongodbAdapter.cjs +174 -0
- package/dist/adapters/mongodbAdapter.d.cts +9 -0
- package/dist/adapters/mongodbAdapter.d.mts +9 -0
- package/dist/adapters/mongodbAdapter.mjs +173 -0
- package/dist/adapters/prisma.cjs +38 -257
- package/dist/adapters/prisma.d.cts +12 -7
- package/dist/adapters/prisma.d.mts +12 -7
- package/dist/adapters/prisma.mjs +38 -257
- package/dist/adapters/prismaExecutor.cjs +64 -0
- package/dist/adapters/prismaExecutor.mjs +64 -0
- package/dist/adapters/sqlProviders.cjs +9 -0
- package/dist/adapters/sqlProviders.mjs +9 -0
- package/dist/apiKeys.cjs +2 -6
- package/dist/apiKeys.d.cts +1 -23
- package/dist/apiKeys.d.mts +1 -23
- package/dist/apiKeys.mjs +2 -6
- package/dist/assembly/assemblePlugins.cjs +147 -0
- package/dist/assembly/assemblePlugins.d.cts +12 -0
- package/dist/assembly/assemblePlugins.d.mts +12 -0
- package/dist/assembly/assemblePlugins.mjs +146 -0
- package/dist/assembly/databasePlugins.cjs +23 -0
- package/dist/assembly/databasePlugins.d.cts +43 -0
- package/dist/assembly/databasePlugins.d.mts +43 -0
- package/dist/assembly/databasePlugins.mjs +22 -0
- package/dist/core/api.cjs +91 -0
- package/dist/core/api.d.cts +65 -0
- package/dist/core/api.d.mts +65 -0
- package/dist/core/api.mjs +87 -0
- package/dist/core/baseCandidates.cjs +71 -0
- package/dist/core/baseCandidates.d.cts +17 -0
- package/dist/core/baseCandidates.d.mts +17 -0
- package/dist/core/baseCandidates.mjs +69 -0
- package/dist/core/operations.cjs +350 -0
- package/dist/core/operations.mjs +350 -0
- package/dist/core/reads.cjs +273 -0
- package/dist/core/reads.d.cts +48 -0
- package/dist/core/reads.d.mts +48 -0
- package/dist/core/reads.mjs +267 -0
- package/dist/core/releases.cjs +193 -0
- package/dist/core/releases.mjs +190 -0
- package/dist/core/schema.cjs +279 -0
- package/dist/core/schema.d.cts +307 -0
- package/dist/core/schema.d.mts +307 -0
- package/dist/core/schema.mjs +277 -0
- package/dist/core/writes.cjs +96 -0
- package/dist/core/writes.mjs +91 -0
- package/dist/createHotUpdaterCore.cjs +58 -75
- package/dist/createHotUpdaterCore.d.cts +52 -44
- package/dist/createHotUpdaterCore.d.mts +52 -44
- package/dist/createHotUpdaterCore.mjs +59 -75
- package/dist/database/cursor.cjs +44 -0
- package/dist/database/cursor.d.cts +7 -0
- package/dist/database/cursor.d.mts +7 -0
- package/dist/database/cursor.mjs +40 -0
- package/dist/database/database.cjs +44 -0
- package/dist/database/database.d.cts +123 -0
- package/dist/database/database.d.mts +123 -0
- package/dist/database/database.mjs +44 -0
- package/dist/database/definitions.d.cts +68 -0
- package/dist/database/definitions.d.mts +68 -0
- package/dist/database/engine.cjs +37 -0
- package/dist/database/engine.d.cts +40 -0
- package/dist/database/engine.d.mts +40 -0
- package/dist/database/engine.mjs +37 -0
- package/dist/database/engineAggregates.cjs +115 -0
- package/dist/database/engineAggregates.mjs +112 -0
- package/dist/database/engineReads.cjs +180 -0
- package/dist/database/engineReads.d.cts +35 -0
- package/dist/database/engineReads.d.mts +35 -0
- package/dist/database/engineReads.mjs +179 -0
- package/dist/database/engineTransaction.cjs +403 -0
- package/dist/database/engineTransaction.d.cts +26 -0
- package/dist/database/engineTransaction.d.mts +26 -0
- package/dist/database/engineTransaction.mjs +402 -0
- package/dist/database/errors.cjs +27 -0
- package/dist/database/errors.d.cts +21 -0
- package/dist/database/errors.d.mts +21 -0
- package/dist/database/errors.mjs +24 -0
- package/dist/database/fence.cjs +124 -0
- package/dist/database/fence.d.cts +42 -0
- package/dist/database/fence.d.mts +42 -0
- package/dist/database/fence.mjs +116 -0
- package/dist/database/index.cjs +127 -0
- package/dist/database/index.d.cts +17 -0
- package/dist/database/index.d.mts +17 -0
- package/dist/database/index.mjs +15 -0
- package/dist/database/kv/kvAdapter.cjs +273 -0
- package/dist/database/kv/kvAdapter.d.cts +101 -0
- package/dist/database/kv/kvAdapter.d.mts +101 -0
- package/dist/database/kv/kvAdapter.mjs +272 -0
- package/dist/database/resolveSchema.cjs +196 -0
- package/dist/database/resolveSchema.d.cts +42 -0
- package/dist/database/resolveSchema.d.mts +42 -0
- package/dist/database/resolveSchema.mjs +193 -0
- package/dist/database/schema.cjs +21 -0
- package/dist/database/schema.d.cts +61 -0
- package/dist/database/schema.d.mts +61 -0
- package/dist/database/schema.mjs +20 -0
- package/dist/database/sql/sqlAdapter.cjs +282 -0
- package/dist/database/sql/sqlAdapter.d.cts +46 -0
- package/dist/database/sql/sqlAdapter.d.mts +46 -0
- package/dist/database/sql/sqlAdapter.mjs +279 -0
- package/dist/database/sql/sqlSchema.cjs +115 -0
- package/dist/database/sql/sqlSchema.d.cts +8 -0
- package/dist/database/sql/sqlSchema.d.mts +8 -0
- package/dist/database/sql/sqlSchema.mjs +111 -0
- package/dist/db/builtInDatabase.cjs +104 -0
- package/dist/db/builtInDatabase.d.cts +38 -0
- package/dist/db/builtInDatabase.d.mts +38 -0
- package/dist/db/builtInDatabase.mjs +97 -0
- package/dist/db/createBundleDiff.cjs +4 -4
- package/dist/db/createBundleDiff.d.cts +3 -2
- package/dist/db/createBundleDiff.d.mts +3 -2
- package/dist/db/createBundleDiff.mjs +5 -5
- package/dist/db/engineDrizzleSchema.cjs +54 -0
- package/dist/db/engineDrizzleSchema.mjs +54 -0
- package/dist/db/engineMigrator.cjs +53 -0
- package/dist/db/engineMigrator.mjs +53 -0
- package/dist/db/enginePrismaSchema.cjs +85 -0
- package/dist/db/enginePrismaSchema.d.cts +5 -0
- package/dist/db/enginePrismaSchema.d.mts +5 -0
- package/dist/db/enginePrismaSchema.mjs +84 -0
- package/dist/db/engineSql.cjs +26 -0
- package/dist/db/engineSql.d.cts +17 -0
- package/dist/db/engineSql.d.mts +17 -0
- package/dist/db/engineSql.mjs +25 -0
- package/dist/db/engineSqlMigrator.cjs +66 -0
- package/dist/db/engineSqlMigrator.mjs +66 -0
- package/dist/db/fixedMigratorShared.cjs +0 -11
- package/dist/db/fixedMigratorShared.mjs +1 -8
- package/dist/db/index.cjs +23 -8
- package/dist/db/index.d.cts +10 -3
- package/dist/db/index.d.mts +10 -3
- package/dist/db/index.mjs +16 -8
- package/dist/db/releaseCatalog.cjs +20 -43
- package/dist/db/releaseCatalog.d.cts +2 -2
- package/dist/db/releaseCatalog.d.mts +2 -2
- package/dist/db/releaseCatalog.mjs +20 -44
- package/dist/db/schemaSettings.cjs +63 -0
- package/dist/db/schemaSettings.d.cts +12 -0
- package/dist/db/schemaSettings.d.mts +12 -0
- package/dist/db/schemaSettings.mjs +62 -0
- package/dist/db/settingsMigrator.cjs +92 -0
- package/dist/db/settingsMigrator.mjs +89 -0
- package/dist/db/types.cjs +1 -12
- package/dist/db/types.d.cts +26 -66
- package/dist/db/types.d.mts +26 -66
- package/dist/db/types.mjs +2 -11
- package/dist/db/updateArtifacts.cjs +38 -67
- package/dist/db/updateArtifacts.mjs +40 -69
- package/dist/handler.cjs +72 -43
- package/dist/handler.d.cts +3 -5
- package/dist/handler.d.mts +3 -5
- package/dist/handler.mjs +73 -43
- package/dist/handlerAdminRoutes.cjs +375 -0
- package/dist/handlerAdminRoutes.mjs +373 -0
- package/dist/handlerParameters.cjs +6 -11
- package/dist/handlerParameters.mjs +6 -10
- package/dist/handlerReleaseCatalogRoutes.cjs +11 -13
- package/dist/handlerReleaseCatalogRoutes.mjs +11 -13
- package/dist/handlerTypes.d.cts +2 -55
- package/dist/handlerTypes.d.mts +2 -55
- package/dist/handlerVersionRoutes.cjs +20 -4
- package/dist/handlerVersionRoutes.mjs +20 -4
- package/dist/index.cjs +4 -7
- package/dist/index.d.cts +8 -7
- package/dist/index.d.mts +8 -7
- package/dist/index.mjs +4 -4
- package/dist/insights/domain.d.cts +12 -0
- package/dist/insights/domain.d.mts +12 -0
- package/dist/insights/errors.cjs +34 -0
- package/dist/insights/errors.mjs +34 -1
- package/dist/insights/eventInput.cjs +14 -19
- package/dist/insights/eventInput.mjs +15 -20
- package/dist/insights/provider.cjs +47 -23
- package/dist/insights/provider.mjs +47 -24
- package/dist/insights/routes.cjs +79 -14
- package/dist/insights/routes.mjs +77 -14
- package/dist/node.d.cts +1 -1
- package/dist/node.d.mts +1 -1
- package/dist/package.cjs +1 -1
- package/dist/package.mjs +1 -1
- package/dist/plugins/api-keys/index.cjs +50 -0
- package/dist/plugins/api-keys/index.d.cts +85 -0
- package/dist/plugins/api-keys/index.d.mts +85 -0
- package/dist/plugins/api-keys/index.mjs +47 -0
- package/dist/plugins/api-keys/model.cjs +58 -0
- package/dist/plugins/api-keys/model.d.cts +8 -0
- package/dist/plugins/api-keys/model.d.mts +8 -0
- package/dist/plugins/api-keys/model.mjs +58 -0
- package/dist/plugins/api-keys/schema.cjs +38 -0
- package/dist/plugins/api-keys/schema.d.cts +44 -0
- package/dist/plugins/api-keys/schema.d.mts +44 -0
- package/dist/plugins/api-keys/schema.mjs +39 -0
- package/dist/plugins/builtIn.cjs +7 -0
- package/dist/plugins/builtIn.mjs +6 -0
- package/dist/plugins/definePlugin.cjs +5 -0
- package/dist/plugins/definePlugin.d.cts +73 -0
- package/dist/plugins/definePlugin.d.mts +73 -0
- package/dist/plugins/definePlugin.mjs +5 -0
- package/dist/plugins/index.cjs +17 -0
- package/dist/plugins/index.d.cts +9 -0
- package/dist/plugins/index.d.mts +9 -0
- package/dist/plugins/index.mjs +7 -0
- package/dist/plugins/insights/index.cjs +48 -0
- package/dist/plugins/insights/index.d.cts +295 -0
- package/dist/plugins/insights/index.d.mts +295 -0
- package/dist/plugins/insights/index.mjs +44 -0
- package/dist/plugins/insights/model.cjs +17 -0
- package/dist/plugins/insights/model.d.cts +10 -0
- package/dist/plugins/insights/model.d.mts +10 -0
- package/dist/plugins/insights/model.mjs +17 -0
- package/dist/plugins/insights/reads.cjs +471 -0
- package/dist/plugins/insights/reads.mjs +466 -0
- package/dist/plugins/insights/recordEvent.cjs +135 -0
- package/dist/plugins/insights/recordEvent.d.cts +13 -0
- package/dist/plugins/insights/recordEvent.d.mts +13 -0
- package/dist/plugins/insights/recordEvent.mjs +132 -0
- package/dist/plugins/insights/schema.cjs +347 -0
- package/dist/plugins/insights/schema.d.cts +258 -0
- package/dist/plugins/insights/schema.d.mts +258 -0
- package/dist/plugins/insights/schema.mjs +344 -0
- package/dist/types/index.d.cts +2 -28
- package/dist/types/index.d.mts +2 -28
- package/package.json +28 -5
- package/src/adapters/drizzle.conformance.integration.spec.ts +34 -0
- package/src/adapters/drizzle.readBudgets.integration.spec.ts +41 -0
- package/src/adapters/drizzle.spec.ts +270 -399
- package/src/adapters/drizzle.ts +48 -140
- package/src/adapters/drizzleExecutor.ts +166 -0
- package/src/adapters/kysely.conformance.integration.spec.ts +36 -0
- package/src/adapters/kysely.readBudgets.integration.spec.ts +42 -0
- package/src/adapters/kysely.spec.ts +204 -171
- package/src/adapters/kysely.ts +32 -93
- package/src/adapters/kyselyExecutor.ts +53 -0
- package/src/adapters/mongodb.integration.spec.ts +143 -446
- package/src/adapters/mongodb.readBudgets.integration.spec.ts +61 -0
- package/src/adapters/mongodb.ts +36 -123
- package/src/adapters/mongodbAdapter.ts +293 -0
- package/src/adapters/prisma.conformance.integration.spec.ts +36 -0
- package/src/adapters/prisma.integration.spec.ts +138 -0
- package/src/adapters/prisma.readBudgets.integration.spec.ts +40 -0
- package/src/adapters/prisma.spec.ts +216 -433
- package/src/adapters/prisma.ts +60 -524
- package/src/adapters/prismaExecutor.ts +107 -0
- package/src/adapters/prismaTestClients.ts +175 -0
- package/src/adapters/sqlProviders.ts +14 -0
- package/src/apiKeys.integration.spec.ts +19 -119
- package/src/apiKeys.spec.ts +39 -35
- package/src/apiKeys.ts +2 -8
- package/src/assembly/assemblePlugins.ts +269 -0
- package/src/assembly/assembly.spec.ts +325 -0
- package/src/assembly/assembly.types.spec.ts +155 -0
- package/src/assembly/builtInRoutes.spec.ts +213 -0
- package/src/assembly/databasePlugins.spec.ts +71 -0
- package/src/assembly/databasePlugins.ts +96 -0
- package/src/core/api.ts +139 -0
- package/src/core/baseCandidates.spec.ts +378 -0
- package/src/core/baseCandidates.ts +136 -0
- package/src/core/index.ts +44 -0
- package/src/core/operations.spec.ts +415 -0
- package/src/core/operations.ts +551 -0
- package/src/core/reads.spec.ts +300 -0
- package/src/core/reads.ts +417 -0
- package/src/core/releases.spec.ts +308 -0
- package/src/core/releases.ts +345 -0
- package/src/core/schema.ts +173 -0
- package/src/core/writes.ts +160 -0
- package/src/createHotUpdaterCore.ts +191 -181
- package/src/database/cursor.ts +65 -0
- package/src/database/database.ts +335 -0
- package/src/database/database.types.spec.ts +135 -0
- package/src/database/definitions.ts +72 -0
- package/src/database/engine.ts +62 -0
- package/src/database/engineAggregates.spec.ts +539 -0
- package/src/database/engineAggregates.ts +193 -0
- package/src/database/engineReads.spec.ts +219 -0
- package/src/database/engineReads.ts +302 -0
- package/src/database/engineTransaction.spec.ts +710 -0
- package/src/database/engineTransaction.ts +588 -0
- package/src/database/errors.ts +30 -0
- package/src/database/fence.spec.ts +223 -0
- package/src/database/fence.ts +171 -0
- package/src/database/index.ts +154 -0
- package/src/database/kv/kvAdapter.conformance.integration.spec.ts +17 -0
- package/src/database/kv/kvAdapter.readBudgets.integration.spec.ts +17 -0
- package/src/database/kv/kvAdapter.spec.ts +468 -0
- package/src/database/kv/kvAdapter.ts +450 -0
- package/src/database/kv/kvTestStore.ts +91 -0
- package/src/database/memory.readBudgets.integration.spec.ts +13 -0
- package/src/database/resolveSchema.spec.ts +230 -0
- package/src/database/resolveSchema.ts +372 -0
- package/src/database/schema.ts +169 -0
- package/src/database/schema.types.spec.ts +94 -0
- package/src/database/sql/docker-compose.yml +36 -0
- package/src/database/sql/sqlAdapter.integration.spec.ts +148 -0
- package/src/database/sql/sqlAdapter.readBudgets.integration.spec.ts +109 -0
- package/src/database/sql/sqlAdapter.spec.ts +255 -0
- package/src/database/sql/sqlAdapter.ts +532 -0
- package/src/database/sql/sqlSchema.ts +205 -0
- package/src/database/sql/sqlTestExecutors.ts +183 -0
- package/src/databaseTestSuite.spec.ts +39 -0
- package/src/db/builtInDatabase.ts +149 -0
- package/src/db/bundleRows.spec.ts +3 -3
- package/src/db/createBundleDiff.spec.ts +43 -29
- package/src/db/createBundleDiff.ts +13 -7
- package/src/db/engineDrizzleSchema.ts +72 -0
- package/src/db/engineMigrator.ts +105 -0
- package/src/db/enginePrismaSchema.ts +147 -0
- package/src/db/engineSql.spec.ts +129 -0
- package/src/db/engineSql.ts +48 -0
- package/src/db/engineSqlMigrator.ts +116 -0
- package/src/db/fixedMigratorShared.ts +1 -20
- package/src/db/index.spec.ts +116 -829
- package/src/db/index.ts +43 -14
- package/src/db/pluginTables.spec.ts +218 -0
- package/src/db/releaseCatalog.ts +48 -90
- package/src/db/schemaSettings.ts +104 -0
- package/src/db/settingsMigrator.spec.ts +65 -0
- package/src/db/settingsMigrator.ts +152 -0
- package/src/db/types.ts +25 -171
- package/src/db/updateArtifacts.spec.ts +170 -294
- package/src/db/updateArtifacts.ts +74 -142
- package/src/db/updateCheck.bench.ts +47 -0
- package/src/handler-standalone.integration.spec.ts +204 -410
- package/src/handler.spec.ts +134 -51
- package/src/handler.testFixtures.ts +14 -19
- package/src/handler.ts +163 -75
- package/src/handlerAdminRoutes.spec.ts +183 -0
- package/src/handlerAdminRoutes.ts +536 -0
- package/src/handlerAuth.integration.spec.ts +3 -3
- package/src/handlerManagement.spec.ts +136 -196
- package/src/handlerReleaseCatalogRoutes.ts +15 -17
- package/src/handlerTypes.ts +3 -80
- package/src/handlerVersionRoutes.ts +20 -7
- package/src/index.ts +5 -12
- package/src/insights/domain.ts +12 -0
- package/src/insights/errors.spec.ts +48 -0
- package/src/insights/errors.ts +51 -0
- package/src/insights/eventInput.ts +27 -24
- package/src/insights/insights.integration.spec.ts +228 -78
- package/src/insights/provider.spec.ts +203 -25
- package/src/insights/provider.ts +88 -32
- package/src/insights/routes.ts +95 -20
- package/src/lintRules.spec.ts +76 -0
- package/src/plugins/api-keys/apiKeysPlugin.spec.ts +172 -0
- package/src/plugins/api-keys/index.ts +66 -0
- package/src/plugins/api-keys/model.ts +69 -0
- package/src/plugins/api-keys/schema.ts +22 -0
- package/src/plugins/builtIn.ts +5 -0
- package/src/plugins/definePlugin.ts +100 -0
- package/src/plugins/index.ts +55 -0
- package/src/plugins/insights/index.ts +86 -0
- package/src/plugins/insights/insightsRollout.integration.spec.ts +187 -0
- package/src/plugins/insights/model.spec.ts +66 -0
- package/src/plugins/insights/model.ts +19 -0
- package/src/plugins/insights/reads.spec.ts +725 -0
- package/src/plugins/insights/reads.ts +707 -0
- package/src/plugins/insights/recordEvent.spec.ts +443 -0
- package/src/plugins/insights/recordEvent.ts +238 -0
- package/src/plugins/insights/schema.ts +229 -0
- package/src/plugins/pluginTestHarness.spec.ts +56 -0
- package/src/readBudgets.testFixtures.ts +15 -0
- package/src/releaseCatalogRoutes.integration.spec.ts +47 -92
- package/src/runtime.spec.ts +91 -77
- package/src/runtime.testFixtures.ts +28 -44
- package/src/runtimeBundles.integration.spec.ts +112 -0
- package/src/testUtilsMutation.integration.spec.ts +215 -0
- package/src/testUtilsPackage.integration.spec.ts +176 -0
- package/src/types/index.ts +0 -32
- package/dist/adapters/databaseConstraintErrors.cjs +0 -22
- package/dist/adapters/databaseConstraintErrors.mjs +0 -21
- package/dist/adapters/databasePluginUtils.cjs +0 -130
- package/dist/adapters/databasePluginUtils.mjs +0 -118
- package/dist/adapters/drizzleCrud.cjs +0 -340
- package/dist/adapters/drizzleCrud.mjs +0 -337
- package/dist/adapters/drizzleLazyDB.cjs +0 -103
- package/dist/adapters/drizzleLazyDB.mjs +0 -103
- package/dist/adapters/drizzleQuery.cjs +0 -69
- package/dist/adapters/drizzleQuery.mjs +0 -69
- package/dist/adapters/kyselyCrud.cjs +0 -293
- package/dist/adapters/kyselyCrud.mjs +0 -292
- package/dist/adapters/kyselyQuery.cjs +0 -56
- package/dist/adapters/kyselyQuery.mjs +0 -56
- package/dist/adapters/mongodbCollections.cjs +0 -38
- package/dist/adapters/mongodbCollections.mjs +0 -32
- package/dist/adapters/mongodbQuery.cjs +0 -90
- package/dist/adapters/mongodbQuery.mjs +0 -83
- package/dist/adapters/mongodbReads.cjs +0 -206
- package/dist/adapters/mongodbReads.mjs +0 -206
- package/dist/adapters/mongodbWrites.cjs +0 -133
- package/dist/adapters/mongodbWrites.mjs +0 -133
- package/dist/adapters/prismaInsights.cjs +0 -99
- package/dist/adapters/prismaInsights.mjs +0 -97
- package/dist/adapters/prismaQuery.cjs +0 -57
- package/dist/adapters/prismaQuery.mjs +0 -56
- package/dist/adapters/prismaRows.cjs +0 -197
- package/dist/adapters/prismaRows.mjs +0 -188
- package/dist/db/databasePluginCore.cjs +0 -137
- package/dist/db/databasePluginCore.mjs +0 -137
- package/dist/db/fixedMigrator.cjs +0 -79
- package/dist/db/fixedMigrator.mjs +0 -78
- package/dist/db/fixedMigratorMongo.cjs +0 -321
- package/dist/db/fixedMigratorMongo.mjs +0 -321
- package/dist/db/mongoMigrationExecution.cjs +0 -11
- package/dist/db/mongoMigrationExecution.mjs +0 -11
- package/dist/db/schema/insightsCollation.cjs +0 -14
- package/dist/db/schema/insightsCollation.mjs +0 -14
- package/dist/db/schema/mongodb.cjs +0 -25
- package/dist/db/schema/mongodb.mjs +0 -25
- package/dist/db/schema/registry.cjs +0 -21
- package/dist/db/schema/registry.mjs +0 -17
- package/dist/db/schema/sql.cjs +0 -105
- package/dist/db/schema/sql.mjs +0 -97
- package/dist/db/schema/sqlOperations.cjs +0 -27
- package/dist/db/schema/sqlOperations.mjs +0 -26
- package/dist/db/schemaGenerators.cjs +0 -276
- package/dist/db/schemaGenerators.mjs +0 -274
- package/dist/db/schemaReadiness.cjs +0 -26
- package/dist/db/schemaReadiness.d.cts +0 -9
- package/dist/db/schemaReadiness.d.mts +0 -9
- package/dist/db/schemaReadiness.mjs +0 -25
- package/dist/db/sqlMigrationExecution.cjs +0 -67
- package/dist/db/sqlMigrationExecution.mjs +0 -67
- package/dist/handlerBundleRoutes.cjs +0 -155
- package/dist/handlerBundleRoutes.mjs +0 -155
- package/dist/handlerReleaseManagementRoutes.cjs +0 -124
- package/dist/handlerReleaseManagementRoutes.mjs +0 -124
- package/dist/schema/dsl.cjs +0 -103
- package/dist/schema/dsl.mjs +0 -87
- package/dist/schema/index.cjs +0 -20
- package/dist/schema/index.mjs +0 -7
- package/dist/schema/settings.cjs +0 -9
- package/dist/schema/settings.mjs +0 -9
- package/dist/schema/types.cjs +0 -8
- package/dist/schema/types.mjs +0 -6
- package/dist/schema/v1_0_0.cjs +0 -393
- package/dist/schema/v1_0_0.mjs +0 -385
- package/src/adapters/databaseConstraintErrors.ts +0 -25
- package/src/adapters/databasePluginTestDatabase.ts +0 -116
- package/src/adapters/databasePluginUtils.spec.ts +0 -29
- package/src/adapters/databasePluginUtils.ts +0 -238
- package/src/adapters/drizzleCrud.ts +0 -610
- package/src/adapters/drizzleLazyDB.ts +0 -284
- package/src/adapters/drizzleQuery.ts +0 -164
- package/src/adapters/kyselyCrud.ts +0 -696
- package/src/adapters/kyselyInsights.spec.ts +0 -168
- package/src/adapters/kyselyQuery.ts +0 -128
- package/src/adapters/mongodb.spec.ts +0 -230
- package/src/adapters/mongodbCollections.ts +0 -78
- package/src/adapters/mongodbQuery.ts +0 -245
- package/src/adapters/mongodbReads.ts +0 -387
- package/src/adapters/mongodbRows.spec.ts +0 -64
- package/src/adapters/mongodbRows.ts +0 -118
- package/src/adapters/mongodbTestClient.ts +0 -443
- package/src/adapters/mongodbTestFilter.ts +0 -170
- package/src/adapters/mongodbWrites.ts +0 -261
- package/src/adapters/prismaInsights.ts +0 -190
- package/src/adapters/prismaQuery.ts +0 -129
- package/src/adapters/prismaRows.spec.ts +0 -98
- package/src/adapters/prismaRows.ts +0 -308
- package/src/adapters/prismaTestClient.ts +0 -478
- package/src/calculatePagination.ts +0 -34
- package/src/db/databasePluginCore.spec.ts +0 -62
- package/src/db/databasePluginCore.testFixtures.ts +0 -76
- package/src/db/databasePluginCore.ts +0 -185
- package/src/db/databasePluginUpdateCheck.bench.ts +0 -117
- package/src/db/fixedMigrator.spec.ts +0 -294
- package/src/db/fixedMigrator.ts +0 -147
- package/src/db/fixedMigratorMongo.spec.ts +0 -253
- package/src/db/fixedMigratorMongo.ts +0 -425
- package/src/db/hotUpdaterSchema.ts +0 -5
- package/src/db/mongoMigrationExecution.ts +0 -23
- package/src/db/schema/definitions.ts +0 -1
- package/src/db/schema/insightsCollation.ts +0 -21
- package/src/db/schema/mongodb.ts +0 -40
- package/src/db/schema/registry.ts +0 -55
- package/src/db/schema/sql.ts +0 -244
- package/src/db/schema/sqlOperations.ts +0 -63
- package/src/db/schema/types.ts +0 -1
- package/src/db/schemaGenerators.ts +0 -495
- package/src/db/schemaReadiness.ts +0 -34
- package/src/db/sqlMigrationExecution.spec.ts +0 -65
- package/src/db/sqlMigrationExecution.ts +0 -108
- package/src/db/types.spec.ts +0 -63
- package/src/handlerBundleRoutes.ts +0 -259
- package/src/handlerReleaseManagementRoutes.ts +0 -213
- package/src/schema/dsl-all-versions.spec.ts +0 -35
- package/src/schema/dsl.ts +0 -187
- package/src/schema/index.ts +0 -10
- package/src/schema/settings.ts +0 -15
- package/src/schema/types.ts +0 -79
- package/src/schema/v1_0_0.spec.ts +0 -220
- 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
|
|
167
|
-
|
|
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
|
-
|
|
173
|
-
beforeReceivedAtMs,
|
|
198
|
+
...bounds,
|
|
174
199
|
...cursor === void 0 ? {} : { after: cursor.after },
|
|
175
|
-
limit
|
|
200
|
+
limit
|
|
176
201
|
};
|
|
177
|
-
const rows = await model.listEvents(
|
|
178
|
-
assertEventRows(rows,
|
|
179
|
-
const
|
|
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:
|
|
184
|
-
nextCursor: rows.length
|
|
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
|
-
|
|
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
|
|
262
|
+
limit
|
|
240
263
|
};
|
|
241
264
|
const rows = await model.findLatestEvents(databaseInput);
|
|
242
265
|
assertInstallationRows(rows, databaseInput);
|
|
243
|
-
const
|
|
244
|
-
const last = pageRows.at(-1);
|
|
266
|
+
const last = rows.at(-1);
|
|
245
267
|
return {
|
|
246
|
-
data:
|
|
247
|
-
nextCursor: rows.length
|
|
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
|
|
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 };
|
package/dist/insights/routes.cjs
CHANGED
|
@@ -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
|
-
|
|
6
|
-
|
|
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.
|
|
58
|
-
exports.registerInsightsClientRoutes = registerInsightsClientRoutes;
|
|
123
|
+
exports.insightsDisabled = insightsDisabled;
|
package/dist/insights/routes.mjs
CHANGED
|
@@ -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
|
-
|
|
6
|
-
|
|
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 {
|
|
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
package/dist/package.mjs
CHANGED
|
@@ -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 };
|