@hot-updater/server 1.0.0-rc.1 → 1.0.0-rc.16
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/_virtual/_rolldown/runtime.cjs +1 -1
- package/dist/adapters/drizzle.cjs +35 -69
- package/dist/adapters/drizzle.d.cts +13 -6
- package/dist/adapters/drizzle.d.mts +13 -6
- package/dist/adapters/drizzle.mjs +34 -69
- 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 -7
- package/dist/adapters/kysely.d.mts +10 -7
- package/dist/adapters/kysely.mjs +25 -31
- 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 -27
- package/dist/adapters/mongodb.d.cts +10 -5
- package/dist/adapters/mongodb.d.mts +10 -5
- package/dist/adapters/mongodb.mjs +28 -27
- 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 -220
- package/dist/adapters/prisma.d.cts +12 -8
- package/dist/adapters/prisma.d.mts +12 -8
- package/dist/adapters/prisma.mjs +38 -219
- 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 +8 -8
- package/dist/apiKeys.d.cts +1 -24
- package/dist/apiKeys.d.mts +1 -24
- package/dist/apiKeys.mjs +5 -9
- 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 +61 -63
- package/dist/createHotUpdaterCore.d.cts +53 -45
- package/dist/createHotUpdaterCore.d.mts +53 -45
- package/dist/createHotUpdaterCore.mjs +61 -63
- 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 +6 -6
- package/dist/db/createBundleDiff.d.cts +4 -7
- package/dist/db/createBundleDiff.d.mts +4 -7
- 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 -4
- package/dist/db/index.d.mts +10 -4
- package/dist/db/index.mjs +16 -8
- package/dist/db/releaseCatalog.cjs +20 -44
- package/dist/db/releaseCatalog.d.cts +2 -3
- package/dist/db/releaseCatalog.d.mts +2 -3
- 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 +3 -12
- package/dist/db/types.d.cts +26 -69
- package/dist/db/types.d.mts +26 -69
- package/dist/db/types.mjs +2 -11
- package/dist/db/updateArtifacts.cjs +38 -68
- package/dist/db/updateArtifacts.mjs +40 -69
- package/dist/handler.cjs +72 -43
- package/dist/handler.d.cts +3 -6
- package/dist/handler.d.mts +3 -6
- 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 -14
- package/dist/handlerReleaseCatalogRoutes.mjs +11 -13
- package/dist/handlerTypes.d.cts +2 -56
- package/dist/handlerTypes.d.mts +2 -56
- package/dist/handlerVersionRoutes.cjs +20 -4
- package/dist/handlerVersionRoutes.d.cts +1 -0
- package/dist/handlerVersionRoutes.d.mts +1 -0
- package/dist/handlerVersionRoutes.mjs +20 -4
- package/dist/index.cjs +4 -7
- package/dist/index.d.cts +10 -9
- package/dist/index.d.mts +10 -9
- package/dist/index.mjs +4 -4
- package/dist/insights/domain.d.cts +53 -70
- package/dist/insights/domain.d.mts +53 -70
- package/dist/insights/errors.cjs +35 -8
- package/dist/insights/errors.mjs +35 -8
- package/dist/insights/eventInput.cjs +64 -24
- package/dist/insights/eventInput.mjs +63 -25
- package/dist/insights/provider.cjs +356 -0
- package/dist/insights/provider.d.cts +6 -0
- package/dist/insights/provider.d.mts +6 -0
- package/dist/insights/provider.mjs +355 -0
- package/dist/insights/queryInput.cjs +78 -43
- package/dist/insights/queryInput.mjs +76 -40
- package/dist/insights/routes.cjs +94 -34
- package/dist/insights/routes.mjs +93 -35
- package/dist/insights/types.d.cts +27 -12
- package/dist/insights/types.d.mts +27 -12
- package/dist/node.d.cts +1 -2
- package/dist/node.d.mts +1 -2
- 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/storageAccess.cjs +0 -1
- package/dist/types/index.d.cts +2 -29
- package/dist/types/index.d.mts +2 -29
- package/package.json +30 -7
- 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 +277 -208
- package/src/adapters/drizzle.ts +48 -128
- 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 +212 -117
- package/src/adapters/kysely.ts +32 -87
- package/src/adapters/kyselyExecutor.ts +53 -0
- package/src/adapters/mongodb.integration.spec.ts +180 -0
- package/src/adapters/mongodb.readBudgets.integration.spec.ts +61 -0
- package/src/adapters/mongodb.ts +36 -65
- 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 +226 -173
- package/src/adapters/prisma.ts +60 -451
- 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 -167
- 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 -824
- 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 -165
- 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 -412
- 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 +7 -14
- package/src/insights/domain.ts +56 -77
- package/src/insights/errors.spec.ts +48 -0
- package/src/insights/errors.ts +50 -6
- package/src/insights/eventInput.ts +80 -27
- package/src/insights/insights.integration.spec.ts +525 -44
- package/src/insights/provider.spec.ts +574 -0
- package/src/insights/provider.ts +667 -0
- package/src/insights/queryInput.ts +113 -73
- package/src/insights/routes.ts +125 -69
- package/src/insights/types.ts +47 -36
- 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 -23
- package/dist/adapters/databaseConstraintErrors.mjs +0 -21
- package/dist/adapters/databasePluginUtils.cjs +0 -117
- package/dist/adapters/databasePluginUtils.mjs +0 -106
- package/dist/adapters/drizzleCrud.cjs +0 -250
- package/dist/adapters/drizzleCrud.mjs +0 -249
- package/dist/adapters/drizzleLazyDB.cjs +0 -101
- package/dist/adapters/drizzleLazyDB.mjs +0 -101
- package/dist/adapters/drizzleQuery.cjs +0 -68
- package/dist/adapters/drizzleQuery.mjs +0 -67
- package/dist/adapters/kyselyCrud.cjs +0 -254
- package/dist/adapters/kyselyCrud.mjs +0 -253
- package/dist/adapters/kyselyQuery.cjs +0 -56
- package/dist/adapters/kyselyQuery.mjs +0 -55
- package/dist/adapters/mongodbCollections.cjs +0 -36
- package/dist/adapters/mongodbCollections.mjs +0 -30
- package/dist/adapters/mongodbQuery.cjs +0 -77
- package/dist/adapters/mongodbQuery.mjs +0 -70
- package/dist/adapters/mongodbReads.cjs +0 -148
- package/dist/adapters/mongodbReads.mjs +0 -147
- package/dist/adapters/mongodbWrites.cjs +0 -134
- package/dist/adapters/mongodbWrites.mjs +0 -133
- package/dist/adapters/prismaQuery.cjs +0 -58
- package/dist/adapters/prismaQuery.mjs +0 -56
- package/dist/adapters/prismaRows.cjs +0 -198
- package/dist/adapters/prismaRows.mjs +0 -188
- package/dist/db/databasePluginCore.cjs +0 -138
- 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 -319
- package/dist/db/fixedMigratorMongo.mjs +0 -319
- package/dist/db/mongoMigrationExecution.cjs +0 -11
- package/dist/db/mongoMigrationExecution.mjs +0 -11
- 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 -101
- 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 -256
- package/dist/db/schemaGenerators.mjs +0 -254
- package/dist/db/schemaReadiness.cjs +0 -24
- package/dist/db/schemaReadiness.d.cts +0 -8
- package/dist/db/schemaReadiness.d.mts +0 -8
- package/dist/db/schemaReadiness.mjs +0 -23
- package/dist/db/sqlMigrationExecution.cjs +0 -67
- package/dist/db/sqlMigrationExecution.mjs +0 -66
- package/dist/handlerBundleRoutes.cjs +0 -155
- package/dist/handlerBundleRoutes.mjs +0 -155
- package/dist/handlerReleaseManagementRoutes.cjs +0 -125
- package/dist/handlerReleaseManagementRoutes.mjs +0 -124
- package/dist/insights/bounded/activeOverview.cjs +0 -87
- package/dist/insights/bounded/activeOverview.mjs +0 -85
- package/dist/insights/bounded/installationSearch.cjs +0 -42
- package/dist/insights/bounded/installationSearch.mjs +0 -42
- package/dist/insights/bounded/persistence.cjs +0 -39
- package/dist/insights/bounded/persistence.mjs +0 -38
- package/dist/insights/bounded/provider.cjs +0 -170
- package/dist/insights/bounded/provider.d.cts +0 -7
- package/dist/insights/bounded/provider.d.mts +0 -7
- package/dist/insights/bounded/provider.mjs +0 -170
- package/dist/insights/bounded/scan.cjs +0 -144
- package/dist/insights/bounded/scan.mjs +0 -138
- package/dist/insights/persistence.d.cts +0 -6
- package/dist/insights/persistence.d.mts +0 -6
- package/dist/schema/dsl.cjs +0 -103
- package/dist/schema/dsl.mjs +0 -87
- package/dist/schema/index.cjs +0 -6
- 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 -364
- package/dist/schema/v1_0_0.mjs +0 -357
- package/src/adapters/databaseConstraintErrors.ts +0 -25
- package/src/adapters/databasePluginTestDatabase.ts +0 -106
- package/src/adapters/databasePluginUtils.spec.ts +0 -29
- package/src/adapters/databasePluginUtils.ts +0 -214
- package/src/adapters/drizzleCrud.ts +0 -419
- package/src/adapters/drizzleLazyDB.ts +0 -257
- package/src/adapters/drizzleQuery.ts +0 -164
- package/src/adapters/kyselyCrud.ts +0 -588
- package/src/adapters/kyselyQuery.ts +0 -128
- package/src/adapters/mongodb.spec.ts +0 -141
- package/src/adapters/mongodbCollections.ts +0 -62
- package/src/adapters/mongodbQuery.ts +0 -226
- package/src/adapters/mongodbReads.ts +0 -311
- package/src/adapters/mongodbRows.spec.ts +0 -64
- package/src/adapters/mongodbRows.ts +0 -118
- package/src/adapters/mongodbTestClient.ts +0 -342
- package/src/adapters/mongodbTestFilter.ts +0 -166
- package/src/adapters/mongodbWrites.ts +0 -260
- package/src/adapters/prismaQuery.ts +0 -129
- package/src/adapters/prismaRows.spec.ts +0 -98
- package/src/adapters/prismaRows.ts +0 -301
- package/src/adapters/prismaTestClient.ts +0 -396
- 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 -107
- package/src/db/fixedMigrator.spec.ts +0 -231
- package/src/db/fixedMigrator.ts +0 -147
- package/src/db/fixedMigratorMongo.spec.ts +0 -192
- 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/mongodb.ts +0 -40
- package/src/db/schema/registry.ts +0 -55
- package/src/db/schema/sql.ts +0 -241
- package/src/db/schema/sqlOperations.ts +0 -63
- package/src/db/schema/types.ts +0 -1
- package/src/db/schemaGenerators.ts +0 -466
- 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 -55
- package/src/handlerBundleRoutes.ts +0 -259
- package/src/handlerReleaseManagementRoutes.ts +0 -213
- package/src/insights/bounded/activeOverview.spec.ts +0 -189
- package/src/insights/bounded/activeOverview.ts +0 -148
- package/src/insights/bounded/installationSearch.spec.ts +0 -130
- package/src/insights/bounded/installationSearch.ts +0 -69
- package/src/insights/bounded/persistence.ts +0 -43
- package/src/insights/bounded/provider.spec.ts +0 -219
- package/src/insights/bounded/provider.ts +0 -229
- package/src/insights/bounded/scan.ts +0 -235
- package/src/insights/persistence.ts +0 -10
- 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 -146
- package/src/schema/v1_0_0.ts +0 -465
|
@@ -0,0 +1,155 @@
|
|
|
1
|
+
import { describe, expectTypeOf, it } from "vitest";
|
|
2
|
+
|
|
3
|
+
import {
|
|
4
|
+
type ClientAccessPolicy,
|
|
5
|
+
type ClientAccessRule,
|
|
6
|
+
createHotUpdater,
|
|
7
|
+
type CreateHotUpdaterOptions,
|
|
8
|
+
type RemovedClientAccess,
|
|
9
|
+
} from "../createHotUpdaterCore";
|
|
10
|
+
import { defineTable } from "../database/schema";
|
|
11
|
+
import { definePlugin } from "../plugins/definePlugin";
|
|
12
|
+
|
|
13
|
+
const keys = definePlugin({
|
|
14
|
+
id: "keys",
|
|
15
|
+
provides: { clientAuth: true },
|
|
16
|
+
schemaVersion: "1",
|
|
17
|
+
schema: {},
|
|
18
|
+
init: () => ({
|
|
19
|
+
api: { ping: () => "pong" as const },
|
|
20
|
+
clientAuth: { varyHeaders: ["x-key"], authenticate: async () => true },
|
|
21
|
+
}),
|
|
22
|
+
});
|
|
23
|
+
|
|
24
|
+
const sso = definePlugin({
|
|
25
|
+
id: "sso",
|
|
26
|
+
provides: { clientAuth: true },
|
|
27
|
+
schemaVersion: "1",
|
|
28
|
+
schema: {},
|
|
29
|
+
init: () => ({
|
|
30
|
+
api: {},
|
|
31
|
+
clientAuth: { varyHeaders: [], authenticate: async () => true },
|
|
32
|
+
}),
|
|
33
|
+
});
|
|
34
|
+
|
|
35
|
+
const notes = definePlugin({
|
|
36
|
+
id: "notes",
|
|
37
|
+
schemaVersion: "1",
|
|
38
|
+
schema: {
|
|
39
|
+
notes: defineTable({ id: { type: "string" } }, { key: ["id"] }),
|
|
40
|
+
},
|
|
41
|
+
init: ({ db }) => ({
|
|
42
|
+
api: { read: (id: string) => db.findOne("notes", { id }) },
|
|
43
|
+
}),
|
|
44
|
+
});
|
|
45
|
+
|
|
46
|
+
type Database = CreateHotUpdaterOptions["database"];
|
|
47
|
+
|
|
48
|
+
/** The callback is type-checked and never runs. */
|
|
49
|
+
const typeOnly = (check: (database: Database) => void) => void check;
|
|
50
|
+
|
|
51
|
+
describe("createHotUpdater types", () => {
|
|
52
|
+
it("counts clientAuth plugins in a tuple and names the fix", () => {
|
|
53
|
+
expectTypeOf<ClientAccessRule<readonly []>>().toEqualTypeOf<{
|
|
54
|
+
readonly clientAccess: ClientAccessPolicy;
|
|
55
|
+
}>();
|
|
56
|
+
expectTypeOf<ClientAccessRule<readonly [typeof notes]>>().toEqualTypeOf<{
|
|
57
|
+
readonly clientAccess: ClientAccessPolicy;
|
|
58
|
+
}>();
|
|
59
|
+
expectTypeOf<ClientAccessRule<readonly [typeof keys]>>().toEqualTypeOf<{
|
|
60
|
+
readonly clientAccess?: 'Remove clientAccess: plugin "keys" provides clientAuth';
|
|
61
|
+
}>();
|
|
62
|
+
expectTypeOf<
|
|
63
|
+
ClientAccessRule<readonly [typeof keys, typeof notes, typeof sso]>
|
|
64
|
+
>().toEqualTypeOf<{
|
|
65
|
+
readonly clientAuth: 'Keep one clientAuth plugin: "keys", "sso" all provide it';
|
|
66
|
+
}>();
|
|
67
|
+
expectTypeOf<
|
|
68
|
+
ClientAccessRule<readonly (typeof keys | typeof notes)[]>
|
|
69
|
+
>().toEqualTypeOf<{
|
|
70
|
+
readonly clientAccess?: "Remove clientAccess: a plugin in this list may provide clientAuth";
|
|
71
|
+
}>();
|
|
72
|
+
});
|
|
73
|
+
|
|
74
|
+
it("accepts exactly one policy source", () => {
|
|
75
|
+
typeOnly((database) => {
|
|
76
|
+
createHotUpdater({ database, plugins: [notes, keys] });
|
|
77
|
+
createHotUpdater({ database, plugins: [notes], clientAccess: "public" });
|
|
78
|
+
createHotUpdater({ database, clientAccess: "public" });
|
|
79
|
+
// @ts-expect-error Neither a clientAuth plugin nor "public".
|
|
80
|
+
createHotUpdater({ database, plugins: [notes] });
|
|
81
|
+
createHotUpdater({
|
|
82
|
+
database,
|
|
83
|
+
plugins: [keys],
|
|
84
|
+
// @ts-expect-error clientAuth and "public" together.
|
|
85
|
+
clientAccess: "public",
|
|
86
|
+
});
|
|
87
|
+
// @ts-expect-error Two plugins provide clientAuth.
|
|
88
|
+
createHotUpdater({ database, plugins: [keys, sso] });
|
|
89
|
+
});
|
|
90
|
+
});
|
|
91
|
+
|
|
92
|
+
it("names apiKeys() where a clientAccess object from before 1.0 is written", () => {
|
|
93
|
+
expectTypeOf<ClientAccessPolicy>().toEqualTypeOf<
|
|
94
|
+
"public" | RemovedClientAccess
|
|
95
|
+
>();
|
|
96
|
+
expectTypeOf<
|
|
97
|
+
RemovedClientAccess["type"]
|
|
98
|
+
>().toEqualTypeOf<'clientAccess objects were removed in 1.0: set clientAccess: "public", or add apiKeys() from @hot-updater/server/plugins/api-keys to plugins'>();
|
|
99
|
+
typeOnly((database) => {
|
|
100
|
+
// @ts-expect-error clientAccess objects were removed in 1.0.
|
|
101
|
+
createHotUpdater({ database, clientAccess: { type: "public" } });
|
|
102
|
+
createHotUpdater({
|
|
103
|
+
database,
|
|
104
|
+
// @ts-expect-error clientAccess objects were removed in 1.0.
|
|
105
|
+
clientAccess: { type: "api-key", headerName: "x-client-key" },
|
|
106
|
+
});
|
|
107
|
+
});
|
|
108
|
+
});
|
|
109
|
+
|
|
110
|
+
it("rejects core passed as a plugin and a clientAuth the plugin did not declare", () => {
|
|
111
|
+
const core = {
|
|
112
|
+
kind: "core",
|
|
113
|
+
id: "core",
|
|
114
|
+
schemaVersion: "1",
|
|
115
|
+
schema: {},
|
|
116
|
+
init: () => ({ api: {} }),
|
|
117
|
+
} as const;
|
|
118
|
+
typeOnly((database) => {
|
|
119
|
+
createHotUpdater({
|
|
120
|
+
database,
|
|
121
|
+
// @ts-expect-error Core is built in; it is not a plugin.
|
|
122
|
+
plugins: [core],
|
|
123
|
+
});
|
|
124
|
+
});
|
|
125
|
+
definePlugin({
|
|
126
|
+
id: "sneaky",
|
|
127
|
+
schemaVersion: "1",
|
|
128
|
+
schema: {},
|
|
129
|
+
init: () => ({
|
|
130
|
+
api: {},
|
|
131
|
+
// @ts-expect-error Declare provides: { clientAuth: true } to return clientAuth.
|
|
132
|
+
clientAuth: { varyHeaders: [], authenticate: async () => true },
|
|
133
|
+
}),
|
|
134
|
+
});
|
|
135
|
+
definePlugin({
|
|
136
|
+
id: "promised",
|
|
137
|
+
provides: { clientAuth: true },
|
|
138
|
+
schemaVersion: "1",
|
|
139
|
+
schema: {},
|
|
140
|
+
// @ts-expect-error A plugin that provides clientAuth must return it.
|
|
141
|
+
init: () => ({ api: {} }),
|
|
142
|
+
});
|
|
143
|
+
});
|
|
144
|
+
|
|
145
|
+
it("types each plugin's API by id", () => {
|
|
146
|
+
type Api = ReturnType<
|
|
147
|
+
typeof createHotUpdater<readonly [typeof keys, typeof notes]>
|
|
148
|
+
>["api"];
|
|
149
|
+
expectTypeOf<keyof Api>().toEqualTypeOf<"keys" | "notes">();
|
|
150
|
+
expectTypeOf<ReturnType<Api["keys"]["ping"]>>().toEqualTypeOf<"pong">();
|
|
151
|
+
expectTypeOf<Parameters<Api["notes"]["read"]>>().toEqualTypeOf<
|
|
152
|
+
[id: string]
|
|
153
|
+
>();
|
|
154
|
+
});
|
|
155
|
+
});
|
|
@@ -0,0 +1,213 @@
|
|
|
1
|
+
import { createMemoryAdapter } from "@hot-updater/plugin-core/internal";
|
|
2
|
+
import { afterEach, describe, expect, it, vi } from "vitest";
|
|
3
|
+
|
|
4
|
+
import { createHotUpdater } from "../createHotUpdaterCore";
|
|
5
|
+
import { type HotUpdaterHandlers, listHotUpdaterRoutes } from "../handler";
|
|
6
|
+
import { INSIGHTS_OFF_WARNING, INSIGHTS_ROUTES } from "../insights/routes";
|
|
7
|
+
import { apiKeys } from "../plugins/api-keys";
|
|
8
|
+
import { definePlugin } from "../plugins/definePlugin";
|
|
9
|
+
import { insights } from "../plugins/insights";
|
|
10
|
+
import { HotUpdaterConfigError } from "./assemblePlugins";
|
|
11
|
+
|
|
12
|
+
const database = () => ({ name: "memory", adapter: createMemoryAdapter() });
|
|
13
|
+
|
|
14
|
+
const event = {
|
|
15
|
+
appVersion: "1.0.0",
|
|
16
|
+
channel: "production",
|
|
17
|
+
cohort: "default",
|
|
18
|
+
fingerprintHash: null,
|
|
19
|
+
fromBundleId: null,
|
|
20
|
+
fromReleaseId: null,
|
|
21
|
+
installId: "install-1",
|
|
22
|
+
platform: "ios",
|
|
23
|
+
toBundleId: "bundle-1",
|
|
24
|
+
toReleaseId: null,
|
|
25
|
+
type: "UNCHANGED",
|
|
26
|
+
updateStrategy: null,
|
|
27
|
+
userId: "user-1",
|
|
28
|
+
username: "Jane",
|
|
29
|
+
sdkVersion: "2.0.0",
|
|
30
|
+
} as const;
|
|
31
|
+
|
|
32
|
+
const request = (path: string, init: RequestInit = {}) =>
|
|
33
|
+
new Request(`https://updates.example.com${path}`, init);
|
|
34
|
+
|
|
35
|
+
const insightsRoutes = INSIGHTS_ROUTES.map(({ method, path, access }) => ({
|
|
36
|
+
method,
|
|
37
|
+
path,
|
|
38
|
+
access,
|
|
39
|
+
}));
|
|
40
|
+
|
|
41
|
+
describe("Insights routes with plugins", () => {
|
|
42
|
+
afterEach(() => {
|
|
43
|
+
vi.restoreAllMocks();
|
|
44
|
+
});
|
|
45
|
+
|
|
46
|
+
it("come from the insights plugin when plugins hold it", async () => {
|
|
47
|
+
const warn = vi.spyOn(console, "warn").mockImplementation(() => {});
|
|
48
|
+
const hotUpdater = createHotUpdater({
|
|
49
|
+
database: database(),
|
|
50
|
+
plugins: [insights()],
|
|
51
|
+
clientAccess: "public",
|
|
52
|
+
});
|
|
53
|
+
|
|
54
|
+
const ingested = await hotUpdater.handlers.client(
|
|
55
|
+
request("/events", {
|
|
56
|
+
method: "POST",
|
|
57
|
+
headers: { "content-type": "application/json" },
|
|
58
|
+
body: JSON.stringify(event),
|
|
59
|
+
}),
|
|
60
|
+
);
|
|
61
|
+
expect(ingested.status).toBe(204);
|
|
62
|
+
expect(ingested.headers.get("x-hot-updater-insights")).toBeNull();
|
|
63
|
+
const installation = await hotUpdater.handlers.admin(
|
|
64
|
+
request("/installations/install-1"),
|
|
65
|
+
);
|
|
66
|
+
await expect(installation.json()).resolves.toMatchObject({
|
|
67
|
+
latestStatus: "UNCHANGED",
|
|
68
|
+
lastKnownBundleId: "bundle-1",
|
|
69
|
+
});
|
|
70
|
+
expect(listHotUpdaterRoutes(hotUpdater.handlers)).toEqual(
|
|
71
|
+
expect.arrayContaining(insightsRoutes),
|
|
72
|
+
);
|
|
73
|
+
expect(warn).not.toHaveBeenCalled();
|
|
74
|
+
});
|
|
75
|
+
|
|
76
|
+
it("answer 204 with x-hot-updater-insights: disabled when plugins leave it out", async () => {
|
|
77
|
+
const warn = vi.spyOn(console, "warn").mockImplementation(() => {});
|
|
78
|
+
const hotUpdater = createHotUpdater({
|
|
79
|
+
database: database(),
|
|
80
|
+
plugins: [],
|
|
81
|
+
clientAccess: "public",
|
|
82
|
+
});
|
|
83
|
+
|
|
84
|
+
for (const { access, method, path } of INSIGHTS_ROUTES) {
|
|
85
|
+
const response = await hotUpdater.handlers[access](
|
|
86
|
+
request(path.replace(":installId", "install-1"), {
|
|
87
|
+
method,
|
|
88
|
+
...(method === "POST" ? { body: JSON.stringify(event) } : {}),
|
|
89
|
+
}),
|
|
90
|
+
);
|
|
91
|
+
expect(response.status, `${method} ${path}`).toBe(204);
|
|
92
|
+
expect(response.headers.get("x-hot-updater-insights")).toBe("disabled");
|
|
93
|
+
expect(response.headers.get("cache-control")).toBe("private, no-store");
|
|
94
|
+
}
|
|
95
|
+
expect(listHotUpdaterRoutes(hotUpdater.handlers)).toEqual(
|
|
96
|
+
expect.arrayContaining(insightsRoutes),
|
|
97
|
+
);
|
|
98
|
+
expect(warn).toHaveBeenCalledOnce();
|
|
99
|
+
expect(warn).toHaveBeenCalledWith(INSIGHTS_OFF_WARNING);
|
|
100
|
+
});
|
|
101
|
+
|
|
102
|
+
it("warn once per server, on the first event dropped without insights()", async () => {
|
|
103
|
+
const warn = vi.spyOn(console, "warn").mockImplementation(() => {});
|
|
104
|
+
const hotUpdater = createHotUpdater({
|
|
105
|
+
database: database(),
|
|
106
|
+
clientAccess: "public",
|
|
107
|
+
});
|
|
108
|
+
const report = () =>
|
|
109
|
+
hotUpdater.handlers.client(
|
|
110
|
+
request("/events", { method: "POST", body: JSON.stringify(event) }),
|
|
111
|
+
);
|
|
112
|
+
|
|
113
|
+
expect(warn).not.toHaveBeenCalled();
|
|
114
|
+
expect((await report()).status).toBe(204);
|
|
115
|
+
expect((await report()).status).toBe(204);
|
|
116
|
+
expect(warn).toHaveBeenCalledOnce();
|
|
117
|
+
expect(warn).toHaveBeenCalledWith(
|
|
118
|
+
expect.stringContaining(
|
|
119
|
+
"Add insights() from @hot-updater/server/plugins/insights to plugins",
|
|
120
|
+
),
|
|
121
|
+
);
|
|
122
|
+
});
|
|
123
|
+
});
|
|
124
|
+
|
|
125
|
+
describe("admin /version", () => {
|
|
126
|
+
const plugins = async (hotUpdater: { handlers: HotUpdaterHandlers }) =>
|
|
127
|
+
(
|
|
128
|
+
(await (await hotUpdater.handlers.admin(request("/version"))).json()) as {
|
|
129
|
+
plugins: unknown;
|
|
130
|
+
}
|
|
131
|
+
).plugins;
|
|
132
|
+
|
|
133
|
+
it("lists the built-in plugins the server runs, sorted by id", async () => {
|
|
134
|
+
await expect(
|
|
135
|
+
plugins(
|
|
136
|
+
createHotUpdater({
|
|
137
|
+
database: database(),
|
|
138
|
+
plugins: [insights(), apiKeys()],
|
|
139
|
+
}),
|
|
140
|
+
),
|
|
141
|
+
).resolves.toEqual(["apiKeys", "insights"]);
|
|
142
|
+
await expect(
|
|
143
|
+
plugins(
|
|
144
|
+
createHotUpdater({
|
|
145
|
+
database: database(),
|
|
146
|
+
plugins: [insights()],
|
|
147
|
+
clientAccess: "public",
|
|
148
|
+
}),
|
|
149
|
+
),
|
|
150
|
+
).resolves.toEqual(["insights"]);
|
|
151
|
+
});
|
|
152
|
+
|
|
153
|
+
it("lists none for a server without plugins, whose Insights routes still say it is off", async () => {
|
|
154
|
+
const hotUpdater = createHotUpdater({
|
|
155
|
+
database: database(),
|
|
156
|
+
clientAccess: "public",
|
|
157
|
+
});
|
|
158
|
+
|
|
159
|
+
await expect(plugins(hotUpdater)).resolves.toEqual([]);
|
|
160
|
+
const events = await hotUpdater.handlers.admin(request("/events"));
|
|
161
|
+
expect(events.status).toBe(204);
|
|
162
|
+
expect(events.headers.get("x-hot-updater-insights")).toBe("disabled");
|
|
163
|
+
});
|
|
164
|
+
});
|
|
165
|
+
|
|
166
|
+
describe("core reads", () => {
|
|
167
|
+
it("reads core through hotUpdater.core and a plugin's ctx.core", async () => {
|
|
168
|
+
const channels = definePlugin({
|
|
169
|
+
id: "channel_names",
|
|
170
|
+
schemaVersion: "1",
|
|
171
|
+
schema: {},
|
|
172
|
+
init: ({ core }) => ({
|
|
173
|
+
api: {
|
|
174
|
+
names: async () =>
|
|
175
|
+
(await core.listChannels()).map((channel) => channel.name),
|
|
176
|
+
},
|
|
177
|
+
}),
|
|
178
|
+
});
|
|
179
|
+
const hotUpdater = createHotUpdater({
|
|
180
|
+
database: database(),
|
|
181
|
+
plugins: [channels],
|
|
182
|
+
clientAccess: "public",
|
|
183
|
+
});
|
|
184
|
+
const channel = await hotUpdater.core.ensureChannel("production");
|
|
185
|
+
|
|
186
|
+
await expect(
|
|
187
|
+
hotUpdater.core.findChannelByName("production"),
|
|
188
|
+
).resolves.toEqual(channel);
|
|
189
|
+
await expect(hotUpdater.api.channel_names.names()).resolves.toEqual([
|
|
190
|
+
"production",
|
|
191
|
+
]);
|
|
192
|
+
});
|
|
193
|
+
|
|
194
|
+
it('keeps the plugin id "core" for core', () => {
|
|
195
|
+
const impostor = definePlugin({
|
|
196
|
+
id: "core",
|
|
197
|
+
schemaVersion: "1",
|
|
198
|
+
schema: {},
|
|
199
|
+
init: () => ({ api: {} }),
|
|
200
|
+
});
|
|
201
|
+
const start = () =>
|
|
202
|
+
createHotUpdater({
|
|
203
|
+
database: database(),
|
|
204
|
+
plugins: [impostor],
|
|
205
|
+
clientAccess: "public",
|
|
206
|
+
});
|
|
207
|
+
|
|
208
|
+
expect(start).toThrow(HotUpdaterConfigError);
|
|
209
|
+
expect(start).toThrow(
|
|
210
|
+
'plugins[0] uses the id "core", which is core\'s own.',
|
|
211
|
+
);
|
|
212
|
+
});
|
|
213
|
+
});
|
|
@@ -0,0 +1,71 @@
|
|
|
1
|
+
import { createMemoryAdapter } from "@hot-updater/plugin-core/internal";
|
|
2
|
+
import { describe, expect, it } from "vitest";
|
|
3
|
+
|
|
4
|
+
import { apiKeys } from "../plugins/api-keys";
|
|
5
|
+
import { insights } from "../plugins/insights";
|
|
6
|
+
import { HotUpdaterConfigError } from "./assemblePlugins";
|
|
7
|
+
import {
|
|
8
|
+
createDatabasePluginApis,
|
|
9
|
+
createMeasuredDatabase,
|
|
10
|
+
} from "./databasePlugins";
|
|
11
|
+
|
|
12
|
+
describe("createDatabasePluginApis", () => {
|
|
13
|
+
it("assembles the listed plugins over the database's engine, on the server's tables", async () => {
|
|
14
|
+
const database = { name: "memory", adapter: createMemoryAdapter() };
|
|
15
|
+
|
|
16
|
+
const api = createDatabasePluginApis(database, [insights(), apiKeys()]);
|
|
17
|
+
const created = await api.apiKeys.create({ name: "Console" });
|
|
18
|
+
|
|
19
|
+
expect(Object.keys(api).sort()).toEqual(["apiKeys", "insights"]);
|
|
20
|
+
// Another assembly over the same database reads the same table.
|
|
21
|
+
await expect(
|
|
22
|
+
createDatabasePluginApis(database, [apiKeys()]).apiKeys.list(),
|
|
23
|
+
).resolves.toEqual([expect.objectContaining({ id: created.record.id })]);
|
|
24
|
+
});
|
|
25
|
+
|
|
26
|
+
it("gives no APIs for an empty plugin list", () => {
|
|
27
|
+
const database = { name: "memory", adapter: createMemoryAdapter() };
|
|
28
|
+
|
|
29
|
+
expect(createDatabasePluginApis(database, [])).toEqual({});
|
|
30
|
+
});
|
|
31
|
+
|
|
32
|
+
it("refuses a database off the storage engine, and a malformed list", () => {
|
|
33
|
+
expect(() =>
|
|
34
|
+
createDatabasePluginApis({ name: "old", models: {} }, [insights()]),
|
|
35
|
+
).toThrow("Upgrade its provider package to 1.0.");
|
|
36
|
+
expect(() =>
|
|
37
|
+
createDatabasePluginApis(
|
|
38
|
+
{ name: "memory", adapter: createMemoryAdapter() },
|
|
39
|
+
[insights(), insights()],
|
|
40
|
+
),
|
|
41
|
+
).toThrow(HotUpdaterConfigError);
|
|
42
|
+
});
|
|
43
|
+
});
|
|
44
|
+
|
|
45
|
+
describe("createMeasuredDatabase", () => {
|
|
46
|
+
it("runs core and the plugins on one engine in verify mode, over the adapter as given", async () => {
|
|
47
|
+
// A bare adapter without settings rows, which the schema fence would refuse.
|
|
48
|
+
const { core, api, clientAuth, measureReads } = createMeasuredDatabase(
|
|
49
|
+
createMemoryAdapter(),
|
|
50
|
+
[insights(), apiKeys()],
|
|
51
|
+
);
|
|
52
|
+
const { apiKey } = await api.apiKeys.create({ name: "Console" });
|
|
53
|
+
await core.ensureChannel("production");
|
|
54
|
+
|
|
55
|
+
const measured = await measureReads(async () => ({
|
|
56
|
+
authenticated: await clientAuth!.authenticate(
|
|
57
|
+
new Headers({ "x-api-key": apiKey }),
|
|
58
|
+
),
|
|
59
|
+
channel: await core.findChannelByName("production"),
|
|
60
|
+
}));
|
|
61
|
+
|
|
62
|
+
expect(measured).toEqual({
|
|
63
|
+
result: {
|
|
64
|
+
authenticated: true,
|
|
65
|
+
channel: { id: expect.any(String), name: "production" },
|
|
66
|
+
},
|
|
67
|
+
adapter: { gets: 0, keys: 0, queries: 2, rows: 2 },
|
|
68
|
+
engine: { calls: 2, rows: 2 },
|
|
69
|
+
});
|
|
70
|
+
});
|
|
71
|
+
});
|
|
@@ -0,0 +1,96 @@
|
|
|
1
|
+
import type { DatabaseAdapter } from "@hot-updater/plugin-core/internal";
|
|
2
|
+
|
|
3
|
+
import {
|
|
4
|
+
engineAdapterOf,
|
|
5
|
+
OFF_ENGINE_DATABASE,
|
|
6
|
+
type CoreApi,
|
|
7
|
+
} from "../core/api";
|
|
8
|
+
import type { CoreStorage } from "../core/reads";
|
|
9
|
+
import type { ReadMeasurement } from "../database/engine";
|
|
10
|
+
import type {
|
|
11
|
+
AnyHotUpdaterPlugin,
|
|
12
|
+
ClientAuth,
|
|
13
|
+
PluginApis,
|
|
14
|
+
} from "../plugins/definePlugin";
|
|
15
|
+
import { assemblePlugins } from "./assemblePlugins";
|
|
16
|
+
|
|
17
|
+
/**
|
|
18
|
+
* The plugins' APIs by plugin id over a configured database, assembled as
|
|
19
|
+
* `createHotUpdater` assembles them: how the console runs Insights and API
|
|
20
|
+
* keys in process, and how init provisions a key, on the tables the server
|
|
21
|
+
* uses. A database off the storage engine, `standaloneRepository` included,
|
|
22
|
+
* is refused: its server runs the plugins.
|
|
23
|
+
*/
|
|
24
|
+
export function createDatabasePluginApis<
|
|
25
|
+
const TPlugins extends readonly AnyHotUpdaterPlugin[],
|
|
26
|
+
>(
|
|
27
|
+
database: unknown,
|
|
28
|
+
plugins: TPlugins,
|
|
29
|
+
options?: { readonly now?: () => number },
|
|
30
|
+
): PluginApis<TPlugins>;
|
|
31
|
+
export function createDatabasePluginApis(
|
|
32
|
+
database: unknown,
|
|
33
|
+
plugins: readonly unknown[],
|
|
34
|
+
options?: { readonly now?: () => number },
|
|
35
|
+
): Readonly<Record<string, unknown>>;
|
|
36
|
+
export function createDatabasePluginApis(
|
|
37
|
+
database: unknown,
|
|
38
|
+
plugins: readonly unknown[],
|
|
39
|
+
options: { readonly now?: () => number } = {},
|
|
40
|
+
): Readonly<Record<string, unknown>> {
|
|
41
|
+
const adapter = engineAdapterOf(database);
|
|
42
|
+
if (adapter === undefined) throw new Error(OFF_ENGINE_DATABASE);
|
|
43
|
+
return assemblePlugins(plugins, adapter, options).api;
|
|
44
|
+
}
|
|
45
|
+
|
|
46
|
+
export interface MeasuredDatabaseOptions {
|
|
47
|
+
readonly now?: () => number;
|
|
48
|
+
/** How core reads bundle manifests and resolves file URLs, for artifact resolution. */
|
|
49
|
+
readonly storage?: CoreStorage;
|
|
50
|
+
}
|
|
51
|
+
|
|
52
|
+
/** Core and the plugins' APIs on one engine in verify mode, and its read meter. */
|
|
53
|
+
export interface MeasuredDatabase<TApi = Readonly<Record<string, unknown>>> {
|
|
54
|
+
readonly core: CoreApi;
|
|
55
|
+
readonly api: TApi;
|
|
56
|
+
/** The client-route policy, when a plugin provides one. */
|
|
57
|
+
readonly clientAuth?: ClientAuth;
|
|
58
|
+
/** Runs `read` and reports what it read at both boundaries. */
|
|
59
|
+
measureReads<T>(read: () => Promise<T>): Promise<ReadMeasurement<T>>;
|
|
60
|
+
}
|
|
61
|
+
|
|
62
|
+
/**
|
|
63
|
+
* Core and the plugins over a storage adapter, assembled as
|
|
64
|
+
* `createHotUpdater` assembles them but on an engine in verify mode, with
|
|
65
|
+
* that engine's `measureReads`: what read-budget suites measure. The adapter
|
|
66
|
+
* runs as given, without the schema fence.
|
|
67
|
+
*/
|
|
68
|
+
export function createMeasuredDatabase<
|
|
69
|
+
const TPlugins extends readonly AnyHotUpdaterPlugin[],
|
|
70
|
+
>(
|
|
71
|
+
adapter: DatabaseAdapter,
|
|
72
|
+
plugins: TPlugins,
|
|
73
|
+
options?: MeasuredDatabaseOptions,
|
|
74
|
+
): MeasuredDatabase<PluginApis<TPlugins>>;
|
|
75
|
+
export function createMeasuredDatabase(
|
|
76
|
+
adapter: DatabaseAdapter,
|
|
77
|
+
plugins: readonly unknown[],
|
|
78
|
+
options?: MeasuredDatabaseOptions,
|
|
79
|
+
): MeasuredDatabase;
|
|
80
|
+
export function createMeasuredDatabase(
|
|
81
|
+
adapter: DatabaseAdapter,
|
|
82
|
+
plugins: readonly unknown[],
|
|
83
|
+
options: MeasuredDatabaseOptions = {},
|
|
84
|
+
): MeasuredDatabase {
|
|
85
|
+
const { core, api, clientAuth, measureReads } = assemblePlugins(
|
|
86
|
+
plugins,
|
|
87
|
+
adapter,
|
|
88
|
+
{ ...options, verify: true },
|
|
89
|
+
);
|
|
90
|
+
return {
|
|
91
|
+
core,
|
|
92
|
+
api,
|
|
93
|
+
...(clientAuth === undefined ? {} : { clientAuth }),
|
|
94
|
+
measureReads: measureReads!,
|
|
95
|
+
};
|
|
96
|
+
}
|
package/src/core/api.ts
ADDED
|
@@ -0,0 +1,139 @@
|
|
|
1
|
+
import type {
|
|
2
|
+
EngineDatabase,
|
|
3
|
+
HotUpdaterCoreApi,
|
|
4
|
+
} from "@hot-updater/plugin-core";
|
|
5
|
+
import type { DatabaseAdapter } from "@hot-updater/plugin-core/internal";
|
|
6
|
+
|
|
7
|
+
import { createDatabaseEngine } from "../database/database";
|
|
8
|
+
import { resolveSchema } from "../database/resolveSchema";
|
|
9
|
+
import { createCoreOperations } from "./operations";
|
|
10
|
+
import { createCoreReads, type CoreDatabase, type CoreStorage } from "./reads";
|
|
11
|
+
import { coreModule } from "./schema";
|
|
12
|
+
|
|
13
|
+
export interface CoreApiOptions {
|
|
14
|
+
readonly now?: () => number;
|
|
15
|
+
/** The database's CDN purge, called after a write that changes a Release Catalog. */
|
|
16
|
+
readonly onCachedRoutesChange?: () => Promise<void>;
|
|
17
|
+
}
|
|
18
|
+
|
|
19
|
+
/**
|
|
20
|
+
* The update check answers from one Release Catalog row, so a transaction
|
|
21
|
+
* changes what the cacheable client routes answer only when it writes one.
|
|
22
|
+
* The purge runs once, after the attempt that commits.
|
|
23
|
+
*/
|
|
24
|
+
const purgingCachedRoutes = (
|
|
25
|
+
db: CoreDatabase,
|
|
26
|
+
onCachedRoutesChange: (() => Promise<void>) | undefined,
|
|
27
|
+
): CoreDatabase => {
|
|
28
|
+
if (onCachedRoutesChange === undefined) return db;
|
|
29
|
+
return {
|
|
30
|
+
...db,
|
|
31
|
+
async transaction(fn) {
|
|
32
|
+
let changed = false;
|
|
33
|
+
const result = await db.transaction((tx) => {
|
|
34
|
+
changed = false;
|
|
35
|
+
return fn({
|
|
36
|
+
...tx,
|
|
37
|
+
create: (model, row) => {
|
|
38
|
+
changed ||= model === "release_catalogs";
|
|
39
|
+
tx.create(model, row);
|
|
40
|
+
},
|
|
41
|
+
update: (model, row, set) => {
|
|
42
|
+
changed ||= model === "release_catalogs";
|
|
43
|
+
tx.update(model, row, set);
|
|
44
|
+
},
|
|
45
|
+
delete: (model, row) => {
|
|
46
|
+
changed ||= model === "release_catalogs";
|
|
47
|
+
return tx.delete(model, row);
|
|
48
|
+
},
|
|
49
|
+
});
|
|
50
|
+
});
|
|
51
|
+
if (changed) await onCachedRoutesChange();
|
|
52
|
+
return result;
|
|
53
|
+
},
|
|
54
|
+
};
|
|
55
|
+
};
|
|
56
|
+
|
|
57
|
+
/** Core's reads and typed writes over one database handle. */
|
|
58
|
+
export const createCoreApi = (
|
|
59
|
+
db: CoreDatabase,
|
|
60
|
+
storage: CoreStorage,
|
|
61
|
+
options: CoreApiOptions = {},
|
|
62
|
+
) => {
|
|
63
|
+
const reads = createCoreReads(db, storage);
|
|
64
|
+
return {
|
|
65
|
+
...reads,
|
|
66
|
+
...createCoreOperations(
|
|
67
|
+
purgingCachedRoutes(db, options.onCachedRoutesChange),
|
|
68
|
+
options,
|
|
69
|
+
),
|
|
70
|
+
/** One read, which checks the schema settings first. */
|
|
71
|
+
ready: async (): Promise<void> => {
|
|
72
|
+
await reads.listReleaseCatalogs({ limit: 1 });
|
|
73
|
+
},
|
|
74
|
+
};
|
|
75
|
+
};
|
|
76
|
+
|
|
77
|
+
export type CoreApi = ReturnType<typeof createCoreApi>;
|
|
78
|
+
|
|
79
|
+
/**
|
|
80
|
+
* Core's API in process, on a database's storage adapter: how the CLI reads
|
|
81
|
+
* and writes a database that runs on the storage engine.
|
|
82
|
+
*/
|
|
83
|
+
export const createInProcessCoreApi = (
|
|
84
|
+
adapter: DatabaseAdapter,
|
|
85
|
+
options: CoreApiOptions = {},
|
|
86
|
+
): CoreApi =>
|
|
87
|
+
createCoreApi(
|
|
88
|
+
createDatabaseEngine({
|
|
89
|
+
adapter,
|
|
90
|
+
schema: resolveSchema([coreModule]),
|
|
91
|
+
}).database(coreModule),
|
|
92
|
+
{ resolveFileUrl: async () => null },
|
|
93
|
+
options,
|
|
94
|
+
);
|
|
95
|
+
|
|
96
|
+
const isRecord = (value: unknown): value is Record<string, unknown> =>
|
|
97
|
+
typeof value === "object" && value !== null;
|
|
98
|
+
|
|
99
|
+
const isAdapter = (value: unknown): value is DatabaseAdapter =>
|
|
100
|
+
isRecord(value) &&
|
|
101
|
+
["fits", "get", "query", "write"].every(
|
|
102
|
+
(method) => typeof value[method] === "function",
|
|
103
|
+
);
|
|
104
|
+
|
|
105
|
+
/** The storage adapter a configured database runs on, if it is on the engine. */
|
|
106
|
+
export const engineAdapterOf = (
|
|
107
|
+
database: unknown,
|
|
108
|
+
): DatabaseAdapter | undefined =>
|
|
109
|
+
isRecord(database) && isAdapter(database.adapter)
|
|
110
|
+
? database.adapter
|
|
111
|
+
: isAdapter(database)
|
|
112
|
+
? database
|
|
113
|
+
: undefined;
|
|
114
|
+
|
|
115
|
+
export const OFF_ENGINE_DATABASE =
|
|
116
|
+
"This database does not run on Hot Updater's storage engine. Upgrade its provider package to 1.0.";
|
|
117
|
+
|
|
118
|
+
/**
|
|
119
|
+
* Core's API for a configured database, as the CLI uses it: a self-hosted
|
|
120
|
+
* server's admin API when the database is `standaloneRepository`, or the
|
|
121
|
+
* database's own storage adapter, in process.
|
|
122
|
+
*/
|
|
123
|
+
export const createDatabaseCoreApi = (
|
|
124
|
+
database: unknown,
|
|
125
|
+
options: { readonly now?: () => number } = {},
|
|
126
|
+
): HotUpdaterCoreApi => {
|
|
127
|
+
if (isRecord(database) && isRecord(database.core)) {
|
|
128
|
+
return database.core as unknown as HotUpdaterCoreApi;
|
|
129
|
+
}
|
|
130
|
+
const adapter = engineAdapterOf(database);
|
|
131
|
+
if (adapter === undefined) throw new Error(OFF_ENGINE_DATABASE);
|
|
132
|
+
const engineDatabase = database as Partial<EngineDatabase>;
|
|
133
|
+
return createInProcessCoreApi(adapter, {
|
|
134
|
+
...options,
|
|
135
|
+
...(typeof engineDatabase.onCachedRoutesChange === "function"
|
|
136
|
+
? { onCachedRoutesChange: () => engineDatabase.onCachedRoutesChange!() }
|
|
137
|
+
: {}),
|
|
138
|
+
});
|
|
139
|
+
};
|