@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,45 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* A stored row's reference columns as PostgreSQL's own text, read in the statement that reads the row.
|
|
3
|
+
*
|
|
4
|
+
* A scoped write checks the parent a reference points at by binding the value as text, read by the column's type
|
|
5
|
+
* (scopedTransaction.ts parentChecks). A value the person gives is bound as given. A value taken from a STORED row was
|
|
6
|
+
* the driver's JavaScript reading of it, and for some types that reading loses what the key compares by (an array's
|
|
7
|
+
* lower bounds, a jsonb number past 2^53): an update that set the other column of a composite reference was checked
|
|
8
|
+
* against the visible parent the lossy value named, and committed onto the hidden one the stored value names. Those
|
|
9
|
+
* types are no longer keys at all (keyTypes.ts); for the ones that are, the driver's reading is the text already, and
|
|
10
|
+
* the text is still what is bound: every stored value a check takes is read as `col::text` beside the row, so what
|
|
11
|
+
* PostgreSQL said is what it reads back, in the one session whose date style the transaction pins (postgres.ts).
|
|
12
|
+
*
|
|
13
|
+
* The texts ride with the row object they were read with (a WeakMap, never a column of it: the row a write's images,
|
|
14
|
+
* its trigger proof and what it announces see is the row as read), and a row made from a stored one carries those of
|
|
15
|
+
* its columns it took unchanged (`overlaid`, `withStoredText`).
|
|
16
|
+
*/
|
|
17
|
+
import type { DatabaseSchema, TableMeta } from '../../shared/schema.js';
|
|
18
|
+
type Row = Record<string, unknown>;
|
|
19
|
+
/** Each column's stored text, or null where it is NULL. */
|
|
20
|
+
type StoredTexts = Readonly<Record<string, string | null>>;
|
|
21
|
+
/**
|
|
22
|
+
* What a read of `table` also selects for its reference columns' stored text, on PostgreSQL: the columns any foreign
|
|
23
|
+
* key of the table references from, and the name the object of their texts is selected as, one no column of the table
|
|
24
|
+
* has. Undefined where there are none, or on another engine: SQLite's driver reads a stored value as it is.
|
|
25
|
+
*/
|
|
26
|
+
export declare function storedTextOf(schema: DatabaseSchema, table: TableMeta): {
|
|
27
|
+
alias: string;
|
|
28
|
+
columns: readonly string[];
|
|
29
|
+
} | undefined;
|
|
30
|
+
/**
|
|
31
|
+
* The select-list item that reads `columns` as text, as one jsonb object (a string or null each, which the driver
|
|
32
|
+
* reads exactly). Built in pieces of fifty pairs, a function's argument limit being a hundred.
|
|
33
|
+
*/
|
|
34
|
+
export declare function storedTextSelect(columns: readonly string[], quote: (name: string) => string): string;
|
|
35
|
+
/** `row` without the texts `spec` selected, those kept beside it. A row read without them is returned as it is. */
|
|
36
|
+
export declare function detachStoredText(spec: {
|
|
37
|
+
alias: string;
|
|
38
|
+
} | undefined, row: Row): Row;
|
|
39
|
+
/** The stored texts read with `row`, or carried to it from the row it was made from. */
|
|
40
|
+
export declare const storedText: (row: object | null | undefined) => StoredTexts | undefined;
|
|
41
|
+
/** `row`, carrying `texts`: each for a column `row` holds. */
|
|
42
|
+
export declare function withStoredText<T extends object>(row: T, texts: StoredTexts | undefined): T;
|
|
43
|
+
/** A stored row with `given` written over it: it keeps the texts of the columns `given` leaves as stored. */
|
|
44
|
+
export declare function overlaid(stored: Row, given: Row | undefined): Row;
|
|
45
|
+
export {};
|
|
@@ -0,0 +1,61 @@
|
|
|
1
|
+
const TEXTS = new WeakMap();
|
|
2
|
+
/**
|
|
3
|
+
* What a read of `table` also selects for its reference columns' stored text, on PostgreSQL: the columns any foreign
|
|
4
|
+
* key of the table references from, and the name the object of their texts is selected as, one no column of the table
|
|
5
|
+
* has. Undefined where there are none, or on another engine: SQLite's driver reads a stored value as it is.
|
|
6
|
+
*/
|
|
7
|
+
export function storedTextOf(schema, table) {
|
|
8
|
+
if (schema.dialect !== 'postgres')
|
|
9
|
+
return undefined;
|
|
10
|
+
const referencing = new Set(schema.foreignKeys.filter((fk) => fk.from.table === table.id).flatMap((fk) => fk.from.columns));
|
|
11
|
+
const columns = table.columns.map((column) => column.name).filter((name) => referencing.has(name));
|
|
12
|
+
if (!columns.length)
|
|
13
|
+
return undefined;
|
|
14
|
+
let alias = '?stored text';
|
|
15
|
+
while (table.columns.some((column) => column.name === alias))
|
|
16
|
+
alias = `?${alias}`;
|
|
17
|
+
return { alias, columns };
|
|
18
|
+
}
|
|
19
|
+
/**
|
|
20
|
+
* The select-list item that reads `columns` as text, as one jsonb object (a string or null each, which the driver
|
|
21
|
+
* reads exactly). Built in pieces of fifty pairs, a function's argument limit being a hundred.
|
|
22
|
+
*/
|
|
23
|
+
export function storedTextSelect(columns, quote) {
|
|
24
|
+
const pieces = [];
|
|
25
|
+
for (let at = 0; at < columns.length; at += 50)
|
|
26
|
+
pieces.push(`pg_catalog.jsonb_build_object(${columns
|
|
27
|
+
.slice(at, at + 50)
|
|
28
|
+
// An escape string, read alike whatever standard_conforming_strings says.
|
|
29
|
+
.map((name) => `E'${name.replaceAll('\\', '\\\\').replaceAll("'", "''")}'::pg_catalog.text, ${quote(name)}::pg_catalog.text`)
|
|
30
|
+
.join(', ')})`);
|
|
31
|
+
return pieces.join(' OPERATOR(pg_catalog.||) ');
|
|
32
|
+
}
|
|
33
|
+
/** `row` without the texts `spec` selected, those kept beside it. A row read without them is returned as it is. */
|
|
34
|
+
export function detachStoredText(spec, row) {
|
|
35
|
+
if (!spec || !Object.hasOwn(row, spec.alias))
|
|
36
|
+
return row;
|
|
37
|
+
const { [spec.alias]: said, ...rest } = row;
|
|
38
|
+
const texts = {};
|
|
39
|
+
if (said && typeof said === 'object' && !Array.isArray(said))
|
|
40
|
+
for (const [column, text] of Object.entries(said))
|
|
41
|
+
if (typeof text === 'string' || text === null)
|
|
42
|
+
texts[column] = text;
|
|
43
|
+
TEXTS.set(rest, texts);
|
|
44
|
+
return rest;
|
|
45
|
+
}
|
|
46
|
+
/** The stored texts read with `row`, or carried to it from the row it was made from. */
|
|
47
|
+
export const storedText = (row) => (row ? TEXTS.get(row) : undefined);
|
|
48
|
+
/** `row`, carrying `texts`: each for a column `row` holds. */
|
|
49
|
+
export function withStoredText(row, texts) {
|
|
50
|
+
if (texts)
|
|
51
|
+
TEXTS.set(row, Object.fromEntries(Object.entries(texts).filter(([column]) => Object.hasOwn(row, column))));
|
|
52
|
+
return row;
|
|
53
|
+
}
|
|
54
|
+
/** A stored row with `given` written over it: it keeps the texts of the columns `given` leaves as stored. */
|
|
55
|
+
export function overlaid(stored, given) {
|
|
56
|
+
const texts = storedText(stored);
|
|
57
|
+
const row = { ...stored, ...(given ?? {}) };
|
|
58
|
+
return texts
|
|
59
|
+
? withStoredText(row, Object.fromEntries(Object.entries(texts).filter(([column]) => !Object.hasOwn(given ?? {}, column))))
|
|
60
|
+
: row;
|
|
61
|
+
}
|
|
@@ -0,0 +1,98 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* What a trigger's keyed effects reach, judged against the catalog they run
|
|
3
|
+
* in (docs/trigger-effects.md). The grammar (sqliteTriggers.ts,
|
|
4
|
+
* postgresTriggers.ts) reads what a body says; this decides whether the
|
|
5
|
+
* platform can bound it, once per catalog read:
|
|
6
|
+
*
|
|
7
|
+
* - every table an effect names is an ordinary table of the catalog that a
|
|
8
|
+
* scoped write could itself target (not a view, a TEMP shadow, a table
|
|
9
|
+
* with rules or row security, or on PostgreSQL one in a partition or
|
|
10
|
+
* inheritance hierarchy, which no scoped write targets);
|
|
11
|
+
* - every key covers a key the catalog proves unique as the trigger compares
|
|
12
|
+
* it ({@link EffectCatalog.keys}), so it reaches one row at most, and names
|
|
13
|
+
* only columns that exist;
|
|
14
|
+
* - each of its equalities compares two columns of the same type and
|
|
15
|
+
* collation ({@link EffectCatalog.comparison}), so the row the trigger finds
|
|
16
|
+
* is the row the proof reads by the same value: a cast on one side (a
|
|
17
|
+
* `char(3)` against a `text` key drops trailing spaces), a looser collation
|
|
18
|
+
* on one side (NOCASE against BINARY) or a nondeterministic one would match
|
|
19
|
+
* rows the proof never read;
|
|
20
|
+
* - each side of each key is of a type a scoped write takes as a row's identity
|
|
21
|
+
* (keyTypes.ts): a jsonb key the driver reads as another value, or a SQLite
|
|
22
|
+
* decimal said with its scale, names a row the database does not compare;
|
|
23
|
+
* - an update sets no key column and no column another table references, and
|
|
24
|
+
* a delete removes no row of a table another table's foreign key references,
|
|
25
|
+
* as the person's own delete may not (scopedTransaction.ts remove): a cascade
|
|
26
|
+
* would reach rows nobody keyed, and a NO ACTION or RESTRICT reference would
|
|
27
|
+
* refuse the delete exactly when a row (hidden or not) still points at it;
|
|
28
|
+
* - an insert or update writes no table whose schema declares a conflict
|
|
29
|
+
* clause of its own ({@link EffectCatalog.conflicts}): under a statement that
|
|
30
|
+
* names none (a scoped delete), that clause, not the proof, decides which
|
|
31
|
+
* row the write replaces;
|
|
32
|
+
* - no effect writes the table the trigger fires on: its own row is the write
|
|
33
|
+
* the policy already bounds, and another of its rows would fire the same
|
|
34
|
+
* triggers mid-statement;
|
|
35
|
+
* - what each write fires on its table is validation-only or keyed in turn,
|
|
36
|
+
* with no cycle and a chain at most {@link MAX_TRIGGER_DEPTH} keyed triggers
|
|
37
|
+
* deep.
|
|
38
|
+
*
|
|
39
|
+
* A trigger that fails any of this keeps its effects for `mistri check` to
|
|
40
|
+
* name, with `unaccepted` saying why; naming it in an App does not unblock a
|
|
41
|
+
* write. Whether a trigger is named, and whether its keys are in a person's
|
|
42
|
+
* scope, are the transaction's to judge (triggerProof.ts).
|
|
43
|
+
*/
|
|
44
|
+
import type { DatabaseSchema, TableMeta } from '../../shared/schema.js';
|
|
45
|
+
import { type ScopeTrigger } from './scopeTriggers.js';
|
|
46
|
+
/** What the resolution needs of a scope catalog. */
|
|
47
|
+
export interface EffectCatalog {
|
|
48
|
+
readonly schema: DatabaseSchema;
|
|
49
|
+
/** Tables a scoped write may target with no trigger in the way. */
|
|
50
|
+
readonly writable: ReadonlySet<string>;
|
|
51
|
+
/** Tables whose triggers decide each write, with those triggers as the grammar read them. */
|
|
52
|
+
readonly triggered: ReadonlyMap<string, readonly ScopeTrigger[]>;
|
|
53
|
+
/** SQLite folds ASCII case in names; PostgreSQL names exactly. */
|
|
54
|
+
readonly foldCase: boolean;
|
|
55
|
+
/** PostgreSQL: the tables in a partition or inheritance hierarchy, which no scoped write targets (ScopeCatalog.hierarchy). */
|
|
56
|
+
readonly hierarchy?: ReadonlySet<string>;
|
|
57
|
+
/**
|
|
58
|
+
* SQLite: the conflict clause a table's schema declares on a constraint, other than ABORT (`ON CONFLICT REPLACE`),
|
|
59
|
+
* or why its schema could not be read for one; undefined where it declares none. A scoped insert or update says
|
|
60
|
+
* `OR ABORT`, which overrides every clause a trigger's statement meets; a scoped delete cannot (SQLite has no
|
|
61
|
+
* `DELETE OR ABORT`), so a trigger it fires writes under the table's own clause.
|
|
62
|
+
*/
|
|
63
|
+
readonly conflicts?: (table: TableMeta) => string | undefined;
|
|
64
|
+
/**
|
|
65
|
+
* Tables a scoped write cannot target for what the catalog holds beyond their triggers (row-level security, a rule,
|
|
66
|
+
* no UPDATE for the writer), with what blocks each. A write's own catalog keeps these out of `writable` and
|
|
67
|
+
* `triggered` already; `mistri check` reads them apart, so it refuses what the write refuses.
|
|
68
|
+
*/
|
|
69
|
+
readonly blocked?: ReadonlyMap<string, string>;
|
|
70
|
+
/**
|
|
71
|
+
* The column sets a table's rows are unique on under the comparison a key makes: SQLite its primary key, where its
|
|
72
|
+
* index (if any) uses each column's own collation; PostgreSQL each valid, whole-table unique index on plain columns
|
|
73
|
+
* whose every column uses its own collation and its type's default B-tree operator class. Stricter than
|
|
74
|
+
* `TableMeta.unique`, which an App's address relies on, and kept apart from it.
|
|
75
|
+
*/
|
|
76
|
+
readonly keys: (table: TableMeta) => readonly (readonly string[])[];
|
|
77
|
+
/** How a column compares in a key equality; undefined where the catalog cannot say, which refuses the key. */
|
|
78
|
+
readonly comparison: (table: TableMeta, column: string) => KeyComparison | undefined;
|
|
79
|
+
}
|
|
80
|
+
/** What a catalog says beyond its schema and triggers, read by the engine's own catalog (`Adapter.triggerKeys` for a check). */
|
|
81
|
+
export type TriggerKeyFacts = Pick<EffectCatalog, 'keys' | 'comparison' | 'hierarchy' | 'conflicts' | 'blocked'>;
|
|
82
|
+
/** What decides whether two values of a column are equal, as a trigger's key equality compares them. */
|
|
83
|
+
export interface KeyComparison {
|
|
84
|
+
/** SQLite: the column's affinity; PostgreSQL: its base type and type modifier, its domains unwrapped. */
|
|
85
|
+
readonly type: string;
|
|
86
|
+
/** The collation it compares under ('' for a type without one). */
|
|
87
|
+
readonly collation: string;
|
|
88
|
+
/** False where equal under that collation is not equal bytes (a nondeterministic collation). */
|
|
89
|
+
readonly exact: boolean;
|
|
90
|
+
/** For a refusal: the type and collation as a person reads them. */
|
|
91
|
+
readonly said: string;
|
|
92
|
+
/** Whether the type is one a scoped write takes as a row's identity (keyTypes.ts); a key of any other is refused. */
|
|
93
|
+
readonly keyable: boolean;
|
|
94
|
+
/** For that refusal: the column's type as declared. */
|
|
95
|
+
readonly declared: string;
|
|
96
|
+
}
|
|
97
|
+
/** Each trigger of `catalog.triggered`, its effects resolved to table ids and real column names, judged. */
|
|
98
|
+
export declare function resolveTriggerEffects(catalog: EffectCatalog): Map<string, readonly ScopeTrigger[]>;
|
|
@@ -0,0 +1,189 @@
|
|
|
1
|
+
import { keyTypeRefusal } from './keyTypes.js';
|
|
2
|
+
import { firedBy } from './scopeTriggers.js';
|
|
3
|
+
/** The longest chain of keyed-effect triggers one write may start, itself included. */
|
|
4
|
+
const MAX_TRIGGER_DEPTH = 4;
|
|
5
|
+
const fold = (name) => name.replace(/[A-Z]/g, (char) => char.toLowerCase());
|
|
6
|
+
class Unaccepted extends Error {
|
|
7
|
+
}
|
|
8
|
+
const refuse = (reason) => {
|
|
9
|
+
throw new Unaccepted(reason);
|
|
10
|
+
};
|
|
11
|
+
/** Each trigger of `catalog.triggered`, its effects resolved to table ids and real column names, judged. */
|
|
12
|
+
export function resolveTriggerEffects(catalog) {
|
|
13
|
+
const same = catalog.foldCase ? fold : (name) => name;
|
|
14
|
+
const tables = new Map();
|
|
15
|
+
for (const table of catalog.schema.tables) {
|
|
16
|
+
// SQLite names a table by its name; PostgreSQL's grammar asks for `schema.name`.
|
|
17
|
+
tables.set(catalog.foldCase ? fold(table.name) : `${table.schema}.${table.name}`, table);
|
|
18
|
+
}
|
|
19
|
+
const column = (table, name) => table.columns.find((candidate) => same(candidate.name) === same(name))?.name ??
|
|
20
|
+
refuse(`it names a column ${JSON.stringify(name)} that ${JSON.stringify(table.name)} does not have`);
|
|
21
|
+
const referenced = new Set(catalog.schema.foreignKeys.flatMap((key) => key.to.columns.map((name) => `${key.to.table}\u0000${name}`)));
|
|
22
|
+
// Any reference, whatever its ON DELETE: a cascade reaches rows nobody keyed, a RESTRICT says whether one exists.
|
|
23
|
+
const referencedTables = new Set(catalog.schema.foreignKeys.map((key) => key.to.table));
|
|
24
|
+
/** One effect, its table and columns resolved; throws Unaccepted. */
|
|
25
|
+
const effect = (own, raw) => {
|
|
26
|
+
const table = tables.get(catalog.foldCase ? fold(raw.table) : raw.table);
|
|
27
|
+
if (table && catalog.hierarchy?.has(table.id))
|
|
28
|
+
return refuse(`it ${raw.kind === 'read' ? 'reads' : 'writes'} ${JSON.stringify(raw.table)}, part of a partition or inheritance hierarchy, ` +
|
|
29
|
+
'which writes under a row policy do not support yet');
|
|
30
|
+
const blocked = table && catalog.blocked?.get(table.id);
|
|
31
|
+
if (blocked)
|
|
32
|
+
return refuse(`it ${raw.kind === 'read' ? 'reads' : 'writes'} ${JSON.stringify(raw.table)}, which has ${blocked}`);
|
|
33
|
+
if (!table || table.isView || (!catalog.writable.has(table.id) && !catalog.triggered.has(table.id)))
|
|
34
|
+
return refuse(`it ${raw.kind === 'read' ? 'reads' : 'writes'} ${JSON.stringify(raw.table)}, which a scoped write cannot reach`);
|
|
35
|
+
if (table.id === own.id)
|
|
36
|
+
return refuse('it writes the table it fires on');
|
|
37
|
+
if (raw.kind === 'insert' || raw.kind === 'update') {
|
|
38
|
+
const conflict = catalog.conflicts?.(table);
|
|
39
|
+
if (conflict)
|
|
40
|
+
return refuse(`it ${raw.kind === 'insert' ? 'inserts into' : 'updates'} ${JSON.stringify(table.name)}, whose schema declares ${conflict}: ` +
|
|
41
|
+
'under a delete, which cannot say OR ABORT, that clause and not the proof decides which row the write replaces');
|
|
42
|
+
}
|
|
43
|
+
const ref = (value) => ({ row: value.row, column: column(own, value.column) });
|
|
44
|
+
const term = (value) => ('row' in value ? ref(value) : value);
|
|
45
|
+
let key;
|
|
46
|
+
if (raw.key) {
|
|
47
|
+
key = {};
|
|
48
|
+
for (const [name, value] of Object.entries(raw.key))
|
|
49
|
+
key[column(table, name)] = ref(value);
|
|
50
|
+
const named = new Set(Object.keys(key));
|
|
51
|
+
if (!catalog.keys(table).some((columns) => columns.length > 0 && columns.every((name) => named.has(name))))
|
|
52
|
+
return refuse(`its ${raw.kind === 'read' ? 'read of' : 'write to'} ${JSON.stringify(table.name)} is not by ${catalog.foldCase ? 'the primary key' : 'a key'} of it`);
|
|
53
|
+
/* The proof reads the row by the key column's own comparison (`column = $1`); the trigger compares under
|
|
54
|
+
whatever the two sides of its equality resolve to. Only where both are the same do they find one row. */
|
|
55
|
+
for (const [name, value] of Object.entries(key)) {
|
|
56
|
+
const theirs = catalog.comparison(table, name);
|
|
57
|
+
const ours = catalog.comparison(own, value.column);
|
|
58
|
+
const said = `${JSON.stringify(table.name)}.${name} = ${value.row.toUpperCase()}.${value.column}`;
|
|
59
|
+
if (!theirs || !ours)
|
|
60
|
+
return refuse(`its key ${said} compares columns whose type or collation mistri cannot read`);
|
|
61
|
+
if (!theirs.keyable)
|
|
62
|
+
return refuse(`its key ${said} is not one a scoped write can prove: ${keyTypeRefusal(catalog.foldCase ? 'sqlite' : 'postgres', table.name, name, theirs.declared)}`);
|
|
63
|
+
if (!ours.keyable)
|
|
64
|
+
return refuse(`its key ${said} is not one a scoped write can prove: ${keyTypeRefusal(catalog.foldCase ? 'sqlite' : 'postgres', own.name, value.column, ours.declared)}`);
|
|
65
|
+
if (!theirs.exact)
|
|
66
|
+
return refuse(`its key ${said} compares under a nondeterministic collation (${theirs.said}), where equal is not one value`);
|
|
67
|
+
if (theirs.type !== ours.type || theirs.collation !== ours.collation)
|
|
68
|
+
return refuse(`its key ${said} compares ${theirs.said} with ${ours.said}: a key's two sides must have the same type and collation, or the row it finds is not the one proven`);
|
|
69
|
+
}
|
|
70
|
+
}
|
|
71
|
+
/* Each row an effect reaches is told by its primary key (triggerProof.ts said: history and live sync file it
|
|
72
|
+
there), whatever the effect keys it by; a key that is the primary key was judged above, in its own words. A
|
|
73
|
+
primary key of a type off the list (keyTypes.ts) names a row the database does not compare, as a scoped write's
|
|
74
|
+
own target's would (scopedTransaction.ts target). */
|
|
75
|
+
for (const name of table.columns.filter((candidate) => candidate.primaryKey).map((candidate) => candidate.name)) {
|
|
76
|
+
const compared = catalog.comparison(table, name);
|
|
77
|
+
const reaches = `it ${raw.kind === 'read' ? 'reads' : 'writes'} ${JSON.stringify(raw.table)}, whose primary key`;
|
|
78
|
+
if (!compared)
|
|
79
|
+
return refuse(`${reaches} is of a type mistri cannot read`);
|
|
80
|
+
if (!compared.keyable)
|
|
81
|
+
return refuse(`${reaches} cannot name its rows: ${keyTypeRefusal(catalog.foldCase ? 'sqlite' : 'postgres', table.name, name, compared.declared)}`);
|
|
82
|
+
}
|
|
83
|
+
let values;
|
|
84
|
+
if (raw.values) {
|
|
85
|
+
values = {};
|
|
86
|
+
for (const [name, value] of Object.entries(raw.values)) {
|
|
87
|
+
const real = column(table, name);
|
|
88
|
+
values[real] = term(value);
|
|
89
|
+
if (raw.kind === 'read')
|
|
90
|
+
continue;
|
|
91
|
+
const meta = table.columns.find((candidate) => candidate.name === real);
|
|
92
|
+
if (meta.writable === false)
|
|
93
|
+
refuse(`it writes the generated column ${JSON.stringify(real)} of ${JSON.stringify(table.name)}`);
|
|
94
|
+
if (raw.kind === 'update' && (meta.primaryKey || (key && Object.hasOwn(key, real))))
|
|
95
|
+
refuse(`it changes the key of ${JSON.stringify(table.name)}`);
|
|
96
|
+
if (raw.kind === 'update' && referenced.has(`${table.id}\u0000${real}`))
|
|
97
|
+
refuse(`it changes ${JSON.stringify(real)} of ${JSON.stringify(table.name)}, which another table references`);
|
|
98
|
+
}
|
|
99
|
+
}
|
|
100
|
+
if (raw.kind === 'delete' && referencedTables.has(table.id))
|
|
101
|
+
refuse(`it deletes from ${JSON.stringify(table.name)}, which a foreign key references: whether the delete runs would say whether a row the principal cannot see references it`);
|
|
102
|
+
return { kind: raw.kind, table: table.id, ...(key ? { key } : {}), ...(values ? { values } : {}) };
|
|
103
|
+
};
|
|
104
|
+
/* Each keyed trigger once, resolved; then depth and cycles over the graph of what each effect fires. */
|
|
105
|
+
const resolved = new Map();
|
|
106
|
+
for (const [id, triggers] of catalog.triggered) {
|
|
107
|
+
const own = catalog.schema.tables.find((table) => table.id === id);
|
|
108
|
+
for (const trigger of triggers) {
|
|
109
|
+
if (trigger.validates || !trigger.effects)
|
|
110
|
+
continue;
|
|
111
|
+
if (!own) {
|
|
112
|
+
resolved.set(trigger, { unaccepted: 'its table is not in the catalog' });
|
|
113
|
+
continue;
|
|
114
|
+
}
|
|
115
|
+
try {
|
|
116
|
+
resolved.set(trigger, {
|
|
117
|
+
effects: trigger.effects.map((raw) => effect(own, raw)),
|
|
118
|
+
...(trigger.unaccepted ? { unaccepted: trigger.unaccepted } : {}),
|
|
119
|
+
});
|
|
120
|
+
}
|
|
121
|
+
catch (error) {
|
|
122
|
+
if (!(error instanceof Unaccepted))
|
|
123
|
+
throw error;
|
|
124
|
+
resolved.set(trigger, { unaccepted: trigger.unaccepted ?? error.message });
|
|
125
|
+
}
|
|
126
|
+
}
|
|
127
|
+
}
|
|
128
|
+
/** The keyed triggers an effect fires on its table; throws Unaccepted where one fired is neither validation-only nor keyed. */
|
|
129
|
+
const fires = (raw) => {
|
|
130
|
+
if (raw.kind === 'read')
|
|
131
|
+
return [];
|
|
132
|
+
const write = { kind: raw.kind, ...(raw.kind === 'update' ? { set: Object.keys(raw.values ?? {}) } : {}) };
|
|
133
|
+
const fired = firedBy(catalog.triggered.get(raw.table) ?? [], write, catalog.foldCase);
|
|
134
|
+
for (const next of fired) {
|
|
135
|
+
if (next.validates)
|
|
136
|
+
continue;
|
|
137
|
+
const entry = resolved.get(next);
|
|
138
|
+
// A CHECK, a default or a domain calling a function of the database's (PostgreSQL) is run, not fired, and never keyed.
|
|
139
|
+
if (!entry?.effects || entry.unaccepted)
|
|
140
|
+
refuse(`its write to ${JSON.stringify(raw.table)} ${next.kind ? `runs the ${next.kind}` : 'fires'} ${JSON.stringify(next.name)}, ` +
|
|
141
|
+
`${entry?.unaccepted ?? next.why ?? 'which is not validation-only'}`);
|
|
142
|
+
}
|
|
143
|
+
return fired.filter((next) => !next.validates);
|
|
144
|
+
};
|
|
145
|
+
const depths = new Map();
|
|
146
|
+
const visiting = new Set();
|
|
147
|
+
const depth = (trigger) => {
|
|
148
|
+
const known = depths.get(trigger);
|
|
149
|
+
if (known !== undefined)
|
|
150
|
+
return known;
|
|
151
|
+
if (visiting.has(trigger))
|
|
152
|
+
return refuse('its effects fire it again');
|
|
153
|
+
visiting.add(trigger);
|
|
154
|
+
try {
|
|
155
|
+
let deepest = 0;
|
|
156
|
+
for (const raw of resolved.get(trigger)?.effects ?? [])
|
|
157
|
+
for (const next of fires(raw))
|
|
158
|
+
deepest = Math.max(deepest, depth(next));
|
|
159
|
+
const result = deepest + 1;
|
|
160
|
+
if (result > MAX_TRIGGER_DEPTH)
|
|
161
|
+
refuse(`its effects start a chain of more than ${MAX_TRIGGER_DEPTH} triggers`);
|
|
162
|
+
depths.set(trigger, result);
|
|
163
|
+
return result;
|
|
164
|
+
}
|
|
165
|
+
finally {
|
|
166
|
+
visiting.delete(trigger);
|
|
167
|
+
}
|
|
168
|
+
};
|
|
169
|
+
const result = new Map();
|
|
170
|
+
for (const [id, triggers] of catalog.triggered) {
|
|
171
|
+
result.set(id, triggers.map((trigger) => {
|
|
172
|
+
const entry = resolved.get(trigger);
|
|
173
|
+
if (!entry)
|
|
174
|
+
return trigger;
|
|
175
|
+
const base = { ...trigger, ...(entry.effects ? { effects: entry.effects } : {}) };
|
|
176
|
+
if (entry.unaccepted)
|
|
177
|
+
return { ...base, unaccepted: entry.unaccepted };
|
|
178
|
+
try {
|
|
179
|
+
return { ...base, depth: depth(trigger) };
|
|
180
|
+
}
|
|
181
|
+
catch (error) {
|
|
182
|
+
if (!(error instanceof Unaccepted))
|
|
183
|
+
throw error;
|
|
184
|
+
return { ...base, unaccepted: error.message };
|
|
185
|
+
}
|
|
186
|
+
}));
|
|
187
|
+
}
|
|
188
|
+
return result;
|
|
189
|
+
}
|
|
@@ -0,0 +1,124 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* A scoped write that fires a trigger the App named: each row the trigger's
|
|
3
|
+
* keyed effects reach, proven inside the person's rows (docs/trigger-effects.md,
|
|
4
|
+
* Option 1). A trigger never gives authority — every key it writes or reads
|
|
5
|
+
* must be one the policy admits, checked under the same locks a parent key
|
|
6
|
+
* gets, and where a key outside it is refused with the answer a hidden row
|
|
7
|
+
* gets, never one that tells a hidden row from a missing one.
|
|
8
|
+
*
|
|
9
|
+
* Before the statement that fires it, from the request's values and the row
|
|
10
|
+
* already read and locked for the write's own guard:
|
|
11
|
+
*
|
|
12
|
+
* - an effect's update or delete locks its row (FOR UPDATE on PostgreSQL;
|
|
13
|
+
* SQLite's BEGIN IMMEDIATE already holds the database) and reads it under
|
|
14
|
+
* the policy: exactly one row, or refused;
|
|
15
|
+
* - a keyed read holds its row (FOR SHARE) and counts it under the policy:
|
|
16
|
+
* exactly one, or refused, so whether the trigger raises cannot say whether
|
|
17
|
+
* a hidden row exists;
|
|
18
|
+
* - an inserted row is judged by the policy's rule for its table, evaluated on
|
|
19
|
+
* the values the trigger gives it, and its references checked like any new
|
|
20
|
+
* row's;
|
|
21
|
+
* - every reference an insert gives or an update sets is checked before the
|
|
22
|
+
* statement where its value is known then, so a parent that does not exist
|
|
23
|
+
* answers as a hidden one does, not with the database's foreign key error. A
|
|
24
|
+
* reference given by an expression only the statement computes is refused.
|
|
25
|
+
*
|
|
26
|
+
* Every row an update, a delete or a keyed read reaches is named by a key
|
|
27
|
+
* known before the statement. A key only the statement can tell — a value the
|
|
28
|
+
* database assigns (an id, a default), a value a trigger computes — is
|
|
29
|
+
* refused: proven after the statement, it would be proven against the row the
|
|
30
|
+
* trigger had already changed, which can be one the trigger moved into the
|
|
31
|
+
* person's rows. An insert alone may wait for the statement, where what its
|
|
32
|
+
* row's place in the policy depends on is assigned by it; such an insert may
|
|
33
|
+
* fire no keyed trigger on its table, whose own proof would come after it ran.
|
|
34
|
+
* An updated row is read again after the statement, so a trigger cannot move
|
|
35
|
+
* it out of the person's rows, and the references it set are checked. What
|
|
36
|
+
* each effect fires on its own table is proven the same way, to the depth the
|
|
37
|
+
* catalog allowed (triggerEffects.ts).
|
|
38
|
+
*/
|
|
39
|
+
import type { Filter, ScopedReads } from '../adapter.js';
|
|
40
|
+
import type { RowScope } from '../../shared/rowScope.js';
|
|
41
|
+
import type { ForeignKey, TableMeta } from '../../shared/schema.js';
|
|
42
|
+
import { type ScopeTrigger, type TriggeringWrite } from './scopeTriggers.js';
|
|
43
|
+
/** The triggers an App accepts, as its transaction hands them to the engine. */
|
|
44
|
+
export interface TriggerAcceptance {
|
|
45
|
+
/**
|
|
46
|
+
* Each physical table's named triggers, each with the digest authority.lock approved for it (undefined where the
|
|
47
|
+
* lock records none yet: the server's start and `mistri check` refuse a stale lock, this pins a recorded one).
|
|
48
|
+
*/
|
|
49
|
+
readonly named: ReadonlyMap<string, ReadonlyMap<string, string | undefined>>;
|
|
50
|
+
/**
|
|
51
|
+
* Told of each row an accepted trigger changed, once the statement that fired it is proven, and awaited: the
|
|
52
|
+
* engine's own witness, record history and live sync are told through it, on the transaction's writer.
|
|
53
|
+
*/
|
|
54
|
+
readonly changed?: (change: TriggerChange) => void | Promise<void>;
|
|
55
|
+
}
|
|
56
|
+
/** What a scoped transaction is given to accept triggers: the App's acceptance, and the policy it runs under. */
|
|
57
|
+
export interface ScopedTriggers {
|
|
58
|
+
readonly acceptance: TriggerAcceptance;
|
|
59
|
+
readonly scope: RowScope;
|
|
60
|
+
/** The engine's own witness of what the triggers wrote, where it keeps one (SQLite's session). */
|
|
61
|
+
readonly watch?: () => void;
|
|
62
|
+
/** This module's proof, which the engine loads where a transaction accepts triggers rather than at startup. */
|
|
63
|
+
readonly prove: typeof createTriggerProof;
|
|
64
|
+
}
|
|
65
|
+
/** A row a trigger changed. */
|
|
66
|
+
export interface TriggerChange {
|
|
67
|
+
readonly table: string;
|
|
68
|
+
readonly kind: 'insert' | 'update' | 'delete';
|
|
69
|
+
/** Its primary key; absent where the database assigned it and nothing read it back (an insert's generated id). */
|
|
70
|
+
readonly key?: Readonly<Record<string, unknown>>;
|
|
71
|
+
readonly before?: Readonly<Record<string, unknown>>;
|
|
72
|
+
readonly after?: Readonly<Record<string, unknown>>;
|
|
73
|
+
/** The trigger, and the table it fired on. */
|
|
74
|
+
readonly trigger: string;
|
|
75
|
+
readonly on: string;
|
|
76
|
+
}
|
|
77
|
+
/** What the proof borrows from the scoped transaction it runs in. */
|
|
78
|
+
interface ProofTools {
|
|
79
|
+
readonly tables: readonly TableMeta[];
|
|
80
|
+
readonly foreignKeys: readonly ForeignKey[];
|
|
81
|
+
readonly triggered: ReadonlyMap<string, readonly ScopeTrigger[]> | undefined;
|
|
82
|
+
readonly foldCase: boolean;
|
|
83
|
+
/** The policy the transaction runs under, by physical table: a row a trigger inserts is judged by its table's rule. */
|
|
84
|
+
readonly scope: RowScope;
|
|
85
|
+
guards(): Pick<ScopedReads, 'query' | 'count'>;
|
|
86
|
+
lockedRead(table: TableMeta, filter: Filter, within: Pick<ScopedReads, 'query' | 'count'>): Promise<{
|
|
87
|
+
rows: Record<string, unknown>[];
|
|
88
|
+
}>;
|
|
89
|
+
/** A row by its key under the guards, with its reference columns' stored text (storedText.ts), taking no lock. */
|
|
90
|
+
read(table: TableMeta, filter: Filter): Promise<{
|
|
91
|
+
rows: Record<string, unknown>[];
|
|
92
|
+
}>;
|
|
93
|
+
parents(table: TableMeta, row: Record<string, unknown>, set?: ReadonlySet<string>): Promise<void>;
|
|
94
|
+
/**
|
|
95
|
+
* Before the statement: the references of `row` whose every column it holds, checked as `parents` checks them. A
|
|
96
|
+
* parent that does not exist would fail the statement with the database's foreign key error, and a hidden one pass
|
|
97
|
+
* it: checked first, both are the one refusal.
|
|
98
|
+
*/
|
|
99
|
+
parentsBefore(table: TableMeta, row: Record<string, unknown>, set?: ReadonlySet<string>): Promise<void>;
|
|
100
|
+
holdParent?(table: TableMeta, filter: Filter): Promise<void>;
|
|
101
|
+
relied?(table: TableMeta): void;
|
|
102
|
+
/** Before a statement that fires an accepted trigger: SQLite's session starts recording (sqliteTriggerSession.ts). */
|
|
103
|
+
watch?(): void;
|
|
104
|
+
refuse(reason: string): never;
|
|
105
|
+
}
|
|
106
|
+
type Row = Record<string, unknown>;
|
|
107
|
+
/** The row a trigger sees as NEW or OLD: null where there is none (OLD on an insert), and a column missing where its value is not known yet. */
|
|
108
|
+
export interface Images {
|
|
109
|
+
readonly new: Row | null;
|
|
110
|
+
readonly old: Row | null;
|
|
111
|
+
}
|
|
112
|
+
/** What runs right after the statement, given the triggering row as it then stands. */
|
|
113
|
+
export type Afterward = (images: Images) => Promise<void>;
|
|
114
|
+
export declare function createTriggerProof(acceptance: TriggerAcceptance, tools: ProofTools): {
|
|
115
|
+
accepts: (table: string, trigger: ScopeTrigger) => boolean;
|
|
116
|
+
unaccepted: (table: string, trigger: ScopeTrigger) => string | undefined;
|
|
117
|
+
before: (table: TableMeta, write: TriggeringWrite, images: Images) => Promise<Afterward[]>;
|
|
118
|
+
images: {
|
|
119
|
+
insert: (table: TableMeta, values: Row | undefined) => Images;
|
|
120
|
+
update: (table: TableMeta, stored: Row, values: Row | undefined) => Images;
|
|
121
|
+
delete: (stored: Row) => Images;
|
|
122
|
+
};
|
|
123
|
+
};
|
|
124
|
+
export {};
|