@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,335 @@
|
|
|
1
|
+
import {
|
|
2
|
+
DATABASE_VERSION_COLUMN,
|
|
3
|
+
type DatabaseKeyValue,
|
|
4
|
+
type StoredRow,
|
|
5
|
+
} from "@hot-updater/plugin-core/internal";
|
|
6
|
+
|
|
7
|
+
import { createEngine, type DatabaseEngineOptions } from "./engine";
|
|
8
|
+
import type { Page, ReadInput } from "./engineReads";
|
|
9
|
+
import {
|
|
10
|
+
assertOutsideTransaction,
|
|
11
|
+
type TransactionEngine,
|
|
12
|
+
} from "./engineTransaction";
|
|
13
|
+
import type { SchemaModule } from "./resolveSchema";
|
|
14
|
+
import type {
|
|
15
|
+
AggregateDefinition,
|
|
16
|
+
FieldType,
|
|
17
|
+
FieldValue,
|
|
18
|
+
ModuleSchema,
|
|
19
|
+
RowOf,
|
|
20
|
+
TableDefinition,
|
|
21
|
+
} from "./schema";
|
|
22
|
+
|
|
23
|
+
type TableNames<S extends ModuleSchema> = {
|
|
24
|
+
[K in keyof S]: S[K] extends TableDefinition ? K : never;
|
|
25
|
+
}[keyof S] &
|
|
26
|
+
string;
|
|
27
|
+
|
|
28
|
+
type AggregateNames<S extends ModuleSchema> = {
|
|
29
|
+
[K in keyof S]: S[K] extends AggregateDefinition ? K : never;
|
|
30
|
+
}[keyof S] &
|
|
31
|
+
string;
|
|
32
|
+
|
|
33
|
+
/** Reference counters: how many rows of another table point at this one. */
|
|
34
|
+
type RefColumns = { readonly [K: `_refs_${string}`]: number };
|
|
35
|
+
|
|
36
|
+
/** Engine columns every stored row carries. */
|
|
37
|
+
export type EngineColumns = { readonly _v: number } & RefColumns;
|
|
38
|
+
|
|
39
|
+
type DerivedValues<TDerived> = {
|
|
40
|
+
-readonly [K in keyof TDerived]: TDerived[K] extends FieldType
|
|
41
|
+
? FieldValue<TDerived[K]> | readonly FieldValue<TDerived[K]>[] | null
|
|
42
|
+
: never;
|
|
43
|
+
};
|
|
44
|
+
|
|
45
|
+
type Values<TModel> =
|
|
46
|
+
TModel extends TableDefinition<infer TFields, infer TDerived>
|
|
47
|
+
? RowOf<TFields> & DerivedValues<TDerived>
|
|
48
|
+
: TModel extends AggregateDefinition<
|
|
49
|
+
infer TFields,
|
|
50
|
+
infer TMetric,
|
|
51
|
+
infer _TIndexes,
|
|
52
|
+
infer TSketch
|
|
53
|
+
>
|
|
54
|
+
? RowOf<TFields> & { -readonly [K in TMetric]: number } & {
|
|
55
|
+
-readonly [K in TSketch]: string;
|
|
56
|
+
}
|
|
57
|
+
: never;
|
|
58
|
+
|
|
59
|
+
/** A row read in a transaction, `_v` included, so the transaction can write it back. */
|
|
60
|
+
export type TableRow<TModel> = Values<TModel> & EngineColumns;
|
|
61
|
+
/** A row read outside a transaction, without `_v`, which only a transaction's guard uses. */
|
|
62
|
+
export type ReadRow<TModel> = Values<TModel> & RefColumns;
|
|
63
|
+
export type AggregateRow<TModel> = Values<TModel>;
|
|
64
|
+
|
|
65
|
+
type IndexesOf<TModel> = TModel extends { readonly indexes: infer I }
|
|
66
|
+
? I
|
|
67
|
+
: never;
|
|
68
|
+
type IndexName<TModel> = keyof IndexesOf<TModel> & string;
|
|
69
|
+
type IndexFields<
|
|
70
|
+
TModel,
|
|
71
|
+
TIndex,
|
|
72
|
+
TPart extends "eq" | "sort",
|
|
73
|
+
> = IndexesOf<TModel>[TIndex & keyof IndexesOf<TModel>] extends {
|
|
74
|
+
readonly [P in TPart]: readonly (infer F)[];
|
|
75
|
+
}
|
|
76
|
+
? F & keyof Values<TModel>
|
|
77
|
+
: never;
|
|
78
|
+
|
|
79
|
+
type KeyValueOf<TModel, TField extends keyof Values<TModel>> = Exclude<
|
|
80
|
+
Values<TModel>[TField],
|
|
81
|
+
null | readonly unknown[]
|
|
82
|
+
>;
|
|
83
|
+
|
|
84
|
+
type FirstOrderField<TModel, TIndex> = IndexesOf<TModel>[TIndex &
|
|
85
|
+
keyof IndexesOf<TModel>] extends {
|
|
86
|
+
readonly sort: readonly [infer F, ...unknown[]];
|
|
87
|
+
}
|
|
88
|
+
? F & keyof Values<TModel>
|
|
89
|
+
: TModel extends { readonly key: readonly (infer K)[] }
|
|
90
|
+
? K & keyof Values<TModel>
|
|
91
|
+
: never;
|
|
92
|
+
|
|
93
|
+
export interface ReadOptions<TModel, TIndex> {
|
|
94
|
+
readonly index: TIndex;
|
|
95
|
+
/** Every eq field of the index; null never matches. */
|
|
96
|
+
readonly where: {
|
|
97
|
+
readonly [F in IndexFields<TModel, TIndex, "eq">]: KeyValueOf<TModel, F>;
|
|
98
|
+
};
|
|
99
|
+
/** Bounds on the first order field, or on a prefix of the order tuple (sort fields, then the key). */
|
|
100
|
+
readonly range?: {
|
|
101
|
+
readonly [B in "gt" | "gte" | "lt" | "lte"]?:
|
|
102
|
+
| KeyValueOf<TModel, FirstOrderField<TModel, TIndex>>
|
|
103
|
+
| readonly [
|
|
104
|
+
KeyValueOf<TModel, FirstOrderField<TModel, TIndex>>,
|
|
105
|
+
...DatabaseKeyValue[],
|
|
106
|
+
];
|
|
107
|
+
};
|
|
108
|
+
readonly order?: "asc" | "desc";
|
|
109
|
+
readonly limit: number;
|
|
110
|
+
readonly cursor?: string;
|
|
111
|
+
}
|
|
112
|
+
|
|
113
|
+
type UniqueLookups<TModel> =
|
|
114
|
+
TModel extends TableDefinition<infer TFields, infer _D, infer TIndexes>
|
|
115
|
+
?
|
|
116
|
+
| {
|
|
117
|
+
[F in keyof TFields]: TFields[F] extends { readonly unique: true }
|
|
118
|
+
? {
|
|
119
|
+
readonly [P in F]: KeyValueOf<
|
|
120
|
+
TModel,
|
|
121
|
+
P & keyof Values<TModel>
|
|
122
|
+
>;
|
|
123
|
+
}
|
|
124
|
+
: never;
|
|
125
|
+
}[keyof TFields]
|
|
126
|
+
| {
|
|
127
|
+
[I in keyof TIndexes]: TIndexes[I] extends {
|
|
128
|
+
readonly unique: true;
|
|
129
|
+
readonly eq: readonly (infer E)[];
|
|
130
|
+
}
|
|
131
|
+
? {
|
|
132
|
+
readonly [P in E & string]: KeyValueOf<
|
|
133
|
+
TModel,
|
|
134
|
+
P & keyof Values<TModel>
|
|
135
|
+
>;
|
|
136
|
+
}
|
|
137
|
+
: never;
|
|
138
|
+
}[keyof TIndexes]
|
|
139
|
+
: never;
|
|
140
|
+
|
|
141
|
+
/** A table's key values. */
|
|
142
|
+
export type KeyLookup<TModel> =
|
|
143
|
+
TModel extends TableDefinition<infer _F>
|
|
144
|
+
? {
|
|
145
|
+
readonly [K in TModel["key"][number]]: KeyValueOf<
|
|
146
|
+
TModel,
|
|
147
|
+
K & keyof Values<TModel>
|
|
148
|
+
>;
|
|
149
|
+
}
|
|
150
|
+
: never;
|
|
151
|
+
|
|
152
|
+
/** The key, or the eq fields of a unique index. */
|
|
153
|
+
export type Lookup<TModel> = KeyLookup<TModel> | UniqueLookups<TModel>;
|
|
154
|
+
|
|
155
|
+
type RootedIndexName<TModel> = {
|
|
156
|
+
[I in keyof IndexesOf<TModel>]: IndexesOf<TModel>[I] extends {
|
|
157
|
+
readonly root: object;
|
|
158
|
+
}
|
|
159
|
+
? I
|
|
160
|
+
: never;
|
|
161
|
+
}[keyof IndexesOf<TModel>] &
|
|
162
|
+
string;
|
|
163
|
+
|
|
164
|
+
type OptionalFields<TFields> = {
|
|
165
|
+
[K in keyof TFields]: TFields[K] extends { readonly required: false }
|
|
166
|
+
? K
|
|
167
|
+
: never;
|
|
168
|
+
}[keyof TFields];
|
|
169
|
+
|
|
170
|
+
/** Declared fields, optional ones omittable; derived fields and engine columns are computed. */
|
|
171
|
+
export type CreateRow<TModel> =
|
|
172
|
+
TModel extends TableDefinition<infer TFields>
|
|
173
|
+
? Omit<RowOf<TFields>, OptionalFields<TFields>> &
|
|
174
|
+
Partial<Pick<RowOf<TFields>, OptionalFields<TFields>>>
|
|
175
|
+
: never;
|
|
176
|
+
|
|
177
|
+
/** Changed non-key fields. */
|
|
178
|
+
export type UpdateSet<TModel> =
|
|
179
|
+
TModel extends TableDefinition<infer TFields, infer _D, infer _I, infer TKey>
|
|
180
|
+
? Partial<Omit<RowOf<TFields>, TKey[number]>>
|
|
181
|
+
: never;
|
|
182
|
+
|
|
183
|
+
export type AggregateIdentity<TModel> =
|
|
184
|
+
TModel extends AggregateDefinition<infer TFields> ? RowOf<TFields> : never;
|
|
185
|
+
|
|
186
|
+
/** Counter and gauge deltas, and sketches to merge. */
|
|
187
|
+
export type AggregateChanges<TModel> =
|
|
188
|
+
TModel extends AggregateDefinition<
|
|
189
|
+
infer _F,
|
|
190
|
+
infer TMetric,
|
|
191
|
+
infer _I,
|
|
192
|
+
infer TSketch
|
|
193
|
+
>
|
|
194
|
+
? { readonly [K in TMetric]?: number } & {
|
|
195
|
+
readonly [K in TSketch]?: string;
|
|
196
|
+
}
|
|
197
|
+
: never;
|
|
198
|
+
|
|
199
|
+
/** Reads are recorded and guarded at commit; writes apply only if every guard holds. */
|
|
200
|
+
export interface HotUpdaterTransaction<S extends ModuleSchema> {
|
|
201
|
+
findOne<M extends TableNames<S>>(
|
|
202
|
+
model: M,
|
|
203
|
+
lookup: Lookup<S[M]>,
|
|
204
|
+
): Promise<TableRow<S[M]> | null>;
|
|
205
|
+
/** Rooted indexes only: the parent row guards the whole range. */
|
|
206
|
+
findMany<M extends TableNames<S>, I extends RootedIndexName<S[M]>>(
|
|
207
|
+
model: M,
|
|
208
|
+
options: ReadOptions<S[M], I>,
|
|
209
|
+
): Promise<Page<TableRow<S[M]>>>;
|
|
210
|
+
create<M extends TableNames<S>>(model: M, row: CreateRow<S[M]>): void;
|
|
211
|
+
/** Patches a row this transaction read, by key or through a rooted range. */
|
|
212
|
+
update<M extends TableNames<S>>(
|
|
213
|
+
model: M,
|
|
214
|
+
row: TableRow<S[M]>,
|
|
215
|
+
set: UpdateSet<S[M]>,
|
|
216
|
+
): void;
|
|
217
|
+
/** Deletes a row this transaction read, cascading to its children first. */
|
|
218
|
+
delete<M extends TableNames<S>>(model: M, row: TableRow<S[M]>): Promise<void>;
|
|
219
|
+
/**
|
|
220
|
+
* Changes one shard row of an aggregate. Gauges of a sharded aggregate need
|
|
221
|
+
* `shardBy`, so every change keyed by one value lands on one shard.
|
|
222
|
+
*/
|
|
223
|
+
aggregate<M extends AggregateNames<S>>(
|
|
224
|
+
model: M,
|
|
225
|
+
identity: AggregateIdentity<S[M]>,
|
|
226
|
+
changes: AggregateChanges<S[M]>,
|
|
227
|
+
options?: { readonly shardBy?: string },
|
|
228
|
+
): void;
|
|
229
|
+
}
|
|
230
|
+
|
|
231
|
+
/** A table name, or the reason an aggregate cannot be read this way. */
|
|
232
|
+
export type FindManyModel<S extends ModuleSchema, M> =
|
|
233
|
+
M extends TableNames<S>
|
|
234
|
+
? M
|
|
235
|
+
: "findMany reads tables; read aggregates with findAggregates";
|
|
236
|
+
|
|
237
|
+
/** An aggregate name, or the reason a table cannot be read this way. */
|
|
238
|
+
export type FindAggregatesModel<S extends ModuleSchema, M> =
|
|
239
|
+
M extends AggregateNames<S>
|
|
240
|
+
? M
|
|
241
|
+
: "findAggregates reads aggregates; read tables with findMany";
|
|
242
|
+
|
|
243
|
+
/** A module's database handle. There is no count, offset, or free-form filter. */
|
|
244
|
+
export interface HotUpdaterDatabase<S extends ModuleSchema> {
|
|
245
|
+
findOne<M extends TableNames<S>>(
|
|
246
|
+
model: M,
|
|
247
|
+
lookup: Lookup<S[M]>,
|
|
248
|
+
): Promise<ReadRow<S[M]> | null>;
|
|
249
|
+
/** Rows by key in one batch read, in the keys' order. */
|
|
250
|
+
findByKeys<M extends TableNames<S>>(
|
|
251
|
+
model: M,
|
|
252
|
+
keys: readonly KeyLookup<S[M]>[],
|
|
253
|
+
): Promise<(ReadRow<S[M]> | null)[]>;
|
|
254
|
+
findMany<M extends keyof S & string, I extends IndexName<S[M]>>(
|
|
255
|
+
model: FindManyModel<S, M>,
|
|
256
|
+
options: ReadOptions<S[M], I>,
|
|
257
|
+
): Promise<Page<ReadRow<S[M]>>>;
|
|
258
|
+
findAggregates<M extends keyof S & string, I extends IndexName<S[M]>>(
|
|
259
|
+
model: FindAggregatesModel<S, M>,
|
|
260
|
+
options: ReadOptions<S[M], I>,
|
|
261
|
+
): Promise<Page<AggregateRow<S[M]>>>;
|
|
262
|
+
/** Reruns `fn` when a guarded read changed, within a jittered retry budget. */
|
|
263
|
+
transaction<R>(fn: (tx: HotUpdaterTransaction<S>) => Promise<R>): Promise<R>;
|
|
264
|
+
}
|
|
265
|
+
|
|
266
|
+
/** The engine plus `database(module)`, which hands a module its typed handle. */
|
|
267
|
+
export const createDatabaseEngine = (options: DatabaseEngineOptions) => {
|
|
268
|
+
const engine = createEngine(options);
|
|
269
|
+
const { reads } = engine;
|
|
270
|
+
const outside =
|
|
271
|
+
<A extends unknown[], T>(read: (...args: A) => T) =>
|
|
272
|
+
(...args: A): T => {
|
|
273
|
+
assertOutsideTransaction();
|
|
274
|
+
return read(...args);
|
|
275
|
+
};
|
|
276
|
+
/** No read outside a transaction returns `_v`, which a key-value index copy lacks. */
|
|
277
|
+
const bare = (row: StoredRow | null) =>
|
|
278
|
+
row &&
|
|
279
|
+
Object.fromEntries(
|
|
280
|
+
Object.entries(row).filter(
|
|
281
|
+
([column]) => column !== DATABASE_VERSION_COLUMN,
|
|
282
|
+
),
|
|
283
|
+
);
|
|
284
|
+
const barePage = async (page: Promise<Page<StoredRow>>) => {
|
|
285
|
+
const { rows, next } = await page;
|
|
286
|
+
return { rows: rows.map(bare), ...(next === undefined ? {} : { next }) };
|
|
287
|
+
};
|
|
288
|
+
return {
|
|
289
|
+
...engine,
|
|
290
|
+
database<S extends ModuleSchema>(
|
|
291
|
+
module: SchemaModule & { readonly schema: S },
|
|
292
|
+
): HotUpdaterDatabase<S> {
|
|
293
|
+
const name = (model: string) =>
|
|
294
|
+
module.namespace ? `${module.namespace}_${model}` : model;
|
|
295
|
+
return {
|
|
296
|
+
findOne: outside(
|
|
297
|
+
async (model, lookup) =>
|
|
298
|
+
bare(await reads.findOne(name(model), lookup as never)) as never,
|
|
299
|
+
),
|
|
300
|
+
findByKeys: outside(
|
|
301
|
+
async (model, keys) =>
|
|
302
|
+
(await reads.findByKeys(name(model), keys as never)).map(
|
|
303
|
+
bare,
|
|
304
|
+
) as never,
|
|
305
|
+
),
|
|
306
|
+
findMany: outside(
|
|
307
|
+
(model, input) =>
|
|
308
|
+
barePage(reads.findMany(name(model), input as ReadInput)) as never,
|
|
309
|
+
),
|
|
310
|
+
findAggregates: outside(
|
|
311
|
+
(model, input) =>
|
|
312
|
+
barePage(
|
|
313
|
+
reads.findAggregates(name(model), input as ReadInput),
|
|
314
|
+
) as never,
|
|
315
|
+
),
|
|
316
|
+
transaction: (fn) =>
|
|
317
|
+
engine.transaction((tx: TransactionEngine) =>
|
|
318
|
+
fn({
|
|
319
|
+
findOne: (model, lookup) =>
|
|
320
|
+
tx.findOne(name(model), lookup as never) as never,
|
|
321
|
+
findMany: (model, input) =>
|
|
322
|
+
tx.findMany(name(model), input as ReadInput) as never,
|
|
323
|
+
create: (model, row) => tx.create(name(model), row),
|
|
324
|
+
update: (model, row, set) => tx.update(name(model), row, set),
|
|
325
|
+
delete: (model, row) => tx.delete(name(model), row),
|
|
326
|
+
aggregate: (model, identity, changes, options) =>
|
|
327
|
+
tx.aggregate(name(model), identity, changes, options),
|
|
328
|
+
}),
|
|
329
|
+
),
|
|
330
|
+
};
|
|
331
|
+
},
|
|
332
|
+
};
|
|
333
|
+
};
|
|
334
|
+
|
|
335
|
+
export type DatabaseEngine = ReturnType<typeof createDatabaseEngine>;
|
|
@@ -0,0 +1,135 @@
|
|
|
1
|
+
import { describe, expectTypeOf, it } from "vitest";
|
|
2
|
+
|
|
3
|
+
import type {
|
|
4
|
+
FindAggregatesModel,
|
|
5
|
+
FindManyModel,
|
|
6
|
+
HotUpdaterDatabase,
|
|
7
|
+
Lookup,
|
|
8
|
+
} from "./database";
|
|
9
|
+
import { defineAggregate, defineTable } from "./schema";
|
|
10
|
+
|
|
11
|
+
const schema = {
|
|
12
|
+
bundles: defineTable(
|
|
13
|
+
{
|
|
14
|
+
id: { type: "string" },
|
|
15
|
+
platform: { type: "string" },
|
|
16
|
+
tag: { type: "string", required: false },
|
|
17
|
+
hash: { type: "string", unique: true },
|
|
18
|
+
},
|
|
19
|
+
{
|
|
20
|
+
key: ["id"],
|
|
21
|
+
indexes: {
|
|
22
|
+
byPlatform: { eq: ["platform"], sort: ["id"] },
|
|
23
|
+
byTag: { eq: ["tag"], sort: ["id"] },
|
|
24
|
+
},
|
|
25
|
+
},
|
|
26
|
+
),
|
|
27
|
+
totals: defineAggregate(
|
|
28
|
+
{ scope: { type: "string" } },
|
|
29
|
+
{
|
|
30
|
+
key: ["scope"],
|
|
31
|
+
counters: ["hits"],
|
|
32
|
+
indexes: { all: { eq: [], sort: ["scope"] } },
|
|
33
|
+
},
|
|
34
|
+
),
|
|
35
|
+
} as const;
|
|
36
|
+
|
|
37
|
+
type Schema = typeof schema;
|
|
38
|
+
|
|
39
|
+
/** The callback is type-checked and never runs. */
|
|
40
|
+
const typeOnly = (check: (db: HotUpdaterDatabase<Schema>) => void) =>
|
|
41
|
+
void check;
|
|
42
|
+
|
|
43
|
+
describe("database API types", () => {
|
|
44
|
+
it("names the right read in its error text", () => {
|
|
45
|
+
expectTypeOf<
|
|
46
|
+
FindManyModel<Schema, "totals">
|
|
47
|
+
>().toEqualTypeOf<"findMany reads tables; read aggregates with findAggregates">();
|
|
48
|
+
expectTypeOf<
|
|
49
|
+
FindAggregatesModel<Schema, "bundles">
|
|
50
|
+
>().toEqualTypeOf<"findAggregates reads aggregates; read tables with findMany">();
|
|
51
|
+
typeOnly((db) => {
|
|
52
|
+
// @ts-expect-error Aggregates are read with findAggregates.
|
|
53
|
+
void db.findMany("totals", { index: "all", where: {}, limit: 1 });
|
|
54
|
+
void db.findAggregates(
|
|
55
|
+
// @ts-expect-error Tables are read with findMany.
|
|
56
|
+
"bundles",
|
|
57
|
+
{ index: "byPlatform", where: { platform: "ios" }, limit: 1 },
|
|
58
|
+
);
|
|
59
|
+
});
|
|
60
|
+
});
|
|
61
|
+
|
|
62
|
+
it("has no count, offset, or free-form filter", () => {
|
|
63
|
+
expectTypeOf<keyof HotUpdaterDatabase<Schema>>().toEqualTypeOf<
|
|
64
|
+
"findOne" | "findByKeys" | "findMany" | "findAggregates" | "transaction"
|
|
65
|
+
>();
|
|
66
|
+
typeOnly((db) => {
|
|
67
|
+
// @ts-expect-error There is no count.
|
|
68
|
+
void db.count;
|
|
69
|
+
void db.findMany("bundles", {
|
|
70
|
+
index: "byPlatform",
|
|
71
|
+
where: { platform: "ios" },
|
|
72
|
+
limit: 1,
|
|
73
|
+
// @ts-expect-error There is no offset.
|
|
74
|
+
offset: 5,
|
|
75
|
+
});
|
|
76
|
+
});
|
|
77
|
+
});
|
|
78
|
+
|
|
79
|
+
it("reads only declared indexes with every eq field bound to a value", () => {
|
|
80
|
+
typeOnly((db) => {
|
|
81
|
+
void db.findMany("bundles", {
|
|
82
|
+
// @ts-expect-error byHash is not a declared index.
|
|
83
|
+
index: "byHash",
|
|
84
|
+
where: { platform: "ios", tag: "beta" },
|
|
85
|
+
limit: 1,
|
|
86
|
+
});
|
|
87
|
+
void db.findMany("bundles", {
|
|
88
|
+
index: "byPlatform",
|
|
89
|
+
// @ts-expect-error byPlatform needs its platform field.
|
|
90
|
+
where: {},
|
|
91
|
+
limit: 1,
|
|
92
|
+
});
|
|
93
|
+
void db.findMany("bundles", {
|
|
94
|
+
index: "byTag",
|
|
95
|
+
// @ts-expect-error A sparse index never matches null.
|
|
96
|
+
where: { tag: null },
|
|
97
|
+
limit: 1,
|
|
98
|
+
});
|
|
99
|
+
void db.findMany("bundles", {
|
|
100
|
+
index: "byTag",
|
|
101
|
+
where: { tag: "beta" },
|
|
102
|
+
limit: 1,
|
|
103
|
+
});
|
|
104
|
+
});
|
|
105
|
+
});
|
|
106
|
+
|
|
107
|
+
it("creates full rows and updates only non-key fields in a transaction", () => {
|
|
108
|
+
typeOnly((db) => {
|
|
109
|
+
void db.transaction(async (tx) => {
|
|
110
|
+
tx.create("bundles", { id: "b", platform: "ios", hash: "h" });
|
|
111
|
+
// @ts-expect-error hash is required.
|
|
112
|
+
tx.create("bundles", { id: "b", platform: "ios" });
|
|
113
|
+
const row = await tx.findOne("bundles", { id: "b" });
|
|
114
|
+
if (row === null) return;
|
|
115
|
+
tx.update("bundles", row, { tag: null });
|
|
116
|
+
// @ts-expect-error Key fields cannot change.
|
|
117
|
+
tx.update("bundles", row, { id: "c" });
|
|
118
|
+
// @ts-expect-error Aggregates are not written through create.
|
|
119
|
+
tx.create("totals", { scope: "s" });
|
|
120
|
+
});
|
|
121
|
+
});
|
|
122
|
+
});
|
|
123
|
+
|
|
124
|
+
it("finds one row only by its key or a unique field", () => {
|
|
125
|
+
expectTypeOf<Lookup<Schema["bundles"]>>().toEqualTypeOf<
|
|
126
|
+
{ readonly id: string } | { readonly hash: string }
|
|
127
|
+
>();
|
|
128
|
+
typeOnly((db) => {
|
|
129
|
+
// @ts-expect-error platform is neither the key nor unique.
|
|
130
|
+
void db.findOne("bundles", { platform: "ios" });
|
|
131
|
+
// @ts-expect-error findOne reads tables.
|
|
132
|
+
void db.findOne("totals", { scope: "s" });
|
|
133
|
+
});
|
|
134
|
+
});
|
|
135
|
+
});
|
|
@@ -0,0 +1,72 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* The model declarations the engine reads. `defineTable` and
|
|
3
|
+
* `defineAggregate` (./schema) build them with typed rows.
|
|
4
|
+
*/
|
|
5
|
+
export type FieldType = "string" | "integer" | "number" | "boolean" | "json";
|
|
6
|
+
|
|
7
|
+
export type ReferenceAction = "restrict" | "cascade" | "none";
|
|
8
|
+
|
|
9
|
+
export interface FieldReference {
|
|
10
|
+
readonly model: string;
|
|
11
|
+
readonly onDelete: ReferenceAction;
|
|
12
|
+
}
|
|
13
|
+
|
|
14
|
+
export interface FieldDefinition<TType extends FieldType = FieldType> {
|
|
15
|
+
readonly type: TType;
|
|
16
|
+
/** Defaults to true; an optional field stores null. */
|
|
17
|
+
readonly required?: boolean;
|
|
18
|
+
/** Adds a unique index named after the field. */
|
|
19
|
+
readonly unique?: true;
|
|
20
|
+
/** Strings: the maximum length; unbounded text when absent. */
|
|
21
|
+
readonly maxLength?: number;
|
|
22
|
+
/** Strings: ASCII only, so a long key fits MySQL's 3,072-byte index limit. */
|
|
23
|
+
readonly ascii?: true;
|
|
24
|
+
readonly references?: FieldReference;
|
|
25
|
+
}
|
|
26
|
+
|
|
27
|
+
export interface IndexDefinition<TField extends string = string> {
|
|
28
|
+
readonly eq: readonly TField[];
|
|
29
|
+
readonly sort: readonly TField[];
|
|
30
|
+
/** The eq values identify at most one row. */
|
|
31
|
+
readonly unique?: true;
|
|
32
|
+
/** `eq` starts with the key of a `model` row, which every child write bumps. */
|
|
33
|
+
readonly root?: { readonly model: string };
|
|
34
|
+
}
|
|
35
|
+
|
|
36
|
+
/** A field computed on every write and stored as a real column. */
|
|
37
|
+
export interface DerivedShape {
|
|
38
|
+
readonly type: FieldType;
|
|
39
|
+
/** Up to 16 values; the row is indexed once per value. */
|
|
40
|
+
readonly multi?: true;
|
|
41
|
+
/** Null, or an empty list, leaves the row out of indexes on this field. */
|
|
42
|
+
compute(row: never): unknown;
|
|
43
|
+
}
|
|
44
|
+
|
|
45
|
+
export interface TableShape {
|
|
46
|
+
readonly kind: "table";
|
|
47
|
+
readonly fields: Readonly<Record<string, FieldDefinition>>;
|
|
48
|
+
readonly key: readonly string[];
|
|
49
|
+
readonly derived: Readonly<Record<string, DerivedShape>>;
|
|
50
|
+
readonly indexes: Readonly<Record<string, IndexDefinition>>;
|
|
51
|
+
}
|
|
52
|
+
|
|
53
|
+
export interface AggregateShape {
|
|
54
|
+
readonly kind: "aggregate";
|
|
55
|
+
/** Identity fields; `key` lists them in declaration order. */
|
|
56
|
+
readonly fields: Readonly<Record<string, FieldDefinition>>;
|
|
57
|
+
readonly key: readonly string[];
|
|
58
|
+
/** Blind increments. */
|
|
59
|
+
readonly counters: readonly string[];
|
|
60
|
+
/** Read, merged, and written back per shard; a row at zero is deleted. */
|
|
61
|
+
readonly gauges: readonly string[];
|
|
62
|
+
/** HLL sketches, kept in aggregates of their own. */
|
|
63
|
+
readonly distinct: readonly string[];
|
|
64
|
+
/** Fixed once data exists. */
|
|
65
|
+
readonly shards: number;
|
|
66
|
+
readonly indexes: Readonly<Record<string, IndexDefinition>>;
|
|
67
|
+
}
|
|
68
|
+
|
|
69
|
+
export type ModelShape = TableShape | AggregateShape;
|
|
70
|
+
|
|
71
|
+
/** A module's models by name: core, or one plugin. */
|
|
72
|
+
export type SchemaShape = Readonly<Record<string, ModelShape>>;
|
|
@@ -0,0 +1,62 @@
|
|
|
1
|
+
import {
|
|
2
|
+
type DatabaseAdapter,
|
|
3
|
+
type DatabaseReadCount,
|
|
4
|
+
verifyAdapter,
|
|
5
|
+
} from "@hot-updater/plugin-core/internal";
|
|
6
|
+
|
|
7
|
+
import { createEngineReads, type EngineReadCount } from "./engineReads";
|
|
8
|
+
import { createTransactions, type RetryOptions } from "./engineTransaction";
|
|
9
|
+
import type { ResolvedSchema } from "./resolveSchema";
|
|
10
|
+
|
|
11
|
+
export interface DatabaseEngineOptions {
|
|
12
|
+
readonly adapter: DatabaseAdapter;
|
|
13
|
+
readonly schema: ResolvedSchema;
|
|
14
|
+
readonly maxPageSize?: number;
|
|
15
|
+
/** Checks every adapter call against the contract and meters adapter reads. */
|
|
16
|
+
readonly verify?: boolean;
|
|
17
|
+
readonly retry?: RetryOptions;
|
|
18
|
+
}
|
|
19
|
+
|
|
20
|
+
export interface ReadMeasurement<T> {
|
|
21
|
+
readonly result: T;
|
|
22
|
+
/** Point reads and rows the adapter returned. */
|
|
23
|
+
readonly adapter: DatabaseReadCount;
|
|
24
|
+
/** Calls and rows (logical rows for aggregates) returned to callers. */
|
|
25
|
+
readonly engine: EngineReadCount;
|
|
26
|
+
}
|
|
27
|
+
|
|
28
|
+
/** Storage semantics over one adapter, addressed by physical table name. */
|
|
29
|
+
export const createEngine = ({
|
|
30
|
+
adapter: given,
|
|
31
|
+
schema,
|
|
32
|
+
maxPageSize,
|
|
33
|
+
verify,
|
|
34
|
+
retry,
|
|
35
|
+
}: DatabaseEngineOptions) => {
|
|
36
|
+
const verified = verify ? verifyAdapter(given) : undefined;
|
|
37
|
+
const adapter = verified ?? given;
|
|
38
|
+
const reads = createEngineReads({ adapter, schema, maxPageSize });
|
|
39
|
+
const { transaction } = createTransactions({ adapter, schema, reads, retry });
|
|
40
|
+
return {
|
|
41
|
+
reads,
|
|
42
|
+
transaction,
|
|
43
|
+
/** Runs `read` and reports what it read at both boundaries (verify mode only). */
|
|
44
|
+
async measureReads<T>(read: () => Promise<T>): Promise<ReadMeasurement<T>> {
|
|
45
|
+
if (verified === undefined) {
|
|
46
|
+
throw new Error(
|
|
47
|
+
"measureReads needs an engine created with verify: true.",
|
|
48
|
+
);
|
|
49
|
+
}
|
|
50
|
+
verified.reads.reset();
|
|
51
|
+
reads.reads.reset();
|
|
52
|
+
const result = await read();
|
|
53
|
+
return {
|
|
54
|
+
result,
|
|
55
|
+
adapter: verified.reads.total(),
|
|
56
|
+
engine: reads.reads.total(),
|
|
57
|
+
};
|
|
58
|
+
},
|
|
59
|
+
};
|
|
60
|
+
};
|
|
61
|
+
|
|
62
|
+
export type Engine = ReturnType<typeof createEngine>;
|