@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,122 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* The triggers on a table a scoped write may target, and which of them a given
|
|
3
|
+
* write can fire.
|
|
4
|
+
*
|
|
5
|
+
* A row policy bounds the rows a write reaches; a trigger runs inside that
|
|
6
|
+
* write and reaches whatever its body says, which the policy cannot see. So a
|
|
7
|
+
* table with a trigger used to be refused as a target outright, for every
|
|
8
|
+
* write — and a field report's ledger lost its integrity triggers to get past
|
|
9
|
+
* it: a validation-only `BEFORE UPDATE OF posted_minor` refused an update of
|
|
10
|
+
* `status` that could never fire it.
|
|
11
|
+
*
|
|
12
|
+
* Two facts now decide it per write, not per table, and each fails closed:
|
|
13
|
+
*
|
|
14
|
+
* - Whether the write can fire the trigger at all. An INSERT fires the INSERT
|
|
15
|
+
* triggers, a DELETE the DELETE triggers, and an UPDATE every UPDATE trigger
|
|
16
|
+
* without a column list and those whose `UPDATE OF` list meets the columns it
|
|
17
|
+
* sets. Both engines fire on the SET list, not on whether a value changed.
|
|
18
|
+
* A definition the engine cannot read is taken to fire on every write.
|
|
19
|
+
* - Whether the trigger is validation-only: it reads only the row being
|
|
20
|
+
* written (NEW and OLD) and literals, raises or does nothing, and writes
|
|
21
|
+
* nothing — not even NEW. Such a trigger is a CHECK constraint written as
|
|
22
|
+
* code: what it reads the policy already admitted (the row is in scope), and
|
|
23
|
+
* what it does is refuse the statement. One that reads another table could
|
|
24
|
+
* say, by whether it raises, that a row the policy hides exists, so it is not
|
|
25
|
+
* validation-only, however little it writes. The grammar each engine
|
|
26
|
+
* accepts is narrow on purpose (sqliteTriggers.ts, postgresTriggers.ts):
|
|
27
|
+
* anything else is not proven, and blocks the writes that fire it.
|
|
28
|
+
*/
|
|
29
|
+
export type TriggerEvent = 'insert' | 'update' | 'delete';
|
|
30
|
+
/** A column of the row being written, as a trigger names it: `NEW.account_id`, `OLD.id`. */
|
|
31
|
+
export interface EffectRef {
|
|
32
|
+
readonly row: 'new' | 'old';
|
|
33
|
+
readonly column: string;
|
|
34
|
+
}
|
|
35
|
+
/**
|
|
36
|
+
* A value a keyed effect writes: a column of the row being written, a literal, or an expression in the grammar
|
|
37
|
+
* whose value only the trigger computes (`posted_minor + NEW.amount`, `CURRENT_TIMESTAMP`). Only the first two are
|
|
38
|
+
* known before the write.
|
|
39
|
+
*/
|
|
40
|
+
export type EffectTerm = EffectRef | {
|
|
41
|
+
readonly literal: string | number | null;
|
|
42
|
+
} | {
|
|
43
|
+
readonly expression: true;
|
|
44
|
+
};
|
|
45
|
+
/**
|
|
46
|
+
* One thing a trigger does beyond checking its own row, in the keyed-effect grammar (docs/trigger-effects.md): it
|
|
47
|
+
* writes, inserts or deletes one row of a table it names by a key equal to columns of NEW or OLD, or reads one
|
|
48
|
+
* column of such a row in a condition. `table` is the name the body gives it (PostgreSQL `schema.name`), until the
|
|
49
|
+
* catalog resolves it to a table id (triggerEffects.ts).
|
|
50
|
+
*/
|
|
51
|
+
export interface TriggerEffect {
|
|
52
|
+
readonly kind: 'update' | 'insert' | 'delete' | 'read';
|
|
53
|
+
readonly table: string;
|
|
54
|
+
/** update, delete and read: the row it reaches, each key column equal to a column of NEW or OLD. */
|
|
55
|
+
readonly key?: Readonly<Record<string, EffectRef>>;
|
|
56
|
+
/** update: the columns it sets; insert: the columns it gives; read: the column it reads (a null literal). */
|
|
57
|
+
readonly values?: Readonly<Record<string, EffectTerm>>;
|
|
58
|
+
}
|
|
59
|
+
/**
|
|
60
|
+
* One trigger on a table, as the writer's catalog read it — or other code a write runs that the policy cannot bound,
|
|
61
|
+
* judged the same way: a CHECK constraint, a default or a domain calling a function of the database's
|
|
62
|
+
* (postgresTriggers.ts readPostgresTableCode). Such code is never validation-only.
|
|
63
|
+
*/
|
|
64
|
+
export interface ScopeTrigger {
|
|
65
|
+
readonly name: string;
|
|
66
|
+
/** What it is, as a refusal names it, when not a trigger: `CHECK constraint`, `default of column`, `domain`. */
|
|
67
|
+
readonly kind?: string;
|
|
68
|
+
/** The writes that may fire it. */
|
|
69
|
+
readonly events: readonly TriggerEvent[];
|
|
70
|
+
/** An update fires it only when it sets one of these columns (`UPDATE OF`). Absent: every update fires it. */
|
|
71
|
+
readonly columns?: readonly string[];
|
|
72
|
+
/** Proven validation-only (above): it does not block the writes that fire it. */
|
|
73
|
+
readonly validates: boolean;
|
|
74
|
+
/** Why it is not, as a refusal and `mistri check` say it: `it writes rows`, `it reads another table`. */
|
|
75
|
+
readonly why?: string;
|
|
76
|
+
/**
|
|
77
|
+
* What it does, where its body is in the keyed-effect grammar and does more than validate: the effects an App
|
|
78
|
+
* accepts by naming the trigger (`resources.<table>.triggers`). Absent where the body leaves the grammar.
|
|
79
|
+
*/
|
|
80
|
+
readonly effects?: readonly TriggerEffect[];
|
|
81
|
+
/** Why the effects cannot be accepted even when named, once the catalog has judged them (triggerEffects.ts). */
|
|
82
|
+
readonly unaccepted?: string;
|
|
83
|
+
/** `sha256:<hex>` of the normalized definition: what authority.lock approves, so a changed body is a stale lock. */
|
|
84
|
+
readonly digest?: string;
|
|
85
|
+
/** The longest chain of accepted-kind triggers its effects start, itself included (triggerEffects.ts). */
|
|
86
|
+
readonly depth?: number;
|
|
87
|
+
}
|
|
88
|
+
/** Why a trigger's effects are not accepted where its definition is not plain (plainDefinition). */
|
|
89
|
+
export declare const PLAIN = "its definition holds characters outside plain SQL, or an IN without a list";
|
|
90
|
+
/**
|
|
91
|
+
* Whether a definition is plain enough for its effects to be accepted: outside its literals, quoted names and
|
|
92
|
+
* comments, only ASCII and the engines' common whitespace (no U+00A0, which JavaScript's `\s` takes for space and
|
|
93
|
+
* SQLite for part of a name; no vertical tab), no `$`, and every IN followed by a parenthesized list. Effects widen
|
|
94
|
+
* what a write reaches, so they are held to the strictest reading even where validation is not.
|
|
95
|
+
*/
|
|
96
|
+
export declare function plainDefinition(sql: string, tokens: readonly {
|
|
97
|
+
kind: string;
|
|
98
|
+
text?: string;
|
|
99
|
+
upper?: string;
|
|
100
|
+
}[], dialect: 'sqlite' | 'postgres'): boolean;
|
|
101
|
+
/** A write as the triggers see it: its kind, and for an update the columns it sets. */
|
|
102
|
+
export interface TriggeringWrite {
|
|
103
|
+
readonly kind: TriggerEvent;
|
|
104
|
+
readonly set?: readonly string[];
|
|
105
|
+
}
|
|
106
|
+
/** The triggers `write` can fire. */
|
|
107
|
+
export declare function firedBy(triggers: readonly ScopeTrigger[], write: TriggeringWrite, foldCase: boolean): ScopeTrigger[];
|
|
108
|
+
/** The triggers that keep `write` from running under a row policy: those it fires that are not validation-only. */
|
|
109
|
+
export declare function blockingTriggers(triggers: readonly ScopeTrigger[], write: TriggeringWrite, foldCase: boolean): ScopeTrigger[];
|
|
110
|
+
/** A write as a sentence names it: `an insert`, `an update of status, note`, `a delete`. */
|
|
111
|
+
export declare function sayWrite(write: TriggeringWrite): string;
|
|
112
|
+
/**
|
|
113
|
+
* Triggers as a refusal and `mistri check` name them: `the trigger "post" (it writes rows)`; other code by what it is,
|
|
114
|
+
* `the CHECK constraint "seen" (it calls public.peek(text))`.
|
|
115
|
+
*/
|
|
116
|
+
export declare const sayTriggers: (triggers: readonly ScopeTrigger[]) => string;
|
|
117
|
+
/** What a write does to the code it runs, as a refusal says it: `fires` a trigger, `runs` a constraint or a default. */
|
|
118
|
+
export declare const sayRuns: (triggers: readonly ScopeTrigger[]) => string;
|
|
119
|
+
/** The writes a set of triggers blocks, as `mistri check` names them: `inserts`, `updates of posted_minor`, `deletes`. */
|
|
120
|
+
export declare function sayBlocked(triggers: readonly ScopeTrigger[]): string[];
|
|
121
|
+
/** Whether the triggers refuse every insert, every update and every delete: no write to the table can run. */
|
|
122
|
+
export declare function blocksEveryWrite(triggers: readonly ScopeTrigger[]): boolean;
|
|
@@ -0,0 +1,131 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* The triggers on a table a scoped write may target, and which of them a given
|
|
3
|
+
* write can fire.
|
|
4
|
+
*
|
|
5
|
+
* A row policy bounds the rows a write reaches; a trigger runs inside that
|
|
6
|
+
* write and reaches whatever its body says, which the policy cannot see. So a
|
|
7
|
+
* table with a trigger used to be refused as a target outright, for every
|
|
8
|
+
* write — and a field report's ledger lost its integrity triggers to get past
|
|
9
|
+
* it: a validation-only `BEFORE UPDATE OF posted_minor` refused an update of
|
|
10
|
+
* `status` that could never fire it.
|
|
11
|
+
*
|
|
12
|
+
* Two facts now decide it per write, not per table, and each fails closed:
|
|
13
|
+
*
|
|
14
|
+
* - Whether the write can fire the trigger at all. An INSERT fires the INSERT
|
|
15
|
+
* triggers, a DELETE the DELETE triggers, and an UPDATE every UPDATE trigger
|
|
16
|
+
* without a column list and those whose `UPDATE OF` list meets the columns it
|
|
17
|
+
* sets. Both engines fire on the SET list, not on whether a value changed.
|
|
18
|
+
* A definition the engine cannot read is taken to fire on every write.
|
|
19
|
+
* - Whether the trigger is validation-only: it reads only the row being
|
|
20
|
+
* written (NEW and OLD) and literals, raises or does nothing, and writes
|
|
21
|
+
* nothing — not even NEW. Such a trigger is a CHECK constraint written as
|
|
22
|
+
* code: what it reads the policy already admitted (the row is in scope), and
|
|
23
|
+
* what it does is refuse the statement. One that reads another table could
|
|
24
|
+
* say, by whether it raises, that a row the policy hides exists, so it is not
|
|
25
|
+
* validation-only, however little it writes. The grammar each engine
|
|
26
|
+
* accepts is narrow on purpose (sqliteTriggers.ts, postgresTriggers.ts):
|
|
27
|
+
* anything else is not proven, and blocks the writes that fire it.
|
|
28
|
+
*/
|
|
29
|
+
/** Why a trigger's effects are not accepted where its definition is not plain (plainDefinition). */
|
|
30
|
+
export const PLAIN = 'its definition holds characters outside plain SQL, or an IN without a list';
|
|
31
|
+
/**
|
|
32
|
+
* Whether a definition is plain enough for its effects to be accepted: outside its literals, quoted names and
|
|
33
|
+
* comments, only ASCII and the engines' common whitespace (no U+00A0, which JavaScript's `\s` takes for space and
|
|
34
|
+
* SQLite for part of a name; no vertical tab), no `$`, and every IN followed by a parenthesized list. Effects widen
|
|
35
|
+
* what a write reaches, so they are held to the strictest reading even where validation is not.
|
|
36
|
+
*/
|
|
37
|
+
export function plainDefinition(sql, tokens, dialect) {
|
|
38
|
+
let i = 0;
|
|
39
|
+
while (i < sql.length) {
|
|
40
|
+
const char = sql[i];
|
|
41
|
+
const close = char === "'"
|
|
42
|
+
? "'"
|
|
43
|
+
: char === '"'
|
|
44
|
+
? '"'
|
|
45
|
+
: dialect === 'sqlite' && char === '`'
|
|
46
|
+
? '`'
|
|
47
|
+
: dialect === 'sqlite' && char === '['
|
|
48
|
+
? ']'
|
|
49
|
+
: undefined;
|
|
50
|
+
if (close) {
|
|
51
|
+
const end = sql.indexOf(close, i + 1);
|
|
52
|
+
if (end === -1)
|
|
53
|
+
return false;
|
|
54
|
+
i = end + 1;
|
|
55
|
+
}
|
|
56
|
+
else if (sql.startsWith('--', i)) {
|
|
57
|
+
const end = sql.indexOf('\n', i);
|
|
58
|
+
i = end === -1 ? sql.length : end + 1;
|
|
59
|
+
}
|
|
60
|
+
else if (sql.startsWith('/*', i)) {
|
|
61
|
+
const end = sql.indexOf('*/', i + 2);
|
|
62
|
+
if (end === -1)
|
|
63
|
+
return false;
|
|
64
|
+
i = end + 2;
|
|
65
|
+
}
|
|
66
|
+
else {
|
|
67
|
+
const code = char.charCodeAt(0);
|
|
68
|
+
if (code >= 0x7f || char === '$' || (code < 0x20 && !'\t\n\f\r'.includes(char)))
|
|
69
|
+
return false;
|
|
70
|
+
i += 1;
|
|
71
|
+
}
|
|
72
|
+
}
|
|
73
|
+
return tokens.every((token, index) => token.upper !== 'IN' || (tokens[index + 1]?.kind === 'op' && tokens[index + 1]?.text === '('));
|
|
74
|
+
}
|
|
75
|
+
/* SQLite matches a column name in `UPDATE OF` as it matches every identifier, folding ASCII case; PostgreSQL names
|
|
76
|
+
an attribute exactly. */
|
|
77
|
+
const foldedName = (name) => name.replace(/[A-Z]/g, (char) => char.toLowerCase());
|
|
78
|
+
/** The triggers `write` can fire. */
|
|
79
|
+
export function firedBy(triggers, write, foldCase) {
|
|
80
|
+
const same = foldCase ? foldedName : (name) => name;
|
|
81
|
+
const set = new Set((write.set ?? []).map(same));
|
|
82
|
+
return triggers.filter((trigger) => trigger.events.includes(write.kind) &&
|
|
83
|
+
(write.kind !== 'update' ||
|
|
84
|
+
trigger.columns === undefined ||
|
|
85
|
+
write.set === undefined ||
|
|
86
|
+
trigger.columns.some((column) => set.has(same(column)))));
|
|
87
|
+
}
|
|
88
|
+
/** The triggers that keep `write` from running under a row policy: those it fires that are not validation-only. */
|
|
89
|
+
export function blockingTriggers(triggers, write, foldCase) {
|
|
90
|
+
return firedBy(triggers, write, foldCase).filter((trigger) => !trigger.validates);
|
|
91
|
+
}
|
|
92
|
+
/** A write as a sentence names it: `an insert`, `an update of status, note`, `a delete`. */
|
|
93
|
+
export function sayWrite(write) {
|
|
94
|
+
if (write.kind === 'insert')
|
|
95
|
+
return 'an insert';
|
|
96
|
+
if (write.kind === 'delete')
|
|
97
|
+
return 'a delete';
|
|
98
|
+
return write.set?.length ? `an update of ${write.set.join(', ')}` : 'an update';
|
|
99
|
+
}
|
|
100
|
+
const said = (trigger) => `${JSON.stringify(trigger.name)} (${trigger.why ?? 'it is not validation-only'})`;
|
|
101
|
+
/**
|
|
102
|
+
* Triggers as a refusal and `mistri check` name them: `the trigger "post" (it writes rows)`; other code by what it is,
|
|
103
|
+
* `the CHECK constraint "seen" (it calls public.peek(text))`.
|
|
104
|
+
*/
|
|
105
|
+
export const sayTriggers = (triggers) => triggers.every((trigger) => trigger.kind === undefined)
|
|
106
|
+
? `the trigger${triggers.length === 1 ? '' : 's'} ${triggers.map(said).join(', ')}`
|
|
107
|
+
: triggers.map((trigger) => `the ${trigger.kind ?? 'trigger'} ${said(trigger)}`).join(', ');
|
|
108
|
+
/** What a write does to the code it runs, as a refusal says it: `fires` a trigger, `runs` a constraint or a default. */
|
|
109
|
+
export const sayRuns = (triggers) => triggers.every((trigger) => trigger.kind === undefined) ? 'fires' : 'runs';
|
|
110
|
+
/** The writes a set of triggers blocks, as `mistri check` names them: `inserts`, `updates of posted_minor`, `deletes`. */
|
|
111
|
+
export function sayBlocked(triggers) {
|
|
112
|
+
const blocking = triggers.filter((trigger) => !trigger.validates);
|
|
113
|
+
const said = [];
|
|
114
|
+
if (blocking.some((trigger) => trigger.events.includes('insert')))
|
|
115
|
+
said.push('inserts');
|
|
116
|
+
const updates = blocking.filter((trigger) => trigger.events.includes('update'));
|
|
117
|
+
if (updates.some((trigger) => trigger.columns === undefined))
|
|
118
|
+
said.push('every update');
|
|
119
|
+
else if (updates.length)
|
|
120
|
+
said.push(`updates of ${[...new Set(updates.flatMap((trigger) => trigger.columns))].join(', ')}`);
|
|
121
|
+
if (blocking.some((trigger) => trigger.events.includes('delete')))
|
|
122
|
+
said.push('deletes');
|
|
123
|
+
return said;
|
|
124
|
+
}
|
|
125
|
+
/** Whether the triggers refuse every insert, every update and every delete: no write to the table can run. */
|
|
126
|
+
export function blocksEveryWrite(triggers) {
|
|
127
|
+
const blocking = triggers.filter((trigger) => !trigger.validates);
|
|
128
|
+
return (blocking.some((trigger) => trigger.events.includes('insert')) &&
|
|
129
|
+
blocking.some((trigger) => trigger.events.includes('update') && trigger.columns === undefined) &&
|
|
130
|
+
blocking.some((trigger) => trigger.events.includes('delete')));
|
|
131
|
+
}
|
|
@@ -0,0 +1,5 @@
|
|
|
1
|
+
/** Adapter-owned command queue capture and failure accounting within a scoped transaction. */
|
|
2
|
+
import { type TransactionOperations } from '../adapter.js';
|
|
3
|
+
/** Shared adapter queue boundary: capture before waiting; caught malformed or
|
|
4
|
+
* failed operations still poison the transaction. No writer escapes here. */
|
|
5
|
+
export declare function scopedCommandInvoker(operations: TransactionOperations, scoped: boolean, command: boolean, runtime: (table: string) => boolean, verify?: () => void): <A, R>(input: A, work: (input: A) => Promise<R>, read?: boolean) => Promise<R>;
|
|
@@ -0,0 +1,48 @@
|
|
|
1
|
+
/** Adapter-owned command queue capture and failure accounting within a scoped transaction. */
|
|
2
|
+
import { Refusal } from '../adapter.js';
|
|
3
|
+
import { snapshotScopedData } from './scopedReads.js';
|
|
4
|
+
/** Shared adapter queue boundary: capture before waiting; caught malformed or
|
|
5
|
+
* failed operations still poison the transaction. No writer escapes here. */
|
|
6
|
+
export function scopedCommandInvoker(operations, scoped, command, runtime, verify = () => { }) {
|
|
7
|
+
let failed = false;
|
|
8
|
+
/* `read`: the work only reads, so on a transaction that sends together it may start beside reads in flight
|
|
9
|
+
(TransactionOperations.read); a failure still poisons every operation after it, in the order asked. */
|
|
10
|
+
return (input, work, read = false) => {
|
|
11
|
+
let captured = input;
|
|
12
|
+
let invalid;
|
|
13
|
+
if (scoped) {
|
|
14
|
+
try {
|
|
15
|
+
captured = snapshotScopedData(input);
|
|
16
|
+
}
|
|
17
|
+
catch (error) {
|
|
18
|
+
invalid = { error };
|
|
19
|
+
}
|
|
20
|
+
}
|
|
21
|
+
const job = async () => {
|
|
22
|
+
if (scoped && failed)
|
|
23
|
+
throw new Refusal('This scoped transaction has failed.');
|
|
24
|
+
try {
|
|
25
|
+
if (invalid)
|
|
26
|
+
throw invalid.error;
|
|
27
|
+
verify();
|
|
28
|
+
if (command &&
|
|
29
|
+
scoped &&
|
|
30
|
+
captured &&
|
|
31
|
+
typeof captured === 'object' &&
|
|
32
|
+
'table' in captured &&
|
|
33
|
+
typeof captured.table === 'string' &&
|
|
34
|
+
runtime(captured.table)) {
|
|
35
|
+
throw new Refusal('Reserved resources are runtime-only.');
|
|
36
|
+
}
|
|
37
|
+
const result = await work(captured);
|
|
38
|
+
verify();
|
|
39
|
+
return result;
|
|
40
|
+
}
|
|
41
|
+
catch (error) {
|
|
42
|
+
failed = true;
|
|
43
|
+
throw error;
|
|
44
|
+
}
|
|
45
|
+
};
|
|
46
|
+
return read ? operations.read(job) : operations.run(job);
|
|
47
|
+
};
|
|
48
|
+
}
|
|
@@ -0,0 +1,22 @@
|
|
|
1
|
+
import { type QueryResult, type ScopedReads, type SqlFragment, type SqlStyle } from '../adapter.js';
|
|
2
|
+
import { type DatabaseSchema } from '../../shared/schema.js';
|
|
3
|
+
import { type RowScope } from '../../shared/rowScope.js';
|
|
4
|
+
/** Structured read arguments must not retain mutable values across driver
|
|
5
|
+
* waits. This is deliberately separate from stricter nonempty policy filters:
|
|
6
|
+
* an empty user filter is fine, because it never replaces the bound policy. */
|
|
7
|
+
export declare function snapshotScopedData<T>(input: T): T;
|
|
8
|
+
/** Dialect-independent policy binding. The driver only executes compiler output
|
|
9
|
+
* on its existing read handle; consumers never receive that execute function.
|
|
10
|
+
* Snapshot the trusted catalog too, so a later refresh cannot change the
|
|
11
|
+
* graph/columns against which this capability was bound — except a catalog
|
|
12
|
+
* `captureScopeCatalog` already detached and deeply froze, which nothing can
|
|
13
|
+
* change: a tenant source binds a reader per operation over one of those, and
|
|
14
|
+
* copying it each time cost milliseconds per read on a wide catalog.
|
|
15
|
+
*/
|
|
16
|
+
export declare function createScopedReads(catalog: DatabaseSchema, input: RowScope, style: SqlStyle,
|
|
17
|
+
/** Execution formatting only: it never changes the compiled statement or scope. */
|
|
18
|
+
execute: (statement: SqlFragment, hint?: {
|
|
19
|
+
binary?: true;
|
|
20
|
+
}) => Promise<QueryResult>,
|
|
21
|
+
/** A scoped write's own guards: a condition may compare as a foreign key does (`Condition.equality`). Never an App's reads. */
|
|
22
|
+
references?: boolean): ScopedReads;
|
|
@@ -0,0 +1,192 @@
|
|
|
1
|
+
import { buildWhere, clampLimit, orderClause, clampOffset, countStatement, Refusal, } from '../adapter.js';
|
|
2
|
+
import { findTable } from '../../shared/schema.js';
|
|
3
|
+
import { COUNT_EACH_MAX, countEachRows } from '../../shared/reads.js';
|
|
4
|
+
import { isCapturedScopeCatalog } from '../../shared/scopeCatalog.js';
|
|
5
|
+
import { ScopedRelations, snapshotRowScope } from '../../shared/rowScope.js';
|
|
6
|
+
import { compileView, compileViewCount } from '../../shared/view.js';
|
|
7
|
+
import { compileBreakdown, compileBreakdownCount } from '../../shared/breakdown.js';
|
|
8
|
+
import { compileAggregate } from '../../shared/aggregate.js';
|
|
9
|
+
import { readExactly, summed } from '../../shared/decimals.js';
|
|
10
|
+
import { RequestFault } from '../../shared/refusal.js';
|
|
11
|
+
import { storedTextOf, storedTextSelect } from './storedText.js';
|
|
12
|
+
/** Structured read arguments must not retain mutable values across driver
|
|
13
|
+
* waits. This is deliberately separate from stricter nonempty policy filters:
|
|
14
|
+
* an empty user filter is fine, because it never replaces the bound policy. */
|
|
15
|
+
export function snapshotScopedData(input) {
|
|
16
|
+
let nodes = 0;
|
|
17
|
+
let characters = 0;
|
|
18
|
+
let bytes = 0;
|
|
19
|
+
const fail = () => {
|
|
20
|
+
throw new Refusal('Invalid structured operation.');
|
|
21
|
+
};
|
|
22
|
+
const copy = (value, depth = 0) => {
|
|
23
|
+
if (++nodes > 32_768 || depth > 16)
|
|
24
|
+
return fail();
|
|
25
|
+
if (value === undefined || value === null || typeof value === 'boolean')
|
|
26
|
+
return value;
|
|
27
|
+
if (typeof value === 'string') {
|
|
28
|
+
characters += value.length;
|
|
29
|
+
if (characters > 1_048_576)
|
|
30
|
+
return fail();
|
|
31
|
+
return value;
|
|
32
|
+
}
|
|
33
|
+
if (typeof value === 'number' && Number.isFinite(value))
|
|
34
|
+
return value;
|
|
35
|
+
// A file's bytes: copied, and bounded as the characters are (the largest upload an App may accept).
|
|
36
|
+
if (value instanceof Uint8Array && (Object.getPrototypeOf(value) === Uint8Array.prototype || Buffer.isBuffer(value))) {
|
|
37
|
+
bytes += value.byteLength;
|
|
38
|
+
if (bytes > 26_214_400)
|
|
39
|
+
return fail();
|
|
40
|
+
return Buffer.from(value);
|
|
41
|
+
}
|
|
42
|
+
if (typeof value !== 'object')
|
|
43
|
+
return fail();
|
|
44
|
+
const array = Array.isArray(value);
|
|
45
|
+
const proto = Object.getPrototypeOf(value);
|
|
46
|
+
if (array ? proto !== Array.prototype : proto !== Object.prototype && proto !== null)
|
|
47
|
+
return fail();
|
|
48
|
+
const keys = Reflect.ownKeys(value);
|
|
49
|
+
if (keys.length > 8193)
|
|
50
|
+
return fail();
|
|
51
|
+
if (array) {
|
|
52
|
+
const length = Object.getOwnPropertyDescriptor(value, 'length')?.value;
|
|
53
|
+
if (!Number.isInteger(length) || length > 8192 || keys.length !== length + 1)
|
|
54
|
+
return fail();
|
|
55
|
+
const result = [];
|
|
56
|
+
for (let i = 0; i < length; i++) {
|
|
57
|
+
const descriptor = Object.getOwnPropertyDescriptor(value, String(i));
|
|
58
|
+
if (!descriptor || !descriptor.enumerable || !('value' in descriptor))
|
|
59
|
+
return fail();
|
|
60
|
+
result.push(copy(descriptor.value, depth + 1));
|
|
61
|
+
}
|
|
62
|
+
return result;
|
|
63
|
+
}
|
|
64
|
+
const result = Object.create(null);
|
|
65
|
+
for (const key of keys) {
|
|
66
|
+
const descriptor = Object.getOwnPropertyDescriptor(value, key);
|
|
67
|
+
if (typeof key !== 'string' || !descriptor.enumerable || !('value' in descriptor))
|
|
68
|
+
return fail();
|
|
69
|
+
characters += key.length;
|
|
70
|
+
if (characters > 1_048_576)
|
|
71
|
+
return fail();
|
|
72
|
+
result[key] = copy(descriptor.value, depth + 1);
|
|
73
|
+
}
|
|
74
|
+
return result;
|
|
75
|
+
};
|
|
76
|
+
return copy(input);
|
|
77
|
+
}
|
|
78
|
+
/** Dialect-independent policy binding. The driver only executes compiler output
|
|
79
|
+
* on its existing read handle; consumers never receive that execute function.
|
|
80
|
+
* Snapshot the trusted catalog too, so a later refresh cannot change the
|
|
81
|
+
* graph/columns against which this capability was bound — except a catalog
|
|
82
|
+
* `captureScopeCatalog` already detached and deeply froze, which nothing can
|
|
83
|
+
* change: a tenant source binds a reader per operation over one of those, and
|
|
84
|
+
* copying it each time cost milliseconds per read on a wide catalog.
|
|
85
|
+
*/
|
|
86
|
+
export function createScopedReads(catalog, input, style,
|
|
87
|
+
/** Execution formatting only: it never changes the compiled statement or scope. */
|
|
88
|
+
execute,
|
|
89
|
+
/** A scoped write's own guards: a condition may compare as a foreign key does (`Condition.equality`). Never an App's reads. */
|
|
90
|
+
references = false) {
|
|
91
|
+
const schema = isCapturedScopeCatalog(catalog) ? catalog : structuredClone(catalog);
|
|
92
|
+
const scope = snapshotRowScope(schema, input);
|
|
93
|
+
const tableFor = (id) => {
|
|
94
|
+
const table = findTable(schema, id);
|
|
95
|
+
if (!table)
|
|
96
|
+
throw new Refusal('Unknown resource in scoped read.');
|
|
97
|
+
return table;
|
|
98
|
+
};
|
|
99
|
+
const from = (id, filter) => {
|
|
100
|
+
const table = tableFor(id);
|
|
101
|
+
const column = (name) => {
|
|
102
|
+
if (!table.columns.some((column) => column.name === name))
|
|
103
|
+
throw new RequestFault('Unknown column in scoped read.');
|
|
104
|
+
return style.quote(name);
|
|
105
|
+
};
|
|
106
|
+
const relations = new ScopedRelations(schema, style, scope);
|
|
107
|
+
const relation = relations.table(id);
|
|
108
|
+
const prefix = relations.finish();
|
|
109
|
+
const where = buildWhere(filter, style, prefix.params.length + 1, column, undefined, undefined, undefined, references);
|
|
110
|
+
return { table, column, relation, prefix, where, params: [...prefix.params, ...where.params] };
|
|
111
|
+
};
|
|
112
|
+
/* A SQLite sum that cannot be exact says so in its cell (decimals.ts); PostgreSQL's numeric always is. */
|
|
113
|
+
const exact = (run, measures) => (style.dialect === 'sqlite' ? readExactly(run, summed(measures)) : run());
|
|
114
|
+
const counted = async (statement) => {
|
|
115
|
+
const result = await execute(statement);
|
|
116
|
+
return Number(result.rows[0]?.n ?? 0);
|
|
117
|
+
};
|
|
118
|
+
return Object.freeze({
|
|
119
|
+
async query(input) {
|
|
120
|
+
const request = snapshotScopedData(input);
|
|
121
|
+
const plan = from(request.table, request.filter);
|
|
122
|
+
const names = request.columns?.length ? request.columns : plan.table.columns.map((column) => column.name);
|
|
123
|
+
const columns = names.map(plan.column);
|
|
124
|
+
// A scoped write's own read: its reference columns' stored text too, as one more column (storedText.ts).
|
|
125
|
+
const texts = request.storedText ? storedTextOf(schema, plan.table) : undefined;
|
|
126
|
+
if (texts)
|
|
127
|
+
columns.push(`${storedTextSelect(texts.columns, (name) => style.quote(name))} AS ${style.quote(texts.alias)}`);
|
|
128
|
+
const order = orderClause(request.orderBy, plan.table, style, plan.params.length + 1, plan.column);
|
|
129
|
+
const n = plan.params.length + order.params.length;
|
|
130
|
+
const text = `${plan.prefix.text}SELECT ${columns.join(', ')} FROM ${plan.relation}${plan.where.text}${order.text}` +
|
|
131
|
+
` LIMIT ${style.placeholder(n + 1)} OFFSET ${style.placeholder(n + 2)}`;
|
|
132
|
+
const result = await execute({ text, params: [...plan.params, ...order.params, clampLimit(request.limit), clampOffset(request.offset)] }, request.binary ? { binary: true } : undefined);
|
|
133
|
+
return { ...result, columns: [...names] };
|
|
134
|
+
},
|
|
135
|
+
async count(table, filter, limit) {
|
|
136
|
+
const plan = from(table, snapshotScopedData(filter));
|
|
137
|
+
// One plan either way: a bound wraps the scoped relation, never replaces it.
|
|
138
|
+
return counted({ text: `${plan.prefix.text}${countStatement(`${plan.relation}${plan.where.text}`, limit)}`, params: plan.params });
|
|
139
|
+
},
|
|
140
|
+
/* Several tables' counts, each under its own scope and filter, as one
|
|
141
|
+
statement: the scope's CTEs are defined once, ahead of one bounded
|
|
142
|
+
count per item joined by UNION ALL. Each branch reads the relation
|
|
143
|
+
`count` would, so no item sees a row its own count would not. */
|
|
144
|
+
async countEach(items, limit) {
|
|
145
|
+
const given = snapshotScopedData(items);
|
|
146
|
+
if (!given.length || given.length > COUNT_EACH_MAX)
|
|
147
|
+
throw new Refusal(`One statement counts 1 to ${COUNT_EACH_MAX} things.`);
|
|
148
|
+
const relations = new ScopedRelations(schema, style, scope);
|
|
149
|
+
const planned = given.map((item) => {
|
|
150
|
+
const table = tableFor(item.table);
|
|
151
|
+
const column = (name) => {
|
|
152
|
+
if (!table.columns.some((column) => column.name === name))
|
|
153
|
+
throw new RequestFault('Unknown column in scoped read.');
|
|
154
|
+
return style.quote(name);
|
|
155
|
+
};
|
|
156
|
+
return { relation: relations.table(item.table), column, filter: item.filter };
|
|
157
|
+
});
|
|
158
|
+
const prefix = relations.finish();
|
|
159
|
+
const params = [...prefix.params];
|
|
160
|
+
const branches = planned.map(({ relation, column, filter }, i) => {
|
|
161
|
+
const where = buildWhere(filter, style, params.length + 1, column);
|
|
162
|
+
params.push(...where.params);
|
|
163
|
+
const counted = countStatement(`${relation}${where.text}`, limit);
|
|
164
|
+
return counted.replace(/^SELECT COUNT\(\*\) AS n/, `SELECT ${i} AS i, COUNT(*) AS n`);
|
|
165
|
+
});
|
|
166
|
+
const result = await execute({ text: `${prefix.text}${branches.join('\nUNION ALL\n')}`, params });
|
|
167
|
+
return countEachRows(result.rows, given.length);
|
|
168
|
+
},
|
|
169
|
+
async runView(view, offset = 0) {
|
|
170
|
+
const compiled = compileView(schema, snapshotScopedData(view), style, offset, scope);
|
|
171
|
+
const result = await execute(compiled);
|
|
172
|
+
return { ...result, columns: compiled.columns.map((column) => column.name), resolved: compiled.columns, joins: compiled.joins };
|
|
173
|
+
},
|
|
174
|
+
async countView(view, limit) {
|
|
175
|
+
return counted(compileViewCount(schema, snapshotScopedData(view), style, scope, limit));
|
|
176
|
+
},
|
|
177
|
+
async runBreakdown(breakdown, offset = 0) {
|
|
178
|
+
const compiled = compileBreakdown(schema, snapshotScopedData(breakdown), style, offset, scope);
|
|
179
|
+
const result = await exact(() => execute(compiled), breakdown.measures);
|
|
180
|
+
return { ...result, columns: compiled.columns.map((column) => column.name), resolved: compiled.columns };
|
|
181
|
+
},
|
|
182
|
+
async countBreakdown(breakdown, limit) {
|
|
183
|
+
return counted(compileBreakdownCount(schema, snapshotScopedData(breakdown), style, scope, limit));
|
|
184
|
+
},
|
|
185
|
+
/* The base table read through the scope's relation, as `count` reads it, and nothing else: an aggregate names
|
|
186
|
+
only its table's own columns (aggregate.ts), so no other table's relation is planned at all. */
|
|
187
|
+
async aggregate(request) {
|
|
188
|
+
const compiled = compileAggregate(schema, snapshotScopedData(request), style, 0, scope);
|
|
189
|
+
return { rows: (await exact(() => execute(compiled), request.measures)).rows };
|
|
190
|
+
},
|
|
191
|
+
});
|
|
192
|
+
}
|