@mistriwork/engine 0.0.0 → 1.0.0-rc.11
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/LICENSE +21 -0
- package/README.md +16 -1
- package/dist/adapters/adapter.d.ts +726 -0
- package/dist/adapters/adapter.js +444 -0
- package/dist/adapters/cache/cacheStore.d.ts +75 -0
- package/dist/adapters/cache/cacheStore.js +160 -0
- package/dist/adapters/cache/resp.d.ts +52 -0
- package/dist/adapters/cache/resp.js +237 -0
- package/dist/adapters/commands/canonicalJson.d.ts +19 -0
- package/dist/adapters/commands/canonicalJson.js +154 -0
- package/dist/adapters/connect.d.ts +29 -0
- package/dist/adapters/connect.js +40 -0
- package/dist/adapters/connectionBudget.d.ts +101 -0
- package/dist/adapters/connectionBudget.js +128 -0
- package/dist/adapters/dbLatency.d.ts +35 -0
- package/dist/adapters/dbLatency.js +79 -0
- package/dist/adapters/epochCache.d.ts +50 -0
- package/dist/adapters/epochCache.js +85 -0
- package/dist/adapters/http/egress.d.ts +48 -0
- package/dist/adapters/http/egress.js +175 -0
- package/dist/adapters/http/httpAdapter.d.ts +71 -0
- package/dist/adapters/http/httpAdapter.js +512 -0
- package/dist/adapters/http/httpDescription.d.ts +32 -0
- package/dist/adapters/http/httpDescription.js +246 -0
- package/dist/adapters/http/openapi.d.ts +98 -0
- package/dist/adapters/http/openapi.js +487 -0
- package/dist/adapters/layoutRefusal.d.ts +24 -0
- package/dist/adapters/layoutRefusal.js +35 -0
- package/dist/adapters/net/networkPolicy.d.ts +44 -0
- package/dist/adapters/net/networkPolicy.js +123 -0
- package/dist/adapters/net/untrustedDatabase.d.ts +18 -0
- package/dist/adapters/net/untrustedDatabase.js +120 -0
- package/dist/adapters/poolAdmission.d.ts +43 -0
- package/dist/adapters/poolAdmission.js +184 -0
- package/dist/adapters/poolMetrics.d.ts +121 -0
- package/dist/adapters/poolMetrics.js +185 -0
- package/dist/adapters/postgres.d.ts +441 -0
- package/dist/adapters/postgres.js +1841 -0
- package/dist/adapters/postgresCatalog.d.ts +107 -0
- package/dist/adapters/postgresCatalog.js +421 -0
- package/dist/adapters/postgresCatalogDigest.d.ts +30 -0
- package/dist/adapters/postgresCatalogDigest.js +93 -0
- package/dist/adapters/postgresCatalogRows.d.ts +64 -0
- package/dist/adapters/postgresCatalogRows.js +37 -0
- package/dist/adapters/postgresDates.d.ts +1 -0
- package/dist/adapters/postgresDates.js +39 -0
- package/dist/adapters/postgresMaintenance.d.ts +33 -0
- package/dist/adapters/postgresMaintenance.js +179 -0
- package/dist/adapters/postgresPool.d.ts +255 -0
- package/dist/adapters/postgresPool.js +838 -0
- package/dist/adapters/postgresPooler.d.ts +28 -0
- package/dist/adapters/postgresPooler.js +267 -0
- package/dist/adapters/postgresReadCatalog.d.ts +31 -0
- package/dist/adapters/postgresReadCatalog.js +226 -0
- package/dist/adapters/postgresReadSnapshot.d.ts +46 -0
- package/dist/adapters/postgresReadSnapshot.js +133 -0
- package/dist/adapters/postgresSchemaEpoch.d.ts +24 -0
- package/dist/adapters/postgresSchemaEpoch.js +149 -0
- package/dist/adapters/postgresTransactionHandle.d.ts +173 -0
- package/dist/adapters/postgresTransactionHandle.js +524 -0
- package/dist/adapters/postgresValues.d.ts +30 -0
- package/dist/adapters/postgresValues.js +75 -0
- package/dist/adapters/postgresWriteAhead.d.ts +47 -0
- package/dist/adapters/postgresWriteAhead.js +209 -0
- package/dist/adapters/replicas.d.ts +70 -0
- package/dist/adapters/replicas.js +208 -0
- package/dist/adapters/reservedSql.d.ts +38 -0
- package/dist/adapters/reservedSql.js +264 -0
- package/dist/adapters/rolePrivileges.d.ts +17 -0
- package/dist/adapters/rolePrivileges.js +22 -0
- package/dist/adapters/scoped/keyRows.d.ts +65 -0
- package/dist/adapters/scoped/keyRows.js +179 -0
- package/dist/adapters/scoped/keyTypes.d.ts +34 -0
- package/dist/adapters/scoped/keyTypes.js +66 -0
- package/dist/adapters/scoped/postgresScopeCatalog.d.ts +34 -0
- package/dist/adapters/scoped/postgresScopeCatalog.js +457 -0
- package/dist/adapters/scoped/postgresTriggers.d.ts +137 -0
- package/dist/adapters/scoped/postgresTriggers.js +1545 -0
- package/dist/adapters/scoped/scopeTriggers.d.ts +122 -0
- package/dist/adapters/scoped/scopeTriggers.js +131 -0
- package/dist/adapters/scoped/scopedCommandOperations.d.ts +5 -0
- package/dist/adapters/scoped/scopedCommandOperations.js +48 -0
- package/dist/adapters/scoped/scopedReads.d.ts +22 -0
- package/dist/adapters/scoped/scopedReads.js +192 -0
- package/dist/adapters/scoped/scopedTransaction.d.ts +159 -0
- package/dist/adapters/scoped/scopedTransaction.js +547 -0
- package/dist/adapters/scoped/sqliteScopeCatalog.d.ts +32 -0
- package/dist/adapters/scoped/sqliteScopeCatalog.js +420 -0
- package/dist/adapters/scoped/sqliteTriggerSession.d.ts +64 -0
- package/dist/adapters/scoped/sqliteTriggerSession.js +245 -0
- package/dist/adapters/scoped/sqliteTriggers.d.ts +20 -0
- package/dist/adapters/scoped/sqliteTriggers.js +822 -0
- package/dist/adapters/scoped/storedText.d.ts +45 -0
- package/dist/adapters/scoped/storedText.js +61 -0
- package/dist/adapters/scoped/triggerEffects.d.ts +98 -0
- package/dist/adapters/scoped/triggerEffects.js +189 -0
- package/dist/adapters/scoped/triggerProof.d.ts +124 -0
- package/dist/adapters/scoped/triggerProof.js +366 -0
- package/dist/adapters/scoped/updateGuard.d.ts +3 -0
- package/dist/adapters/scoped/updateGuard.js +40 -0
- package/dist/adapters/serverSettings.d.ts +45 -0
- package/dist/adapters/serverSettings.js +46 -0
- package/dist/adapters/snapshotRead.d.ts +8 -0
- package/dist/adapters/snapshotRead.js +37 -0
- package/dist/adapters/sqlite.d.ts +273 -0
- package/dist/adapters/sqlite.js +1557 -0
- package/dist/adapters/sqliteCostlyReads.d.ts +33 -0
- package/dist/adapters/sqliteCostlyReads.js +49 -0
- package/dist/adapters/sqliteDecimals.d.ts +22 -0
- package/dist/adapters/sqliteDecimals.js +51 -0
- package/dist/adapters/sqliteHandles.d.ts +43 -0
- package/dist/adapters/sqliteHandles.js +143 -0
- package/dist/adapters/sqliteStatementProcess.d.ts +29 -0
- package/dist/adapters/sqliteStatementProcess.js +131 -0
- package/dist/adapters/statementControl.d.ts +34 -0
- package/dist/adapters/statementControl.js +90 -0
- package/dist/adapters/storeHost.d.ts +133 -0
- package/dist/adapters/storeHost.js +13 -0
- package/dist/adapters/telemetry/drivers.d.ts +21 -0
- package/dist/adapters/telemetry/drivers.js +321 -0
- package/dist/adapters/telemetry/metrics.d.ts +63 -0
- package/dist/adapters/telemetry/metrics.js +122 -0
- package/dist/adapters/telemetry/otlp.d.ts +12 -0
- package/dist/adapters/telemetry/otlp.js +320 -0
- package/dist/adapters/telemetry/otlpEncode.d.ts +48 -0
- package/dist/adapters/telemetry/otlpEncode.js +366 -0
- package/dist/adapters/telemetry/otlpEnv.d.ts +1 -0
- package/dist/adapters/telemetry/otlpEnv.js +12 -0
- package/dist/adapters/telemetry/serverTiming.d.ts +83 -0
- package/dist/adapters/telemetry/serverTiming.js +503 -0
- package/dist/adapters/telemetry/start.d.ts +10 -0
- package/dist/adapters/telemetry/start.js +25 -0
- package/dist/adapters/telemetry/statement.d.ts +16 -0
- package/dist/adapters/telemetry/statement.js +134 -0
- package/dist/adapters/telemetry/trace.d.ts +127 -0
- package/dist/adapters/telemetry/trace.js +295 -0
- package/dist/adapters/writeAhead.d.ts +27 -0
- package/dist/adapters/writeAhead.js +46 -0
- package/dist/adapters/writeAttribution.d.ts +18 -0
- package/dist/adapters/writeAttribution.js +23 -0
- package/dist/adapters/writeCapture.d.ts +80 -0
- package/dist/adapters/writeCapture.js +20 -0
- package/dist/adapters/writeLanes.d.ts +94 -0
- package/dist/adapters/writeLanes.js +232 -0
- package/dist/engine.d.ts +15 -0
- package/dist/engine.js +13 -0
- package/dist/server/auth/credentials.d.ts +61 -0
- package/dist/server/auth/credentials.js +260 -0
- package/dist/server/cacheService.d.ts +50 -0
- package/dist/server/cacheService.js +110 -0
- package/dist/server/cli/args.d.ts +182 -0
- package/dist/server/cli/args.js +348 -0
- package/dist/server/cli/bin.d.ts +5 -0
- package/dist/server/cli/bin.js +66 -0
- package/dist/server/cli/browser.d.ts +15 -0
- package/dist/server/cli/browser.js +37 -0
- package/dist/server/cli/config.d.ts +50 -0
- package/dist/server/cli/config.js +206 -0
- package/dist/server/cli/startup.d.ts +36 -0
- package/dist/server/cli/startup.js +128 -0
- package/dist/server/cli/startupOptions.d.ts +63 -0
- package/dist/server/cli/startupOptions.js +143 -0
- package/dist/server/cli/subcommand.d.ts +28 -0
- package/dist/server/cli/subcommand.js +32 -0
- package/dist/server/cli/usage.d.ts +13 -0
- package/dist/server/cli/usage.js +31 -0
- package/dist/server/clientHttp.d.ts +184 -0
- package/dist/server/clientHttp.js +700 -0
- package/dist/server/clientSurface.d.ts +128 -0
- package/dist/server/clientSurface.js +182 -0
- package/dist/server/columnGrants.d.ts +106 -0
- package/dist/server/columnGrants.js +741 -0
- package/dist/server/compileCache.d.ts +1 -0
- package/dist/server/compileCache.js +30 -0
- package/dist/server/config/locations.d.ts +1 -0
- package/dist/server/config/locations.js +15 -0
- package/dist/server/config/profile.d.ts +123 -0
- package/dist/server/config/profile.js +236 -0
- package/dist/server/configPaths.d.ts +7 -0
- package/dist/server/configPaths.js +34 -0
- package/dist/server/configSections.d.ts +64 -0
- package/dist/server/configSections.js +72 -0
- package/dist/server/connectionRedaction.d.ts +30 -0
- package/dist/server/connectionRedaction.js +77 -0
- package/dist/server/connections.d.ts +358 -0
- package/dist/server/connections.js +988 -0
- package/dist/server/constraints.d.ts +82 -0
- package/dist/server/constraints.js +169 -0
- package/dist/server/demo.d.ts +9 -0
- package/dist/server/demo.js +554 -0
- package/dist/server/devclient.d.ts +108 -0
- package/dist/server/devclient.js +361 -0
- package/dist/server/evidence.d.ts +55 -0
- package/dist/server/evidence.js +323 -0
- package/dist/server/hiddenColumns.d.ts +32 -0
- package/dist/server/hiddenColumns.js +244 -0
- package/dist/server/http/baselineHeaders.d.ts +24 -0
- package/dist/server/http/baselineHeaders.js +12 -0
- package/dist/server/http/captured.d.ts +35 -0
- package/dist/server/http/captured.js +73 -0
- package/dist/server/http/clock.d.ts +1 -0
- package/dist/server/http/clock.js +14 -0
- package/dist/server/http/connectionSource.d.ts +4 -0
- package/dist/server/http/connectionSource.js +48 -0
- package/dist/server/http/context.d.ts +189 -0
- package/dist/server/http/context.js +11 -0
- package/dist/server/http/crawlerText.d.ts +15 -0
- package/dist/server/http/crawlerText.js +32 -0
- package/dist/server/http/dataRoutes.d.ts +88 -0
- package/dist/server/http/dataRoutes.js +137 -0
- package/dist/server/http/door.d.ts +57 -0
- package/dist/server/http/door.js +39 -0
- package/dist/server/http/exportRoute.d.ts +15 -0
- package/dist/server/http/exportRoute.js +320 -0
- package/dist/server/http/firstPaint.d.ts +108 -0
- package/dist/server/http/firstPaint.js +262 -0
- package/dist/server/http/httpOperationRoutes.d.ts +11 -0
- package/dist/server/http/httpOperationRoutes.js +50 -0
- package/dist/server/http/pageReads.d.ts +20 -0
- package/dist/server/http/pageReads.js +205 -0
- package/dist/server/http/pageRoutes.d.ts +39 -0
- package/dist/server/http/pageRoutes.js +291 -0
- package/dist/server/http/probes.d.ts +22 -0
- package/dist/server/http/probes.js +27 -0
- package/dist/server/http/rateLimit.d.ts +131 -0
- package/dist/server/http/rateLimit.js +351 -0
- package/dist/server/http/readRoutes.d.ts +9 -0
- package/dist/server/http/readRoutes.js +131 -0
- package/dist/server/http/readRouting.d.ts +20 -0
- package/dist/server/http/readRouting.js +80 -0
- package/dist/server/http/recordCompose.d.ts +67 -0
- package/dist/server/http/recordCompose.js +167 -0
- package/dist/server/http/recordWrites.d.ts +89 -0
- package/dist/server/http/recordWrites.js +298 -0
- package/dist/server/http/refusalReport.d.ts +38 -0
- package/dist/server/http/refusalReport.js +75 -0
- package/dist/server/http/reply.d.ts +130 -0
- package/dist/server/http/reply.js +394 -0
- package/dist/server/http/requestOrigin.d.ts +11 -0
- package/dist/server/http/requestOrigin.js +8 -0
- package/dist/server/http/router.d.ts +45 -0
- package/dist/server/http/router.js +22 -0
- package/dist/server/http/serverCore.d.ts +68 -0
- package/dist/server/http/serverCore.js +177 -0
- package/dist/server/http/traceRequest.d.ts +30 -0
- package/dist/server/http/traceRequest.js +224 -0
- package/dist/server/http/trust.d.ts +261 -0
- package/dist/server/http/trust.js +472 -0
- package/dist/server/http/writeRefusal.d.ts +33 -0
- package/dist/server/http/writeRefusal.js +24 -0
- package/dist/server/httpConnection.d.ts +49 -0
- package/dist/server/httpConnection.js +170 -0
- package/dist/server/impact.d.ts +55 -0
- package/dist/server/impact.js +47 -0
- package/dist/server/journal.d.ts +134 -0
- package/dist/server/journal.js +398 -0
- package/dist/server/keysetReadHttp.d.ts +52 -0
- package/dist/server/keysetReadHttp.js +85 -0
- package/dist/server/layouts.d.ts +49 -0
- package/dist/server/layouts.js +192 -0
- package/dist/server/migrate/cli.d.ts +102 -0
- package/dist/server/migrate/cli.js +702 -0
- package/dist/server/migrate/database.d.ts +37 -0
- package/dist/server/migrate/database.js +247 -0
- package/dist/server/migrate/desired.d.ts +76 -0
- package/dist/server/migrate/desired.js +292 -0
- package/dist/server/migrate/files.d.ts +34 -0
- package/dist/server/migrate/files.js +141 -0
- package/dist/server/migrate/flyway.d.ts +7 -0
- package/dist/server/migrate/flyway.js +69 -0
- package/dist/server/migrate/history.d.ts +70 -0
- package/dist/server/migrate/history.js +211 -0
- package/dist/server/migrate/runner.d.ts +100 -0
- package/dist/server/migrate/runner.js +413 -0
- package/dist/server/migrate/snapshot.d.ts +30 -0
- package/dist/server/migrate/snapshot.js +239 -0
- package/dist/server/migrate/target.d.ts +33 -0
- package/dist/server/migrate/target.js +82 -0
- package/dist/server/openapiDraft.d.ts +25 -0
- package/dist/server/openapiDraft.js +171 -0
- package/dist/server/operations/diagnostics.d.ts +101 -0
- package/dist/server/operations/diagnostics.js +284 -0
- package/dist/server/operations/requestMetrics.d.ts +33 -0
- package/dist/server/operations/requestMetrics.js +94 -0
- package/dist/server/packageVersion.d.ts +1 -0
- package/dist/server/packageVersion.js +11 -0
- package/dist/server/poolConfig.d.ts +34 -0
- package/dist/server/poolConfig.js +114 -0
- package/dist/server/product.d.ts +20 -0
- package/dist/server/product.js +12 -0
- package/dist/server/recordHistoryOperations.d.ts +39 -0
- package/dist/server/recordHistoryOperations.js +43 -0
- package/dist/server/recordWriteOperations.d.ts +111 -0
- package/dist/server/recordWriteOperations.js +329 -0
- package/dist/server/resourceReadHttp.d.ts +81 -0
- package/dist/server/resourceReadHttp.js +606 -0
- package/dist/server/resourceReadOperations.d.ts +147 -0
- package/dist/server/resourceReadOperations.js +452 -0
- package/dist/server/scaffoldMachine.d.ts +54 -0
- package/dist/server/scaffoldMachine.js +184 -0
- package/dist/server/seed/cli.d.ts +20 -0
- package/dist/server/seed/cli.js +164 -0
- package/dist/server/seed/lexicon.d.ts +26 -0
- package/dist/server/seed/lexicon.js +585 -0
- package/dist/server/seed/seed.d.ts +70 -0
- package/dist/server/seed/seed.js +779 -0
- package/dist/server/seed/words.d.ts +21 -0
- package/dist/server/seed/words.js +164 -0
- package/dist/server/serverRequests.d.ts +6 -0
- package/dist/server/serverRequests.js +33 -0
- package/dist/server/serverTimeouts.d.ts +33 -0
- package/dist/server/serverTimeouts.js +32 -0
- package/dist/server/shapeonly.d.ts +32 -0
- package/dist/server/shapeonly.js +115 -0
- package/dist/server/startupWarnings.d.ts +32 -0
- package/dist/server/startupWarnings.js +92 -0
- package/dist/shared/addressParams.d.ts +28 -0
- package/dist/shared/addressParams.js +47 -0
- package/dist/shared/aggregate.d.ts +49 -0
- package/dist/shared/aggregate.js +107 -0
- package/dist/shared/appCards.d.ts +123 -0
- package/dist/shared/appCards.js +385 -0
- package/dist/shared/appComponents.d.ts +177 -0
- package/dist/shared/appComponents.js +422 -0
- package/dist/shared/appDocuments.d.ts +43 -0
- package/dist/shared/appDocuments.js +131 -0
- package/dist/shared/appEmbeds.d.ts +21 -0
- package/dist/shared/appEmbeds.js +24 -0
- package/dist/shared/appIcons.d.ts +28 -0
- package/dist/shared/appIcons.js +223 -0
- package/dist/shared/appLinks.d.ts +17 -0
- package/dist/shared/appLinks.js +124 -0
- package/dist/shared/appListColumns.d.ts +3 -0
- package/dist/shared/appListColumns.js +66 -0
- package/dist/shared/appLocale.d.ts +36 -0
- package/dist/shared/appLocale.js +86 -0
- package/dist/shared/appMessages.d.ts +44 -0
- package/dist/shared/appMessages.js +78 -0
- package/dist/shared/appNoun.d.ts +21 -0
- package/dist/shared/appNoun.js +32 -0
- package/dist/shared/autoBucket.d.ts +98 -0
- package/dist/shared/autoBucket.js +305 -0
- package/dist/shared/autoValues.d.ts +25 -0
- package/dist/shared/autoValues.js +25 -0
- package/dist/shared/breakdown.d.ts +228 -0
- package/dist/shared/breakdown.js +570 -0
- package/dist/shared/breakdowntext.d.ts +41 -0
- package/dist/shared/breakdowntext.js +400 -0
- package/dist/shared/builtInThemes.d.ts +2 -0
- package/dist/shared/builtInThemes.js +771 -0
- package/dist/shared/chartSeparation.d.ts +11 -0
- package/dist/shared/chartSeparation.js +58 -0
- package/dist/shared/clauses.d.ts +22 -0
- package/dist/shared/clauses.js +97 -0
- package/dist/shared/columnCaption.d.ts +16 -0
- package/dist/shared/columnCaption.js +90 -0
- package/dist/shared/commandFieldPath.d.ts +2 -0
- package/dist/shared/commandFieldPath.js +7 -0
- package/dist/shared/commandWire.d.ts +26 -0
- package/dist/shared/commandWire.js +41 -0
- package/dist/shared/computed.d.ts +161 -0
- package/dist/shared/computed.js +378 -0
- package/dist/shared/computedParse.d.ts +13 -0
- package/dist/shared/computedParse.js +278 -0
- package/dist/shared/computedValue.d.ts +47 -0
- package/dist/shared/computedValue.js +191 -0
- package/dist/shared/connection.d.ts +30 -0
- package/dist/shared/connection.js +1 -0
- package/dist/shared/csv.d.ts +20 -0
- package/dist/shared/csv.js +63 -0
- package/dist/shared/dashLayout.d.ts +30 -0
- package/dist/shared/dashLayout.js +132 -0
- package/dist/shared/dashboardAsks.d.ts +93 -0
- package/dist/shared/dashboardAsks.js +129 -0
- package/dist/shared/dashboardTrend.d.ts +20 -0
- package/dist/shared/dashboardTrend.js +50 -0
- package/dist/shared/decimals.d.ts +37 -0
- package/dist/shared/decimals.js +148 -0
- package/dist/shared/declaredReferences.d.ts +50 -0
- package/dist/shared/declaredReferences.js +202 -0
- package/dist/shared/definedFields.d.ts +63 -0
- package/dist/shared/definedFields.js +103 -0
- package/dist/shared/definedValues.d.ts +63 -0
- package/dist/shared/definedValues.js +184 -0
- package/dist/shared/displayDefaults.d.ts +135 -0
- package/dist/shared/displayDefaults.js +543 -0
- package/dist/shared/dueDate.d.ts +6 -0
- package/dist/shared/dueDate.js +6 -0
- package/dist/shared/duration.d.ts +4 -0
- package/dist/shared/duration.js +23 -0
- package/dist/shared/fileBounds.d.ts +9 -0
- package/dist/shared/fileBounds.js +9 -0
- package/dist/shared/filter.d.ts +238 -0
- package/dist/shared/filter.js +332 -0
- package/dist/shared/firstPaint.d.ts +24 -0
- package/dist/shared/firstPaint.js +33 -0
- package/dist/shared/form.d.ts +21 -0
- package/dist/shared/form.js +25 -0
- package/dist/shared/formValues.d.ts +104 -0
- package/dist/shared/formValues.js +352 -0
- package/dist/shared/funnel.d.ts +45 -0
- package/dist/shared/funnel.js +108 -0
- package/dist/shared/httpOperations.d.ts +48 -0
- package/dist/shared/httpOperations.js +9 -0
- package/dist/shared/iconGlyphs.d.ts +4 -0
- package/dist/shared/iconGlyphs.js +151 -0
- package/dist/shared/iconWeights.d.ts +3 -0
- package/dist/shared/iconWeights.js +162 -0
- package/dist/shared/imageWidths.d.ts +32 -0
- package/dist/shared/imageWidths.js +38 -0
- package/dist/shared/keysetPage.d.ts +64 -0
- package/dist/shared/keysetPage.js +161 -0
- package/dist/shared/like.d.ts +20 -0
- package/dist/shared/like.js +29 -0
- package/dist/shared/listEmpty.d.ts +12 -0
- package/dist/shared/listEmpty.js +36 -0
- package/dist/shared/listFilters.d.ts +28 -0
- package/dist/shared/listFilters.js +84 -0
- package/dist/shared/listPresentations.d.ts +199 -0
- package/dist/shared/listPresentations.js +7 -0
- package/dist/shared/listQuestion.d.ts +52 -0
- package/dist/shared/listQuestion.js +137 -0
- package/dist/shared/lookPalettes.d.ts +62 -0
- package/dist/shared/lookPalettes.js +306 -0
- package/dist/shared/maskQuoted.d.ts +24 -0
- package/dist/shared/maskQuoted.js +48 -0
- package/dist/shared/mentionLabel.d.ts +19 -0
- package/dist/shared/mentionLabel.js +38 -0
- package/dist/shared/mentionLookup.d.ts +17 -0
- package/dist/shared/mentionLookup.js +64 -0
- package/dist/shared/menuCounts.d.ts +16 -0
- package/dist/shared/menuCounts.js +74 -0
- package/dist/shared/model.d.ts +79 -0
- package/dist/shared/model.js +153 -0
- package/dist/shared/money.d.ts +53 -0
- package/dist/shared/money.js +98 -0
- package/dist/shared/moneyEntry.d.ts +7 -0
- package/dist/shared/moneyEntry.js +27 -0
- package/dist/shared/mount.d.ts +118 -0
- package/dist/shared/mount.js +248 -0
- package/dist/shared/niceTicks.d.ts +26 -0
- package/dist/shared/niceTicks.js +50 -0
- package/dist/shared/order.d.ts +59 -0
- package/dist/shared/order.js +133 -0
- package/dist/shared/page.d.ts +135 -0
- package/dist/shared/page.js +1187 -0
- package/dist/shared/pageAnatomy.d.ts +99 -0
- package/dist/shared/pageAnatomy.js +370 -0
- package/dist/shared/pageConfig.d.ts +25 -0
- package/dist/shared/pageConfig.js +1308 -0
- package/dist/shared/pageEmptyActions.d.ts +12 -0
- package/dist/shared/pageEmptyActions.js +20 -0
- package/dist/shared/pageLayouts.d.ts +72 -0
- package/dist/shared/pageLayouts.js +205 -0
- package/dist/shared/pageModel.d.ts +785 -0
- package/dist/shared/pageModel.js +121 -0
- package/dist/shared/pagePaths.d.ts +180 -0
- package/dist/shared/pagePaths.js +869 -0
- package/dist/shared/pagePlans.d.ts +52 -0
- package/dist/shared/pagePlans.js +108 -0
- package/dist/shared/pageRoutes.d.ts +9 -0
- package/dist/shared/pageRoutes.js +9 -0
- package/dist/shared/query.d.ts +166 -0
- package/dist/shared/query.js +1302 -0
- package/dist/shared/queryDates.d.ts +12 -0
- package/dist/shared/queryDates.js +101 -0
- package/dist/shared/queryOperands.d.ts +99 -0
- package/dist/shared/queryOperands.js +131 -0
- package/dist/shared/reads.d.ts +103 -0
- package/dist/shared/reads.js +154 -0
- package/dist/shared/recordLabel.d.ts +51 -0
- package/dist/shared/recordLabel.js +123 -0
- package/dist/shared/recordReadKeys.d.ts +30 -0
- package/dist/shared/recordReadKeys.js +51 -0
- package/dist/shared/recordReads.d.ts +268 -0
- package/dist/shared/recordReads.js +368 -0
- package/dist/shared/recordview.d.ts +198 -0
- package/dist/shared/recordview.js +356 -0
- package/dist/shared/referenceModel.d.ts +58 -0
- package/dist/shared/referenceModel.js +194 -0
- package/dist/shared/refusal.d.ts +80 -0
- package/dist/shared/refusal.js +184 -0
- package/dist/shared/relatedCreate.d.ts +30 -0
- package/dist/shared/relatedCreate.js +162 -0
- package/dist/shared/resourceHttp.d.ts +464 -0
- package/dist/shared/resourceHttp.js +1 -0
- package/dist/shared/richText.d.ts +85 -0
- package/dist/shared/richText.js +305 -0
- package/dist/shared/rollups.d.ts +143 -0
- package/dist/shared/rollups.js +64 -0
- package/dist/shared/rowScope.d.ts +72 -0
- package/dist/shared/rowScope.js +376 -0
- package/dist/shared/runtimeTables.d.ts +44 -0
- package/dist/shared/runtimeTables.js +79 -0
- package/dist/shared/schema.d.ts +529 -0
- package/dist/shared/schema.js +627 -0
- package/dist/shared/schematext.d.ts +38 -0
- package/dist/shared/schematext.js +101 -0
- package/dist/shared/scopeCatalog.d.ts +29 -0
- package/dist/shared/scopeCatalog.js +472 -0
- package/dist/shared/servedApp.d.ts +686 -0
- package/dist/shared/servedApp.js +45 -0
- package/dist/shared/sessionLease.d.ts +34 -0
- package/dist/shared/sessionLease.js +3 -0
- package/dist/shared/shape.d.ts +55 -0
- package/dist/shared/shape.js +168 -0
- package/dist/shared/slug.d.ts +1 -0
- package/dist/shared/slug.js +12 -0
- package/dist/shared/sortText.d.ts +14 -0
- package/dist/shared/sortText.js +26 -0
- package/dist/shared/sqlRelation.d.ts +4 -0
- package/dist/shared/sqlRelation.js +8 -0
- package/dist/shared/sqlsaved.d.ts +44 -0
- package/dist/shared/sqlsaved.js +63 -0
- package/dist/shared/stitchedPaths.d.ts +27 -0
- package/dist/shared/stitchedPaths.js +38 -0
- package/dist/shared/structuredFilter.d.ts +22 -0
- package/dist/shared/structuredFilter.js +1 -0
- package/dist/shared/subtitlePath.d.ts +20 -0
- package/dist/shared/subtitlePath.js +24 -0
- package/dist/shared/suggest.d.ts +18 -0
- package/dist/shared/suggest.js +59 -0
- package/dist/shared/tableSizing.d.ts +4 -0
- package/dist/shared/tableSizing.js +9 -0
- package/dist/shared/tagLists.d.ts +57 -0
- package/dist/shared/tagLists.js +34 -0
- package/dist/shared/textRules.d.ts +54 -0
- package/dist/shared/textRules.js +133 -0
- package/dist/shared/theme.d.ts +94 -0
- package/dist/shared/theme.js +800 -0
- package/dist/shared/themeColor.d.ts +34 -0
- package/dist/shared/themeColor.js +109 -0
- package/dist/shared/themeFaces.d.ts +30 -0
- package/dist/shared/themeFaces.js +42 -0
- package/dist/shared/themeInk.d.ts +20 -0
- package/dist/shared/themeInk.js +52 -0
- package/dist/shared/themeLooks.d.ts +9 -0
- package/dist/shared/themeLooks.js +572 -0
- package/dist/shared/themeParts.d.ts +26 -0
- package/dist/shared/themeParts.js +71 -0
- package/dist/shared/themePartsCheck.d.ts +21 -0
- package/dist/shared/themePartsCheck.js +91 -0
- package/dist/shared/themePresets.d.ts +85 -0
- package/dist/shared/themePresets.js +139 -0
- package/dist/shared/themeRecipeWords.d.ts +156 -0
- package/dist/shared/themeRecipeWords.js +156 -0
- package/dist/shared/themeRecipes.d.ts +213 -0
- package/dist/shared/themeRecipes.js +234 -0
- package/dist/shared/themeResolve.d.ts +55 -0
- package/dist/shared/themeResolve.js +52 -0
- package/dist/shared/themeTokens.d.ts +107 -0
- package/dist/shared/themeTokens.js +116 -0
- package/dist/shared/themeType.d.ts +38 -0
- package/dist/shared/themeType.js +205 -0
- package/dist/shared/unitWord.d.ts +4 -0
- package/dist/shared/unitWord.js +37 -0
- package/dist/shared/view.d.ts +195 -0
- package/dist/shared/view.js +987 -0
- package/dist/shared/viewLabels.d.ts +47 -0
- package/dist/shared/viewLabels.js +459 -0
- package/dist/shared/viewPaths.d.ts +248 -0
- package/dist/shared/viewPaths.js +294 -0
- package/dist/shared/viewtext.d.ts +57 -0
- package/dist/shared/viewtext.js +282 -0
- package/dist/shared/vocabulary.d.ts +71 -0
- package/dist/shared/vocabulary.js +249 -0
- package/dist/shared/weekStart.d.ts +7 -0
- package/dist/shared/weekStart.js +36 -0
- package/mark.svg +1 -0
- package/package.json +266 -3
- package/schema/model.d.ts +298 -0
- package/schema/theme.d.ts +587 -0
|
@@ -0,0 +1,420 @@
|
|
|
1
|
+
import { ANSI_STYLE, Refusal } from '../adapter.js';
|
|
2
|
+
import { chooseColumnReference, deleteRuleOf, } from '../../shared/schema.js';
|
|
3
|
+
import { mapScopeCatalog } from '../../shared/scopeCatalog.js';
|
|
4
|
+
import { referenceKey } from './scopedTransaction.js';
|
|
5
|
+
import { keyTypeRefusal, sqliteAffinity, sqliteKeyType, sqliteTypeSaid } from './keyTypes.js';
|
|
6
|
+
import { readSqliteTrigger, sqliteColumnCollations, sqliteConflictClauses } from './sqliteTriggers.js';
|
|
7
|
+
/* `table_xinfo`'s hidden: 0 a plain column, 1 a virtual table's own (its module's plumbing), 2 and 3 generated
|
|
8
|
+
(virtual, stored). A generated column keeps its table in scope: it is computed from the row the policy or the
|
|
9
|
+
tenant predicate already bounds, so a scoped read reads it and a scoped write leaves it to the database (sqlite.ts
|
|
10
|
+
refuses writing one). */
|
|
11
|
+
const generated = (column) => column.hidden === 2 || column.hidden === 3;
|
|
12
|
+
// SQLite's built-in identifier matching folds ASCII, not arbitrary Unicode.
|
|
13
|
+
const folded = (name) => name.replace(/[A-Z]/g, (char) => char.toLowerCase());
|
|
14
|
+
const refuse = (cause) => {
|
|
15
|
+
throw new Refusal('SQLite scoped transactions require a complete, unambiguous catalog and enabled foreign keys.', cause === undefined ? {} : { cause });
|
|
16
|
+
};
|
|
17
|
+
// SQLite's primary result codes for an engine that could not answer, rather
|
|
18
|
+
// than a catalog that is wrong: BUSY, LOCKED, NOMEM, INTERRUPT, IOERR, FULL,
|
|
19
|
+
// CANTOPEN, PROTOCOL. Extended codes keep the primary code in the low byte.
|
|
20
|
+
const UNAVAILABLE = new Set([5, 6, 7, 9, 10, 13, 14, 15]);
|
|
21
|
+
function identities(items) {
|
|
22
|
+
const result = new Map();
|
|
23
|
+
for (const item of items) {
|
|
24
|
+
if (typeof item.name !== 'string' || !item.name || result.has(folded(item.name)))
|
|
25
|
+
return refuse();
|
|
26
|
+
result.set(folded(item.name), item);
|
|
27
|
+
}
|
|
28
|
+
return result;
|
|
29
|
+
}
|
|
30
|
+
/** Call only on the writer inside BEGIN IMMEDIATE. No cached/public catalog,
|
|
31
|
+
* estimates or data scans: the lease's physical metadata is the authority.
|
|
32
|
+
* A non-writable table remains in the graph so hidden dependents cannot vanish.
|
|
33
|
+
*/
|
|
34
|
+
export function readSqliteScopeCatalog(db, resolve) {
|
|
35
|
+
const scanned = scanSqliteScopeCatalog(db);
|
|
36
|
+
const { schema, writable } = scanned;
|
|
37
|
+
/* Keyed effects are judged against the catalog they run in (triggerEffects.ts, which the caller loads); a database
|
|
38
|
+
without them asks nothing more. Unjudged, none is accepted. */
|
|
39
|
+
const keyed = [...scanned.triggered.values()].some((triggers) => triggers.some((trigger) => trigger.effects));
|
|
40
|
+
const triggered = !keyed
|
|
41
|
+
? scanned.triggered
|
|
42
|
+
: resolve
|
|
43
|
+
? resolve({ schema, writable, triggered: scanned.triggered, foldCase: true, ...sqliteKeyFacts(db) })
|
|
44
|
+
: new Map([...scanned.triggered].map(([id, triggers]) => [
|
|
45
|
+
id,
|
|
46
|
+
triggers.map((trigger) => trigger.effects ? { ...trigger, unaccepted: 'its effects were not judged against the catalog' } : trigger),
|
|
47
|
+
]));
|
|
48
|
+
const unkeyed = sqliteUnkeyed(schema);
|
|
49
|
+
return {
|
|
50
|
+
schema,
|
|
51
|
+
writable,
|
|
52
|
+
...(triggered.size ? { triggered } : {}),
|
|
53
|
+
references: sqliteReferences(schema),
|
|
54
|
+
...(unkeyed.size ? { unkeyed } : {}),
|
|
55
|
+
};
|
|
56
|
+
}
|
|
57
|
+
/** The tables whose primary key has a column of a type a scoped write does not take as a row's identity (keyTypes.ts), with why. */
|
|
58
|
+
function sqliteUnkeyed(schema) {
|
|
59
|
+
const unkeyed = new Map();
|
|
60
|
+
for (const table of schema.tables) {
|
|
61
|
+
const column = table.columns.find((candidate) => candidate.primaryKey && !sqliteKeyType(candidate.type));
|
|
62
|
+
if (column)
|
|
63
|
+
unkeyed.set(table.id, keyTypeRefusal('sqlite', table.id, column.name, sqliteTypeSaid(column.type)));
|
|
64
|
+
}
|
|
65
|
+
return unkeyed;
|
|
66
|
+
}
|
|
67
|
+
/**
|
|
68
|
+
* Whether SQLite's foreign key can find another parent than a check before the write, for a child column of affinity
|
|
69
|
+
* `child` and a parent key of `parent`, each of a type a key may be (keyTypes.ts: INTEGER or TEXT, and a typeless
|
|
70
|
+
* child). The foreign key applies the parent's affinity to what the child column stored (its own affinity applied to
|
|
71
|
+
* the value written, datatype3.html 3.0); the check applies the parent's affinity to the value written. The two part
|
|
72
|
+
* only where the child's affinity changes a value in a way the parent's does not undo:
|
|
73
|
+
*
|
|
74
|
+
* - BLOB (a typeless column) converts nothing: what it stores is what was written. Never.
|
|
75
|
+
* - The same affinity twice: applying one affinity again changes nothing. Never.
|
|
76
|
+
* - TEXT against an INTEGER key: a number stored as its text reads back as that number under the key's affinity, and
|
|
77
|
+
* a text stays the text it was. Never.
|
|
78
|
+
* - INTEGER against a TEXT key: "7.0" is stored as 7 and the key reads "7". The check, given "7.0", reads otherwise,
|
|
79
|
+
* and a number read back is the number given, so nothing after the statement tells them apart. Refused.
|
|
80
|
+
*/
|
|
81
|
+
const affinitiesPart = (child, parent) => {
|
|
82
|
+
const [c, p] = [sqliteAffinity(child), sqliteAffinity(parent)];
|
|
83
|
+
return c !== 'BLOB' && c !== p && p === 'TEXT';
|
|
84
|
+
};
|
|
85
|
+
/**
|
|
86
|
+
* How each foreign key compares a reference (ScopeCatalog.references). SQLite's applies the parent column's affinity
|
|
87
|
+
* to the value the child column stored, which that column's own affinity made of what was written; a parent check
|
|
88
|
+
* binds what was written and the parent column applies its affinity to that. The two agree unless the child's
|
|
89
|
+
* affinity changes the value first in a way the parent's does not undo (affinitiesPart): an INTEGER column stores
|
|
90
|
+
* "7.0" as 7, which a TEXT key reads as '7', where the check's '7.0' found '7.0'. A write through such a foreign key
|
|
91
|
+
* cannot be checked, and is refused, as is one where either side is of a type a key may not be (keyTypes.ts); one
|
|
92
|
+
* through a typeless reference, or a TEXT one to an INTEGER key, is checked.
|
|
93
|
+
*/
|
|
94
|
+
function sqliteReferences(schema) {
|
|
95
|
+
const typeOf = (table, name) => schema.tables.find((candidate) => candidate.id === table)?.columns.find((column) => column.name === name)?.type;
|
|
96
|
+
const references = new Map();
|
|
97
|
+
for (const fk of schema.foreignKeys) {
|
|
98
|
+
const types = fk.from.columns.map((column) => typeOf(fk.from.table, column));
|
|
99
|
+
const parents = fk.to.columns.map((column) => typeOf(fk.to.table, column));
|
|
100
|
+
/* Each side of a reference is a row's identity (keyTypes.ts): the key it points at of a type on the list, and the
|
|
101
|
+
reference too, or typeless (BLOB affinity), which stores what was written and so compares as the check does. */
|
|
102
|
+
const unkeyed = parents.findIndex((type) => type !== undefined && !sqliteKeyType(type));
|
|
103
|
+
const unkeyedChild = types.findIndex((type) => type !== undefined && !sqliteKeyType(type) && sqliteAffinity(type) !== 'BLOB');
|
|
104
|
+
const differ = types.findIndex((type, index) => type === undefined || parents[index] === undefined || affinitiesPart(type, parents[index]));
|
|
105
|
+
references.set(referenceKey(fk), unkeyed !== -1
|
|
106
|
+
? { refused: `${keyTypeRefusal('sqlite', fk.to.table, fk.to.columns[unkeyed], sqliteTypeSaid(parents[unkeyed]))}.` }
|
|
107
|
+
: unkeyedChild !== -1
|
|
108
|
+
? { refused: `${keyTypeRefusal('sqlite', fk.from.table, fk.from.columns[unkeyedChild], sqliteTypeSaid(types[unkeyedChild]))}.` }
|
|
109
|
+
: differ === -1 && types.length === parents.length
|
|
110
|
+
? { columns: types.map((type) => ({ type: type })) }
|
|
111
|
+
: {
|
|
112
|
+
refused: `"${fk.from.table}".${fk.from.columns[differ] ?? fk.from.columns.join('+')} references "${fk.to.table}".${fk.to.columns[differ] ?? fk.to.columns.join('+')}, ` +
|
|
113
|
+
"a column of another affinity that changes the value before the foreign key compares it: SQLite's foreign key compares it as no check before the write can, so a scoped write that sets it is refused.",
|
|
114
|
+
});
|
|
115
|
+
}
|
|
116
|
+
return references;
|
|
117
|
+
}
|
|
118
|
+
/**
|
|
119
|
+
* How a key equality in a trigger compares on SQLite (triggerEffects.ts): each column's affinity, which decides what
|
|
120
|
+
* a value is converted to before it is compared, and its collation, which `NEW.code = code` takes from the column on
|
|
121
|
+
* its left; and the primary key as a key only where its index compares each column under that column's own
|
|
122
|
+
* collation (`PRIMARY KEY (code COLLATE NOCASE)` on a BINARY column is unique under one and found under the other).
|
|
123
|
+
* And the conflict clause a table declares other than ABORT, which a trigger's write runs under when the statement
|
|
124
|
+
* that fired it is a delete (triggerEffects.ts). Read where effects are judged, inside the writer's BEGIN IMMEDIATE.
|
|
125
|
+
*/
|
|
126
|
+
export function sqliteKeyFacts(db) {
|
|
127
|
+
const definitions = new Map();
|
|
128
|
+
const definitionOf = (table) => {
|
|
129
|
+
if (!definitions.has(table.id)) {
|
|
130
|
+
const row = db.prepare("SELECT sql FROM main.sqlite_schema WHERE type = 'table' AND name = ?").get(table.name);
|
|
131
|
+
definitions.set(table.id, typeof row?.sql === 'string' ? row.sql : undefined);
|
|
132
|
+
}
|
|
133
|
+
return definitions.get(table.id);
|
|
134
|
+
};
|
|
135
|
+
const collations = new Map();
|
|
136
|
+
const collationsOf = (table) => {
|
|
137
|
+
if (!collations.has(table.id)) {
|
|
138
|
+
const sql = definitionOf(table);
|
|
139
|
+
collations.set(table.id, sql === undefined ? undefined : sqliteColumnCollations(sql));
|
|
140
|
+
}
|
|
141
|
+
return collations.get(table.id);
|
|
142
|
+
};
|
|
143
|
+
const conflicts = (table) => {
|
|
144
|
+
const sql = definitionOf(table);
|
|
145
|
+
const clauses = sql === undefined ? undefined : sqliteConflictClauses(sql);
|
|
146
|
+
if (!clauses)
|
|
147
|
+
return 'a conflict clause mistri cannot read';
|
|
148
|
+
// ABORT is what the statement's own OR ABORT would say; any other changes what a conflicting write does.
|
|
149
|
+
return clauses.find((clause) => clause !== 'ON CONFLICT ABORT');
|
|
150
|
+
};
|
|
151
|
+
const comparison = (table, name) => {
|
|
152
|
+
const column = table.columns.find((candidate) => folded(candidate.name) === folded(name));
|
|
153
|
+
const collation = column && collationsOf(table)?.get(folded(column.name));
|
|
154
|
+
if (!column || !collation)
|
|
155
|
+
return undefined;
|
|
156
|
+
const type = sqliteAffinity(column.type);
|
|
157
|
+
return {
|
|
158
|
+
type,
|
|
159
|
+
collation,
|
|
160
|
+
exact: true,
|
|
161
|
+
said: `${type} affinity, COLLATE ${collation}`,
|
|
162
|
+
keyable: sqliteKeyType(column.type),
|
|
163
|
+
declared: sqliteTypeSaid(column.type),
|
|
164
|
+
};
|
|
165
|
+
};
|
|
166
|
+
const keys = (table) => {
|
|
167
|
+
const primary = table.columns.filter((column) => column.primaryKey).map((column) => column.name);
|
|
168
|
+
if (!primary.length)
|
|
169
|
+
return [];
|
|
170
|
+
// A rowid alias holds integers alone, compared by no collation; it has no index of its own.
|
|
171
|
+
if (primary.length === 1 && table.columns.find((column) => column.name === primary[0])?.identity)
|
|
172
|
+
return [primary];
|
|
173
|
+
const index = db
|
|
174
|
+
.prepare(`PRAGMA main.index_list(${ANSI_STYLE.quote(table.name)})`)
|
|
175
|
+
.all()
|
|
176
|
+
.find((row) => row.origin === 'pk');
|
|
177
|
+
if (typeof index?.name !== 'string')
|
|
178
|
+
return [];
|
|
179
|
+
const indexed = db
|
|
180
|
+
.prepare(`PRAGMA main.index_xinfo(${ANSI_STYLE.quote(index.name)})`)
|
|
181
|
+
.all()
|
|
182
|
+
.filter((row) => row.key === 1);
|
|
183
|
+
const same = primary.every((name) => {
|
|
184
|
+
const at = indexed.find((row) => typeof row.name === 'string' && folded(row.name) === folded(name));
|
|
185
|
+
const own = comparison(table, name);
|
|
186
|
+
return typeof at?.coll === 'string' && own !== undefined && at.coll.toUpperCase() === own.collation;
|
|
187
|
+
});
|
|
188
|
+
return same && indexed.length === primary.length ? [primary] : [];
|
|
189
|
+
};
|
|
190
|
+
return { keys, comparison, conflicts };
|
|
191
|
+
}
|
|
192
|
+
/**
|
|
193
|
+
* For `mistri check`: the tables a scoped write cannot target for what they are rather than their triggers — a
|
|
194
|
+
* virtual table and its shadow tables, whose module writes them (scanSqliteScopeCatalog keeps them out of
|
|
195
|
+
* `writable`) — read on the reader, so check refuses an effect on one as the write does.
|
|
196
|
+
*/
|
|
197
|
+
export function sqliteBlockedTables(db) {
|
|
198
|
+
const blocked = new Map();
|
|
199
|
+
for (const table of db.prepare('PRAGMA main.table_list').all()) {
|
|
200
|
+
if (table.schema !== 'main' || typeof table.name !== 'string')
|
|
201
|
+
continue;
|
|
202
|
+
if (table.type === 'virtual' || table.type === 'shadow')
|
|
203
|
+
blocked.set(table.name, "a virtual table's module, whose writes the policy cannot bound");
|
|
204
|
+
}
|
|
205
|
+
return blocked;
|
|
206
|
+
}
|
|
207
|
+
/** Metadata-only read attestation inside the caller's owned snapshot. Exposes
|
|
208
|
+
* no writer eligibility. Keep every non-engine table and dependency, including
|
|
209
|
+
* private/unmapped objects, so an unknown business edge cannot disappear. */
|
|
210
|
+
export function readSqliteReadCatalog(db) {
|
|
211
|
+
if (!db.isTransaction)
|
|
212
|
+
return refuse();
|
|
213
|
+
const { schema, readable } = scanSqliteScopeCatalog(db);
|
|
214
|
+
const ids = new Map(schema.tables.filter((table) => !folded(table.id).startsWith('sqlite_')).map((table) => [table.id, table.id]));
|
|
215
|
+
return { schema: mapScopeCatalog(schema, ids), readable };
|
|
216
|
+
}
|
|
217
|
+
function scanSqliteScopeCatalog(db) {
|
|
218
|
+
try {
|
|
219
|
+
if (db.prepare('PRAGMA foreign_keys').get()?.foreign_keys !== 1)
|
|
220
|
+
return refuse();
|
|
221
|
+
const entries = db
|
|
222
|
+
.prepare("SELECT name, type FROM main.sqlite_schema WHERE type IN ('table', 'view') ORDER BY name")
|
|
223
|
+
.all();
|
|
224
|
+
const listed = db.prepare('PRAGMA main.table_list').all();
|
|
225
|
+
// Unknown PRAGMAs can return nothing without throwing. Never interpret
|
|
226
|
+
// unavailable table-kind metadata as proof that a table is ordinary.
|
|
227
|
+
if (!listed.some((table) => table.schema === 'main' && table.name === 'sqlite_schema' && table.type === 'table'))
|
|
228
|
+
return refuse();
|
|
229
|
+
const kinds = identities(listed.filter((table) => table.schema === 'main'));
|
|
230
|
+
/* Each table's triggers, main and TEMP, with the statement that made them: which writes fire each, and whether
|
|
231
|
+
it only validates its row, is read from that text per table below (sqliteTriggers.ts, scopeTriggers.ts). */
|
|
232
|
+
const definitions = new Map();
|
|
233
|
+
for (const namespace of ['main', 'temp']) {
|
|
234
|
+
const triggers = db
|
|
235
|
+
.prepare(`SELECT tbl_name AS name, name AS trigger, sql FROM ${namespace}.sqlite_schema WHERE type = 'trigger' ORDER BY name`)
|
|
236
|
+
.all();
|
|
237
|
+
for (const trigger of triggers) {
|
|
238
|
+
if (typeof trigger.name !== 'string' || typeof trigger.trigger !== 'string')
|
|
239
|
+
return refuse();
|
|
240
|
+
definitions.set(folded(trigger.name), [
|
|
241
|
+
...(definitions.get(folded(trigger.name)) ?? []),
|
|
242
|
+
{ name: trigger.trigger, sql: trigger.sql },
|
|
243
|
+
]);
|
|
244
|
+
}
|
|
245
|
+
}
|
|
246
|
+
const triggered = new Map();
|
|
247
|
+
const shadowed = new Set();
|
|
248
|
+
for (const table of db.prepare("SELECT name FROM temp.sqlite_schema WHERE type IN ('table', 'view')").all()) {
|
|
249
|
+
if (typeof table.name !== 'string')
|
|
250
|
+
return refuse();
|
|
251
|
+
shadowed.add(folded(table.name));
|
|
252
|
+
}
|
|
253
|
+
const tables = [];
|
|
254
|
+
const columnsByTable = new Map();
|
|
255
|
+
const writable = new Set();
|
|
256
|
+
const readable = new Set();
|
|
257
|
+
identities(entries);
|
|
258
|
+
for (const entry of entries) {
|
|
259
|
+
const kind = kinds.get(folded(entry.name));
|
|
260
|
+
if (!kind ||
|
|
261
|
+
kind.name !== entry.name ||
|
|
262
|
+
!['table', 'view', 'virtual', 'shadow'].includes(kind.type) ||
|
|
263
|
+
(entry.type === 'view') !== (kind.type === 'view'))
|
|
264
|
+
return refuse();
|
|
265
|
+
const columns = db.prepare(`PRAGMA main.table_xinfo(${ANSI_STYLE.quote(entry.name)})`).all();
|
|
266
|
+
identities(columns);
|
|
267
|
+
if (!columns.length || columns.length !== kind.ncol)
|
|
268
|
+
return refuse();
|
|
269
|
+
for (const [i, column] of columns.entries()) {
|
|
270
|
+
if (column.cid !== i ||
|
|
271
|
+
typeof column.type !== 'string' ||
|
|
272
|
+
!Number.isInteger(column.pk) ||
|
|
273
|
+
column.pk < 0 ||
|
|
274
|
+
![0, 1].includes(column.notnull) ||
|
|
275
|
+
![0, 1, 2, 3].includes(column.hidden) ||
|
|
276
|
+
(column.dflt_value !== null && typeof column.dflt_value !== 'string'))
|
|
277
|
+
return refuse();
|
|
278
|
+
}
|
|
279
|
+
const primary = columns.filter((column) => column.pk > 0).sort((a, b) => a.pk - b.pk);
|
|
280
|
+
if (primary.some((column, i) => column.pk !== i + 1))
|
|
281
|
+
return refuse();
|
|
282
|
+
const indexes = db.prepare(`PRAGMA main.index_list(${ANSI_STYLE.quote(entry.name)})`).all();
|
|
283
|
+
// INTEGER PRIMARY KEY DESC has a PK index and is not a rowid alias.
|
|
284
|
+
const identity = kind.type === 'table' &&
|
|
285
|
+
kind.wr === 0 &&
|
|
286
|
+
primary.length === 1 &&
|
|
287
|
+
/^INTEGER$/i.test(primary[0].type.trim()) &&
|
|
288
|
+
!indexes.some((index) => index.origin === 'pk')
|
|
289
|
+
? primary[0].name
|
|
290
|
+
: undefined;
|
|
291
|
+
tables.push({
|
|
292
|
+
id: entry.name,
|
|
293
|
+
name: entry.name,
|
|
294
|
+
schema: 'main',
|
|
295
|
+
isView: kind.type === 'view',
|
|
296
|
+
columns: columns.map((column) => ({
|
|
297
|
+
name: column.name,
|
|
298
|
+
type: column.type || (kind.type === 'view' ? '' : 'BLOB'),
|
|
299
|
+
primaryKey: column.pk > 0,
|
|
300
|
+
nullable: column.notnull === 0 && column.name !== identity && !(column.pk > 0 && (kind.wr === 1 || kind.strict === 1)),
|
|
301
|
+
...(column.dflt_value !== null ? { default: column.dflt_value } : {}),
|
|
302
|
+
...(column.name === identity ? { identity: 'by-default' } : {}),
|
|
303
|
+
// The database computes a generated column from its row: read like any other, never written.
|
|
304
|
+
...(generated(column) ? { writable: false } : {}),
|
|
305
|
+
})),
|
|
306
|
+
});
|
|
307
|
+
columnsByTable.set(entry.name, columns);
|
|
308
|
+
if (kind.type === 'table' &&
|
|
309
|
+
!folded(entry.name).startsWith('sqlite_') &&
|
|
310
|
+
!shadowed.has(folded(entry.name)) &&
|
|
311
|
+
columns.every((column) => column.hidden !== 1)) {
|
|
312
|
+
/* A table with triggers is written only by the writes that fire none of them but validation-only ones
|
|
313
|
+
(scopedTransaction.ts target): it stays out of `writable`, which says every write may run. */
|
|
314
|
+
const triggers = definitions.get(folded(entry.name));
|
|
315
|
+
if (!triggers)
|
|
316
|
+
writable.add(entry.name);
|
|
317
|
+
else {
|
|
318
|
+
const computed = new Set(columns.filter(generated).map((column) => folded(column.name)));
|
|
319
|
+
triggered.set(entry.name, triggers.map((trigger) => readSqliteTrigger(trigger.name, trigger.sql, computed)));
|
|
320
|
+
}
|
|
321
|
+
}
|
|
322
|
+
if (kind.type === 'table' &&
|
|
323
|
+
!folded(entry.name).startsWith('sqlite_') &&
|
|
324
|
+
!shadowed.has(folded(entry.name)) &&
|
|
325
|
+
// A generated column is read like any other; a virtual table's own columns (hidden 1) are its module's.
|
|
326
|
+
columns.every((column) => column.hidden !== 1))
|
|
327
|
+
readable.add(entry.name);
|
|
328
|
+
}
|
|
329
|
+
const byName = identities(tables);
|
|
330
|
+
const foreignKeys = [];
|
|
331
|
+
for (const table of tables) {
|
|
332
|
+
const rows = db.prepare(`PRAGMA main.foreign_key_list(${ANSI_STYLE.quote(table.name)})`).all();
|
|
333
|
+
const groups = new Map();
|
|
334
|
+
for (const row of rows) {
|
|
335
|
+
if (!Number.isInteger(row.id) ||
|
|
336
|
+
row.id < 0 ||
|
|
337
|
+
!Number.isInteger(row.seq) ||
|
|
338
|
+
row.seq < 0 ||
|
|
339
|
+
typeof row.table !== 'string' ||
|
|
340
|
+
typeof row.from !== 'string' ||
|
|
341
|
+
(row.to !== null && typeof row.to !== 'string'))
|
|
342
|
+
return refuse();
|
|
343
|
+
const group = groups.get(row.id) ?? [];
|
|
344
|
+
group.push(row);
|
|
345
|
+
groups.set(row.id, group);
|
|
346
|
+
}
|
|
347
|
+
const localColumns = identities(table.columns);
|
|
348
|
+
/* Every key a column sits in, judged together after the groups: one
|
|
349
|
+
column legitimately carries its own reference and its part in a
|
|
350
|
+
composite key (chooseColumnReference says which link a reader
|
|
351
|
+
follows, and which case is a contradiction). */
|
|
352
|
+
const candidates = new Map();
|
|
353
|
+
for (const [id, unordered] of groups) {
|
|
354
|
+
const group = unordered.sort((a, b) => a.seq - b.seq);
|
|
355
|
+
const first = group[0];
|
|
356
|
+
const parent = byName.get(folded(first.table));
|
|
357
|
+
const onDelete = deleteRuleOf(first.on_delete);
|
|
358
|
+
if (!parent ||
|
|
359
|
+
kinds.get(folded(parent.name))?.type !== 'table' ||
|
|
360
|
+
!onDelete ||
|
|
361
|
+
!deleteRuleOf(first.on_update) ||
|
|
362
|
+
group.some((row, i) => row.seq !== i ||
|
|
363
|
+
folded(row.table) !== folded(first.table) ||
|
|
364
|
+
row.on_delete !== first.on_delete ||
|
|
365
|
+
row.on_update !== first.on_update))
|
|
366
|
+
return refuse();
|
|
367
|
+
const parentColumns = identities(parent.columns);
|
|
368
|
+
const primary = columnsByTable
|
|
369
|
+
.get(parent.id)
|
|
370
|
+
.filter((column) => column.pk > 0)
|
|
371
|
+
.sort((a, b) => a.pk - b.pk);
|
|
372
|
+
const implicit = first.to === null;
|
|
373
|
+
if (group.some((row) => (row.to === null) !== implicit) || (implicit && primary.length !== group.length))
|
|
374
|
+
return refuse();
|
|
375
|
+
const from = group.map((row) => localColumns.get(folded(row.from))?.name ?? refuse());
|
|
376
|
+
const to = group.map((row, i) => (implicit ? primary[i].name : (parentColumns.get(folded(row.to))?.name ?? refuse())));
|
|
377
|
+
if (new Set(from).size !== from.length || new Set(to).size !== to.length)
|
|
378
|
+
return refuse();
|
|
379
|
+
foreignKeys.push({
|
|
380
|
+
name: `${table.name}_fk_${id}`,
|
|
381
|
+
from: { table: table.id, columns: from },
|
|
382
|
+
to: { table: parent.id, columns: to },
|
|
383
|
+
onDelete,
|
|
384
|
+
});
|
|
385
|
+
for (const [i, name] of from.entries()) {
|
|
386
|
+
const column = localColumns.get(folded(name));
|
|
387
|
+
const listed = candidates.get(column.name) ?? [];
|
|
388
|
+
listed.push({ reference: { table: parent.id, column: to[i] }, composite: group.length > 1 });
|
|
389
|
+
candidates.set(column.name, listed);
|
|
390
|
+
}
|
|
391
|
+
}
|
|
392
|
+
for (const [name, listed] of candidates) {
|
|
393
|
+
const chosen = chooseColumnReference(listed);
|
|
394
|
+
// This is the attesting path, so a contradiction refuses the catalog.
|
|
395
|
+
// The adapter's own describe keeps the same verdict and shows no link
|
|
396
|
+
// instead: see chooseColumnReference for why the two differ.
|
|
397
|
+
if (chosen.kind === 'conflict')
|
|
398
|
+
return refuse();
|
|
399
|
+
if (chosen.kind === 'one')
|
|
400
|
+
localColumns.get(folded(name)).references = chosen.reference;
|
|
401
|
+
}
|
|
402
|
+
}
|
|
403
|
+
return {
|
|
404
|
+
schema: { dialect: 'sqlite', label: 'SQLite scoped transaction', readAt: new Date().toISOString(), tables, foreignKeys },
|
|
405
|
+
writable,
|
|
406
|
+
readable,
|
|
407
|
+
triggered,
|
|
408
|
+
};
|
|
409
|
+
}
|
|
410
|
+
catch (error) {
|
|
411
|
+
if (error instanceof Refusal)
|
|
412
|
+
throw error;
|
|
413
|
+
// Missing/broken objects and unknown metadata cannot weaken the boundary.
|
|
414
|
+
// Refused either way; a busy or failing engine is kept as the cause.
|
|
415
|
+
const { code, errcode } = (error ?? {});
|
|
416
|
+
if (code === 'ERR_SQLITE_ERROR' && typeof errcode === 'number' && UNAVAILABLE.has(errcode & 0xff))
|
|
417
|
+
return refuse(error);
|
|
418
|
+
return refuse();
|
|
419
|
+
}
|
|
420
|
+
}
|
|
@@ -0,0 +1,64 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* SQLite's second look at what an accepted trigger wrote (docs/trigger-effects.md, decision 2): the proof
|
|
3
|
+
* (triggerProof.ts) reaches every row an effect names before and after its statement, and this checks that the
|
|
4
|
+
* database did no more. From the first write that fires an accepted trigger, a session records the transaction's
|
|
5
|
+
* changes; before COMMIT its changeset is read, and every change SQLite marks indirect — made by a trigger, not by
|
|
6
|
+
* the transaction's own statements — must be a row the proof reached. One that is not refuses the transaction
|
|
7
|
+
* whole, so a trigger the grammar misread cannot write past it.
|
|
8
|
+
*
|
|
9
|
+
* A change is matched by what it did as well as by its key: an insert the proof reached is no warrant for an update
|
|
10
|
+
* of a row with that key. A table's `ON CONFLICT REPLACE` turns an insert into an overwrite of the row already
|
|
11
|
+
* there, which the changeset records as an update (triggerEffects.ts refuses such a table as an effect's; this
|
|
12
|
+
* would still see it). A changeset folds the changes to one row into one: an insert then an update is an insert, an
|
|
13
|
+
* update then a delete a delete, and a delete then an insert of the same key an update.
|
|
14
|
+
*
|
|
15
|
+
* A change SQLite calls direct is not always only the transaction's own: one to a row the transaction wrote itself
|
|
16
|
+
* stays direct however many triggers write that row after (sqlite3session_indirect), so a trigger the proof never
|
|
17
|
+
* reached could rewrite such a row unseen. After each of the transaction's own statements the witness keeps what the
|
|
18
|
+
* changeset says of the row it wrote, and from then on that row's change must stay as kept unless the proof reached
|
|
19
|
+
* it since: checked after every later statement and before COMMIT. What a trigger writes to that row within the very
|
|
20
|
+
* statement that writes it folds into the statement's own change and is not told apart.
|
|
21
|
+
*
|
|
22
|
+
* A scoped delete never cascades (scopedTransaction.ts refuses one others reference), so a trigger is the only
|
|
23
|
+
* source of an indirect change here. A session sees only tables with a primary key, so an effect on one without is
|
|
24
|
+
* refused when it is proven.
|
|
25
|
+
*/
|
|
26
|
+
import type { DatabaseSync } from 'node:sqlite';
|
|
27
|
+
import type { TableMeta } from '../../shared/schema.js';
|
|
28
|
+
import type { TriggerChange } from './triggerProof.js';
|
|
29
|
+
export interface TriggerWitness {
|
|
30
|
+
/** Before a statement that fires an accepted trigger: from here on, the transaction's changes are recorded. */
|
|
31
|
+
watch(): void;
|
|
32
|
+
/** A row the proof reached. */
|
|
33
|
+
proven(change: TriggerChange): void;
|
|
34
|
+
/**
|
|
35
|
+
* After one of the transaction's own statements, the row it wrote: its table and primary key, and for an update the
|
|
36
|
+
* values it set (a key it changed is the row's key now). Every row an earlier statement wrote is still as that
|
|
37
|
+
* statement left it, or the proof reached it since, or `refuse` throws.
|
|
38
|
+
*/
|
|
39
|
+
wrote(table: string, key: Readonly<Record<string, unknown>>, values?: Readonly<Record<string, unknown>>): void;
|
|
40
|
+
/**
|
|
41
|
+
* A row's key as its table stores it, read by the key a write names (or that key, where no row has it): what a
|
|
42
|
+
* delete is told by, read before the row is gone. `wrote` reads the stored key itself after an insert or update.
|
|
43
|
+
*/
|
|
44
|
+
stored(table: string, key: Readonly<Record<string, unknown>>): Readonly<Record<string, unknown>>;
|
|
45
|
+
/** Before COMMIT: every indirect change is one the proof reached, and every row the transaction wrote is as it last
|
|
46
|
+
* left it or reached since, or `refuse` throws. Ends the session. */
|
|
47
|
+
settle(): void;
|
|
48
|
+
/** Ends the session without a look: the transaction is rolling back. */
|
|
49
|
+
close(): void;
|
|
50
|
+
}
|
|
51
|
+
type Value = string | number | null | undefined;
|
|
52
|
+
/** One change of a changeset: its table, its operation, whether a trigger made it, its primary key's values by column
|
|
53
|
+
* position, and every value it records (an update's old values then its new, undefined where a column is unchanged). */
|
|
54
|
+
interface Change {
|
|
55
|
+
readonly table: string;
|
|
56
|
+
readonly op: 'insert' | 'update' | 'delete';
|
|
57
|
+
readonly indirect: boolean;
|
|
58
|
+
readonly key: ReadonlyMap<number, Value>;
|
|
59
|
+
readonly values: readonly Value[];
|
|
60
|
+
}
|
|
61
|
+
/** The changes of a changeset (sqlite.org/sessionintro.html, "changeset format"). */
|
|
62
|
+
export declare function readChangeset(bytes: Uint8Array): Change[];
|
|
63
|
+
export declare function sqliteTriggerWitness(db: DatabaseSync, tables: readonly TableMeta[]): TriggerWitness;
|
|
64
|
+
export {};
|