@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,264 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* The guard a caller can put in front of raw SQL: a statement that touches
|
|
3
|
+
* tablewalk's own runtime tables (the `__mistri_` prefix on every engine, and
|
|
4
|
+
* PostgreSQL's runtime schema, shared/runtimeTables.ts) is refused before it
|
|
5
|
+
* runs. The MCP `sql` and `explain` tools ask for it.
|
|
6
|
+
*
|
|
7
|
+
* This file is the lexical half, and it is conservative on purpose. It reads
|
|
8
|
+
* every identifier, quoted or not, every string and every comment, and
|
|
9
|
+
* refuses when one of them spells a reserved name — a string can become a
|
|
10
|
+
* relation through a cast. It refuses the constructs that reach a relation whose name is
|
|
11
|
+
* only computed when the statement runs (regclass casts, the functions that
|
|
12
|
+
* run SQL text they are handed), and escapes it will not decode, because a
|
|
13
|
+
* guard that cannot read a statement should not wave it through. The engine
|
|
14
|
+
* half lives in the adapters: SQLite's authorizer and Postgres's plan both
|
|
15
|
+
* name the relations a statement actually reads, views and search_path
|
|
16
|
+
* included, which no reading of the text can.
|
|
17
|
+
*
|
|
18
|
+
* Not a sandbox. A function the database's own users wrote reads what its
|
|
19
|
+
* owner may; the database role is the boundary for that.
|
|
20
|
+
*/
|
|
21
|
+
import { isRuntimeTable, RUNTIME_SCHEMA, RUNTIME_TABLE_PREFIXES } from '../shared/runtimeTables.js';
|
|
22
|
+
import { looksWrappable, Refusal, trimStatement } from './adapter.js';
|
|
23
|
+
/* PostgreSQL keeps every runtime table, sign-in's included, in one schema
|
|
24
|
+
(shared/runtimeTables.ts): never listed, not even when `--schema` names it,
|
|
25
|
+
and refused as a generic write target. The prefix rule cannot say this,
|
|
26
|
+
because the tables inside are named plainly (`command`, `auth_user`); the
|
|
27
|
+
schema does. The name is the engine's, not an import of a store: the engine
|
|
28
|
+
hides it in a database the browser opens with no App framework installed. */
|
|
29
|
+
export const RESERVED_SCHEMAS = [RUNTIME_SCHEMA];
|
|
30
|
+
/** Whether a relation, as the engine names it, is tablewalk's own. */
|
|
31
|
+
export function isReservedRelation(schema, name) {
|
|
32
|
+
return isRuntimeTable(name) || (schema !== undefined && RESERVED_SCHEMAS.includes(schema.toLowerCase()));
|
|
33
|
+
}
|
|
34
|
+
/** The refusal for a statement found to touch `name`, by whichever half found it. */
|
|
35
|
+
export function reservedRefusal(name) {
|
|
36
|
+
return new Refusal(`This statement touches "${name}", one of the runtime or sign-in tables ` +
|
|
37
|
+
`(the reserved ${RUNTIME_TABLE_PREFIXES.join(' and ')} prefix and the ${RESERVED_SCHEMAS.join(', ')} schema), which raw SQL here does not read.`);
|
|
38
|
+
}
|
|
39
|
+
/* Postgres names that reach a relation only when the statement runs: a
|
|
40
|
+
regclass cast turns any text or number into a table, and these functions
|
|
41
|
+
run the SQL text, or read the relation, they are handed. `table_to_xml`
|
|
42
|
+
takes a bare oid, so there is not even a name to read. */
|
|
43
|
+
const COMPUTED_RELATION = /^(?:regclass|to_regclass|\w*_to_xml\w*|ts_stat|dblink\w*|crosstab\d*|connectby|get_raw_page)$/i;
|
|
44
|
+
/**
|
|
45
|
+
* The statement's words, quoted identifiers and texts (strings, dollar
|
|
46
|
+
* bodies, comments), in order — or the reason it cannot be read.
|
|
47
|
+
*/
|
|
48
|
+
function tokenize(sql, dialect) {
|
|
49
|
+
const tokens = [];
|
|
50
|
+
const n = sql.length;
|
|
51
|
+
let i = 0;
|
|
52
|
+
/* A quoted run with its closing character doubled as the escape. A
|
|
53
|
+
backslash escape (Postgres's E'…') can only make the run longer when read
|
|
54
|
+
as one, which the text check still reads. */
|
|
55
|
+
const quoted = (close, backslash) => {
|
|
56
|
+
let value = '';
|
|
57
|
+
i += 1;
|
|
58
|
+
while (i < n) {
|
|
59
|
+
const ch = sql[i];
|
|
60
|
+
if (backslash && ch === '\\' && i + 1 < n) {
|
|
61
|
+
value += sql[i + 1];
|
|
62
|
+
i += 2;
|
|
63
|
+
continue;
|
|
64
|
+
}
|
|
65
|
+
if (ch === close && sql[i + 1] === close) {
|
|
66
|
+
value += close;
|
|
67
|
+
i += 2;
|
|
68
|
+
continue;
|
|
69
|
+
}
|
|
70
|
+
if (ch === close) {
|
|
71
|
+
i += 1;
|
|
72
|
+
break;
|
|
73
|
+
}
|
|
74
|
+
value += ch;
|
|
75
|
+
i += 1;
|
|
76
|
+
}
|
|
77
|
+
return value;
|
|
78
|
+
};
|
|
79
|
+
while (i < n) {
|
|
80
|
+
const ch = sql[i];
|
|
81
|
+
const next = sql[i + 1];
|
|
82
|
+
if (/\s/.test(ch)) {
|
|
83
|
+
i += 1;
|
|
84
|
+
continue;
|
|
85
|
+
}
|
|
86
|
+
if (ch === '-' && next === '-') {
|
|
87
|
+
const end = sql.indexOf('\n', i);
|
|
88
|
+
tokens.push({ kind: 'text', value: sql.slice(i, end < 0 ? n : end) });
|
|
89
|
+
i = end < 0 ? n : end + 1;
|
|
90
|
+
continue;
|
|
91
|
+
}
|
|
92
|
+
if (ch === '/' && next === '*') {
|
|
93
|
+
/* Postgres nests block comments; the others end at the first close. */
|
|
94
|
+
let depth = 0;
|
|
95
|
+
const start = i;
|
|
96
|
+
while (i < n) {
|
|
97
|
+
if (sql[i] === '/' && sql[i + 1] === '*') {
|
|
98
|
+
depth += 1;
|
|
99
|
+
i += 2;
|
|
100
|
+
continue;
|
|
101
|
+
}
|
|
102
|
+
if (sql[i] === '*' && sql[i + 1] === '/') {
|
|
103
|
+
depth -= 1;
|
|
104
|
+
i += 2;
|
|
105
|
+
if (depth === 0 || dialect !== 'postgres')
|
|
106
|
+
break;
|
|
107
|
+
continue;
|
|
108
|
+
}
|
|
109
|
+
i += 1;
|
|
110
|
+
}
|
|
111
|
+
tokens.push({ kind: 'text', value: sql.slice(start, i) });
|
|
112
|
+
continue;
|
|
113
|
+
}
|
|
114
|
+
if (ch === '$' && dialect === 'postgres') {
|
|
115
|
+
const tag = /^\$[A-Za-z_]\w*\$|^\$\$/.exec(sql.slice(i))?.[0];
|
|
116
|
+
if (tag) {
|
|
117
|
+
const end = sql.indexOf(tag, i + tag.length);
|
|
118
|
+
tokens.push({ kind: 'text', value: sql.slice(i + tag.length, end < 0 ? n : end) });
|
|
119
|
+
i = end < 0 ? n : end + tag.length;
|
|
120
|
+
continue;
|
|
121
|
+
}
|
|
122
|
+
}
|
|
123
|
+
if (dialect === 'postgres' && /^u&["']/i.test(sql.slice(i, i + 3))) {
|
|
124
|
+
/* A Unicode-escaped identifier or string spells a name in code points
|
|
125
|
+
this check does not decode; one without escapes reads as it is. */
|
|
126
|
+
i += 2;
|
|
127
|
+
const close = sql[i];
|
|
128
|
+
const value = quoted(close, false);
|
|
129
|
+
if (value.includes('\\') || /^\s*uescape\b/i.test(sql.slice(i))) {
|
|
130
|
+
return ('This statement spells a name with Unicode escapes (U&"…"), which the reserved-table check does not decode, ' +
|
|
131
|
+
'so it is refused rather than run. Spell the name plainly.');
|
|
132
|
+
}
|
|
133
|
+
tokens.push({ kind: close === '"' ? 'quoted' : 'text', value });
|
|
134
|
+
continue;
|
|
135
|
+
}
|
|
136
|
+
if (ch === "'") {
|
|
137
|
+
/* E'…' is Postgres's backslash-escaped string. */
|
|
138
|
+
const escaped = dialect === 'postgres' && /[eE]$/.test(sql.slice(Math.max(0, i - 1), i));
|
|
139
|
+
tokens.push({ kind: 'text', value: quoted("'", escaped) });
|
|
140
|
+
continue;
|
|
141
|
+
}
|
|
142
|
+
if (ch === '"') {
|
|
143
|
+
tokens.push({ kind: 'quoted', value: quoted('"', false) });
|
|
144
|
+
continue;
|
|
145
|
+
}
|
|
146
|
+
if (ch === '`' && dialect !== 'postgres') {
|
|
147
|
+
tokens.push({ kind: 'quoted', value: quoted('`', false) });
|
|
148
|
+
continue;
|
|
149
|
+
}
|
|
150
|
+
if (ch === '[' && dialect === 'sqlite') {
|
|
151
|
+
tokens.push({ kind: 'quoted', value: quoted(']', false) });
|
|
152
|
+
continue;
|
|
153
|
+
}
|
|
154
|
+
const word = /^[A-Za-z_-][\w$-]*/.exec(sql.slice(i))?.[0];
|
|
155
|
+
if (word) {
|
|
156
|
+
tokens.push({ kind: 'word', value: word });
|
|
157
|
+
i += word.length;
|
|
158
|
+
continue;
|
|
159
|
+
}
|
|
160
|
+
i += 1;
|
|
161
|
+
}
|
|
162
|
+
return tokens;
|
|
163
|
+
}
|
|
164
|
+
// A match in text (a comment, a string)
|
|
165
|
+
// takes the rest of the name, so the refusal names the table, not the prefix.
|
|
166
|
+
const RESERVED_TEXT = new RegExp(`(?:${RUNTIME_TABLE_PREFIXES.join('|')})[\\w$]*|\\b(?:${RESERVED_SCHEMAS.join('|')})\\b`, 'i');
|
|
167
|
+
/**
|
|
168
|
+
* Why this statement must not run under the guard, or null when nothing in
|
|
169
|
+
* its text reaches a reserved relation.
|
|
170
|
+
*/
|
|
171
|
+
export function reservedInText(sql, dialect) {
|
|
172
|
+
const tokens = tokenize(sql, dialect);
|
|
173
|
+
if (typeof tokens === 'string')
|
|
174
|
+
return tokens;
|
|
175
|
+
for (const token of tokens) {
|
|
176
|
+
if (token.kind === 'text') {
|
|
177
|
+
const found = RESERVED_TEXT.exec(token.value);
|
|
178
|
+
if (found)
|
|
179
|
+
return reservedRefusal(found[0]).message;
|
|
180
|
+
continue;
|
|
181
|
+
}
|
|
182
|
+
const name = token.value;
|
|
183
|
+
if (isRuntimeTable(name) || (dialect === 'postgres' && RESERVED_SCHEMAS.includes(name.toLowerCase()))) {
|
|
184
|
+
return reservedRefusal(name).message;
|
|
185
|
+
}
|
|
186
|
+
if (dialect === 'postgres' && COMPUTED_RELATION.test(name)) {
|
|
187
|
+
return (`This statement uses ${name}, which reaches a relation by a name computed when it runs, so it is refused ` +
|
|
188
|
+
`rather than run: raw SQL here does not read the runtime or sign-in tables, and a name ` +
|
|
189
|
+
'that is not written down cannot be checked.');
|
|
190
|
+
}
|
|
191
|
+
}
|
|
192
|
+
return null;
|
|
193
|
+
}
|
|
194
|
+
/** @throws Refusal when the statement's text reaches a reserved relation. */
|
|
195
|
+
export function refuseReservedText(sql, dialect) {
|
|
196
|
+
const reason = reservedInText(sql, dialect);
|
|
197
|
+
if (reason)
|
|
198
|
+
throw new Refusal(reason);
|
|
199
|
+
}
|
|
200
|
+
/**
|
|
201
|
+
* The Postgres check before a statement is given a connection: its text,
|
|
202
|
+
* and for a read, whether the planner can list what it reads — the engine
|
|
203
|
+
* half below needs a plan, so a statement the planner cannot explain is
|
|
204
|
+
* refused rather than run unchecked.
|
|
205
|
+
*/
|
|
206
|
+
export function refusePostgresReserved(sql, write = false) {
|
|
207
|
+
refuseReservedText(sql, 'postgres');
|
|
208
|
+
if (!write && !looksWrappable(sql)) {
|
|
209
|
+
throw new Refusal("The reserved-table check reads the planner's list of what a statement scans, so it " +
|
|
210
|
+
'runs the statements the planner can explain: SELECT, WITH, TABLE and VALUES.');
|
|
211
|
+
}
|
|
212
|
+
}
|
|
213
|
+
/**
|
|
214
|
+
* The Postgres engine half: the planner's own list of what a statement
|
|
215
|
+
* scans, read inside the transaction it will run in, so views, search_path
|
|
216
|
+
* and CTEs resolve as they will there.
|
|
217
|
+
*/
|
|
218
|
+
export async function refuseReservedPlan(db, sql, params) {
|
|
219
|
+
/* On the extended protocol even with no parameters: on the simple one,
|
|
220
|
+
Postgres would run a statement stacked behind the EXPLAIN before any
|
|
221
|
+
plan came back to read. */
|
|
222
|
+
const planned = await db.query({
|
|
223
|
+
text: `EXPLAIN (VERBOSE, FORMAT JSON) ${trimStatement(sql)}`,
|
|
224
|
+
values: params,
|
|
225
|
+
rowMode: 'array',
|
|
226
|
+
queryMode: 'extended',
|
|
227
|
+
});
|
|
228
|
+
const found = reservedInPlan(planned.rows[0]?.[0]);
|
|
229
|
+
if (found)
|
|
230
|
+
throw reservedRefusal(found);
|
|
231
|
+
}
|
|
232
|
+
/**
|
|
233
|
+
* The first reserved relation a Postgres `EXPLAIN (VERBOSE, FORMAT JSON)`
|
|
234
|
+
* plan reads. The plan is the planner's list of what the statement will
|
|
235
|
+
* actually scan — views expanded, search_path resolved, CTEs and subqueries
|
|
236
|
+
* included. What a function reads by a computed name is not in it; the
|
|
237
|
+
* lexical half refuses those functions by name.
|
|
238
|
+
*/
|
|
239
|
+
export function reservedInPlan(plan) {
|
|
240
|
+
if (Array.isArray(plan)) {
|
|
241
|
+
for (const item of plan) {
|
|
242
|
+
const found = reservedInPlan(item);
|
|
243
|
+
if (found)
|
|
244
|
+
return found;
|
|
245
|
+
}
|
|
246
|
+
return null;
|
|
247
|
+
}
|
|
248
|
+
if (!plan || typeof plan !== 'object')
|
|
249
|
+
return null;
|
|
250
|
+
const node = plan;
|
|
251
|
+
const relation = node['Relation Name'];
|
|
252
|
+
const schema = typeof node.Schema === 'string' ? node.Schema : undefined;
|
|
253
|
+
if (typeof relation === 'string' && isReservedRelation(schema, relation)) {
|
|
254
|
+
return schema ? `${schema}.${relation}` : relation;
|
|
255
|
+
}
|
|
256
|
+
for (const value of Object.values(node)) {
|
|
257
|
+
if (value && typeof value === 'object') {
|
|
258
|
+
const found = reservedInPlan(value);
|
|
259
|
+
if (found)
|
|
260
|
+
return found;
|
|
261
|
+
}
|
|
262
|
+
}
|
|
263
|
+
return null;
|
|
264
|
+
}
|
|
@@ -0,0 +1,17 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* A database role's reach beyond reading, behind `Adapter.privileges`: one
|
|
3
|
+
* catalog query on PostgreSQL. Every read runs
|
|
4
|
+
* in a read-only transaction, which holds for everything tablewalk sends but
|
|
5
|
+
* not for a superuser (`COPY … TO PROGRAM` is a read); the role is the
|
|
6
|
+
* boundary that always holds, so the registry says when it is wider than a
|
|
7
|
+
* read-only connection.
|
|
8
|
+
*/
|
|
9
|
+
import type { RolePrivileges } from './adapter.js';
|
|
10
|
+
type Reader = {
|
|
11
|
+
query(text: string, params?: unknown[]): Promise<{
|
|
12
|
+
rows: unknown[];
|
|
13
|
+
}>;
|
|
14
|
+
};
|
|
15
|
+
/** Superuser, write grants on the browsed tables, CREATE in a browsed schema. */
|
|
16
|
+
export declare function postgresPrivileges(db: Reader, browsed: readonly string[], system: readonly string[]): Promise<RolePrivileges>;
|
|
17
|
+
export {};
|
|
@@ -0,0 +1,22 @@
|
|
|
1
|
+
import { RESERVED_SCHEMAS } from './reservedSql.js';
|
|
2
|
+
import { notExtensionMember } from './postgresCatalog.js';
|
|
3
|
+
/** Superuser, write grants on the browsed tables, CREATE in a browsed schema. */
|
|
4
|
+
export async function postgresPrivileges(db, browsed, system) {
|
|
5
|
+
const schemas = browsed.length ? browsed.filter((schema) => !RESERVED_SCHEMAS.includes(schema)) : [...system, ...RESERVED_SCHEMAS];
|
|
6
|
+
// Temporary and toast namespaces are the session's own, not the database's.
|
|
7
|
+
const within = `${browsed.length ? 'n.nspname = ANY($1)' : 'n.nspname <> ALL($1)'} AND n.nspname NOT LIKE 'pg\\_%'`;
|
|
8
|
+
const { rows } = await db.query(`SELECT r.rolsuper AS superuser,
|
|
9
|
+
(SELECT count(*)::int FROM pg_class c JOIN pg_namespace n ON n.oid = c.relnamespace
|
|
10
|
+
WHERE c.relkind IN ('r', 'p') AND ${notExtensionMember('c')} AND ${within}
|
|
11
|
+
AND (has_table_privilege(c.oid, 'INSERT') OR has_table_privilege(c.oid, 'UPDATE')
|
|
12
|
+
OR has_table_privilege(c.oid, 'DELETE') OR has_table_privilege(c.oid, 'TRUNCATE'))) AS writable,
|
|
13
|
+
EXISTS (SELECT 1 FROM pg_namespace n WHERE ${within} AND has_schema_privilege(n.oid, 'CREATE')) AS can_create
|
|
14
|
+
FROM pg_roles r WHERE r.rolname = current_user`, [schemas]);
|
|
15
|
+
const row = rows[0] ?? {};
|
|
16
|
+
const writable = Number(row.writable ?? 0);
|
|
17
|
+
return {
|
|
18
|
+
superuser: row.superuser === true,
|
|
19
|
+
create: row.can_create === true,
|
|
20
|
+
writes: writable ? [`INSERT/UPDATE/DELETE on ${writable} table${writable === 1 ? '' : 's'}`] : [],
|
|
21
|
+
};
|
|
22
|
+
}
|
|
@@ -0,0 +1,65 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* A record's row, read once in full through the row scope by its key, and
|
|
3
|
+
* every later read of that record by the same key, in the same transaction
|
|
4
|
+
* and under the same scope, answered from it: the columns it asks for, in its
|
|
5
|
+
* order, from the row already read.
|
|
6
|
+
*
|
|
7
|
+
* A command reads its target by key several times before it writes — whether
|
|
8
|
+
* it is visible, its revision, the columns its machine moves, the before image
|
|
9
|
+
* its audit keeps, the guard the write checks — each a round trip of its own,
|
|
10
|
+
* each the same row. Read under the row lock the transaction takes first
|
|
11
|
+
* (postgres.ts sends both ahead, behind its BEGIN), the row cannot move
|
|
12
|
+
* underneath it, and a row scope's visibility is decided by the row's own
|
|
13
|
+
* columns (shared/rowScope.ts), so the projection is what each read would
|
|
14
|
+
* have answered.
|
|
15
|
+
*
|
|
16
|
+
* Only while the transaction has sent nothing that could change it: a row is
|
|
17
|
+
* kept with the transaction's statement generation (postgresTransactionHandle
|
|
18
|
+
* generationOf), which moves with every statement that is not a read or a
|
|
19
|
+
* lock — its own write, a savepoint, a rollback, a failure — and a row kept
|
|
20
|
+
* under an older generation answers nothing. Only reads that name the
|
|
21
|
+
* table's primary key by equality, from the first row, with no order, are
|
|
22
|
+
* answered; anything else is asked in its turn. A read that also names other
|
|
23
|
+
* columns by equality (a guard: the record, and only in the state it moves
|
|
24
|
+
* from) is answered only where the kept row holds exactly the value asked,
|
|
25
|
+
* identical in type and content: identical values are equal under any
|
|
26
|
+
* collation or type the server compares them by, so that answer is the
|
|
27
|
+
* server's. Where they differ (a numeric's text, a citext's case, a bytea),
|
|
28
|
+
* the read is asked in its turn rather than answered with no row.
|
|
29
|
+
*/
|
|
30
|
+
import { type Filter, type QueryRequest, type ScopedReads, type SqlFragment } from '../adapter.js';
|
|
31
|
+
import type { DatabaseSchema, TableMeta } from '../../shared/schema.js';
|
|
32
|
+
import type { RowScope } from '../../shared/rowScope.js';
|
|
33
|
+
type Row = Record<string, unknown>;
|
|
34
|
+
type Reads = Pick<ScopedReads, 'query'> & Partial<ScopedReads>;
|
|
35
|
+
export declare class KeyRows {
|
|
36
|
+
#private;
|
|
37
|
+
/** The transaction's statement generation now; undefined where it has none (nothing is kept). */
|
|
38
|
+
private readonly generation;
|
|
39
|
+
constructor(
|
|
40
|
+
/** The transaction's statement generation now; undefined where it has none (nothing is kept). */
|
|
41
|
+
generation: () => number | undefined);
|
|
42
|
+
/** Keep nothing more and answer nothing from what was kept (the catalog the rows were read under is not the transaction's). */
|
|
43
|
+
forget(): void;
|
|
44
|
+
/** Keep the rows a full read of `table` by its key will answer (`rows`, the driver's own, unconverted). */
|
|
45
|
+
keep(scope: RowScope, table: TableMeta, filter: Filter, rows: Promise<readonly Row[]>, take?: () => void): void;
|
|
46
|
+
/**
|
|
47
|
+
* `reads`, with every read by key answered from a kept row where one is
|
|
48
|
+
* kept. `statementOf` says the statement the read would have sent (its
|
|
49
|
+
* `sql`); `format` turns a driver row into the read's own (binary or not, as
|
|
50
|
+
* the read's executor would). With `keeps`, a full read by key that is asked
|
|
51
|
+
* in its turn is kept for those after it (a guard's read: its rows are the
|
|
52
|
+
* driver's own). With `widen`, a read by key of a row the transaction holds
|
|
53
|
+
* locked (`held`), with nothing kept of it since the transaction last
|
|
54
|
+
* changed something, is sent as a full read through `widen.reads` (whose
|
|
55
|
+
* rows are the driver's own) and kept, and answered from it: the row cannot
|
|
56
|
+
* move while the lock is held, so the reads of it that follow — the guard
|
|
57
|
+
* reads of the write it is read for — are answered from it too, rather
|
|
58
|
+
* than each asked in its turn.
|
|
59
|
+
*/
|
|
60
|
+
over<R extends Reads>(reads: R, scope: RowScope, schema: DatabaseSchema, statementOf: (request: QueryRequest) => SqlFragment | undefined, format: (row: Row, request: QueryRequest) => Row, keeps: boolean, widen?: {
|
|
61
|
+
held(table: TableMeta, key: Readonly<Record<string, string | number>>): boolean;
|
|
62
|
+
reads: Pick<ScopedReads, 'query'>;
|
|
63
|
+
}): R;
|
|
64
|
+
}
|
|
65
|
+
export {};
|
|
@@ -0,0 +1,179 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* A record's row, read once in full through the row scope by its key, and
|
|
3
|
+
* every later read of that record by the same key, in the same transaction
|
|
4
|
+
* and under the same scope, answered from it: the columns it asks for, in its
|
|
5
|
+
* order, from the row already read.
|
|
6
|
+
*
|
|
7
|
+
* A command reads its target by key several times before it writes — whether
|
|
8
|
+
* it is visible, its revision, the columns its machine moves, the before image
|
|
9
|
+
* its audit keeps, the guard the write checks — each a round trip of its own,
|
|
10
|
+
* each the same row. Read under the row lock the transaction takes first
|
|
11
|
+
* (postgres.ts sends both ahead, behind its BEGIN), the row cannot move
|
|
12
|
+
* underneath it, and a row scope's visibility is decided by the row's own
|
|
13
|
+
* columns (shared/rowScope.ts), so the projection is what each read would
|
|
14
|
+
* have answered.
|
|
15
|
+
*
|
|
16
|
+
* Only while the transaction has sent nothing that could change it: a row is
|
|
17
|
+
* kept with the transaction's statement generation (postgresTransactionHandle
|
|
18
|
+
* generationOf), which moves with every statement that is not a read or a
|
|
19
|
+
* lock — its own write, a savepoint, a rollback, a failure — and a row kept
|
|
20
|
+
* under an older generation answers nothing. Only reads that name the
|
|
21
|
+
* table's primary key by equality, from the first row, with no order, are
|
|
22
|
+
* answered; anything else is asked in its turn. A read that also names other
|
|
23
|
+
* columns by equality (a guard: the record, and only in the state it moves
|
|
24
|
+
* from) is answered only where the kept row holds exactly the value asked,
|
|
25
|
+
* identical in type and content: identical values are equal under any
|
|
26
|
+
* collation or type the server compares them by, so that answer is the
|
|
27
|
+
* server's. Where they differ (a numeric's text, a citext's case, a bytea),
|
|
28
|
+
* the read is asked in its turn rather than answered with no row.
|
|
29
|
+
*/
|
|
30
|
+
import { clampLimit } from '../adapter.js';
|
|
31
|
+
import { storedTextOf } from './storedText.js';
|
|
32
|
+
export class KeyRows {
|
|
33
|
+
generation;
|
|
34
|
+
#entries = new Map();
|
|
35
|
+
#scopes = new WeakMap();
|
|
36
|
+
#next = 0;
|
|
37
|
+
constructor(
|
|
38
|
+
/** The transaction's statement generation now; undefined where it has none (nothing is kept). */
|
|
39
|
+
generation) {
|
|
40
|
+
this.generation = generation;
|
|
41
|
+
}
|
|
42
|
+
/** Keep nothing more and answer nothing from what was kept (the catalog the rows were read under is not the transaction's). */
|
|
43
|
+
forget() {
|
|
44
|
+
this.#entries.clear();
|
|
45
|
+
}
|
|
46
|
+
#scope(scope) {
|
|
47
|
+
let id = this.#scopes.get(scope);
|
|
48
|
+
if (id === undefined)
|
|
49
|
+
this.#scopes.set(scope, (id = this.#next++));
|
|
50
|
+
return id;
|
|
51
|
+
}
|
|
52
|
+
/** The key a read of `table` by `filter` is kept under: undefined unless the filter is exactly the primary key by equality. */
|
|
53
|
+
#keyOf(scope, table, filter) {
|
|
54
|
+
const found = this.#guarded(scope, table, filter);
|
|
55
|
+
return found && !found.also.length ? found.key : undefined;
|
|
56
|
+
}
|
|
57
|
+
/** The key of a read by the primary key by equality, and the other columns it names by equality (`also`). */
|
|
58
|
+
#guarded(scope, table, filter) {
|
|
59
|
+
const pk = table.columns.filter((column) => column.primaryKey).map((column) => column.name);
|
|
60
|
+
const group = filter?.groups.length === 1 ? filter.groups[0] : undefined;
|
|
61
|
+
if (!pk.length || !group || group.length < pk.length)
|
|
62
|
+
return undefined;
|
|
63
|
+
const values = {};
|
|
64
|
+
const also = [];
|
|
65
|
+
for (const condition of group) {
|
|
66
|
+
if (condition.op !== '=' || Object.keys(condition).length !== 3)
|
|
67
|
+
return undefined;
|
|
68
|
+
if (pk.includes(condition.column)) {
|
|
69
|
+
if (typeof condition.value !== 'string' && typeof condition.value !== 'number')
|
|
70
|
+
return undefined;
|
|
71
|
+
if (Object.hasOwn(values, condition.column))
|
|
72
|
+
return undefined;
|
|
73
|
+
values[condition.column] = condition.value;
|
|
74
|
+
continue;
|
|
75
|
+
}
|
|
76
|
+
const column = table.columns.find((candidate) => candidate.name === condition.column);
|
|
77
|
+
// json has no equality operator: the server refuses that read, so it is sent for the server to say so.
|
|
78
|
+
if (!column || /^json$/i.test(column.type))
|
|
79
|
+
return undefined;
|
|
80
|
+
if (typeof condition.value !== 'string' && typeof condition.value !== 'number' && typeof condition.value !== 'boolean')
|
|
81
|
+
return undefined;
|
|
82
|
+
also.push({ column: condition.column, value: condition.value });
|
|
83
|
+
}
|
|
84
|
+
if (Object.keys(values).length !== pk.length)
|
|
85
|
+
return undefined;
|
|
86
|
+
return { key: JSON.stringify([this.#scope(scope), table.id, pk.map((column) => values[column])]), values, also };
|
|
87
|
+
}
|
|
88
|
+
/** Keep the rows a full read of `table` by its key will answer (`rows`, the driver's own, unconverted). */
|
|
89
|
+
keep(scope, table, filter, rows, take) {
|
|
90
|
+
const generation = this.generation(), key = this.#keyOf(scope, table, filter);
|
|
91
|
+
if (generation === undefined || key === undefined)
|
|
92
|
+
return;
|
|
93
|
+
this.#entries.set(key, {
|
|
94
|
+
generation,
|
|
95
|
+
// A failed read answers nothing: each read is then asked in its turn.
|
|
96
|
+
rows: rows.then((found) => found, () => undefined),
|
|
97
|
+
take,
|
|
98
|
+
});
|
|
99
|
+
}
|
|
100
|
+
/**
|
|
101
|
+
* `reads`, with every read by key answered from a kept row where one is
|
|
102
|
+
* kept. `statementOf` says the statement the read would have sent (its
|
|
103
|
+
* `sql`); `format` turns a driver row into the read's own (binary or not, as
|
|
104
|
+
* the read's executor would). With `keeps`, a full read by key that is asked
|
|
105
|
+
* in its turn is kept for those after it (a guard's read: its rows are the
|
|
106
|
+
* driver's own). With `widen`, a read by key of a row the transaction holds
|
|
107
|
+
* locked (`held`), with nothing kept of it since the transaction last
|
|
108
|
+
* changed something, is sent as a full read through `widen.reads` (whose
|
|
109
|
+
* rows are the driver's own) and kept, and answered from it: the row cannot
|
|
110
|
+
* move while the lock is held, so the reads of it that follow — the guard
|
|
111
|
+
* reads of the write it is read for — are answered from it too, rather
|
|
112
|
+
* than each asked in its turn.
|
|
113
|
+
*/
|
|
114
|
+
over(reads, scope, schema, statementOf, format, keeps, widen) {
|
|
115
|
+
const query = async (request) => {
|
|
116
|
+
const table = schema.tables.find((candidate) => candidate.id === request?.table);
|
|
117
|
+
const guarded = table && !request.orderBy?.length && !request.offset && clampLimit(request.limit) >= 1
|
|
118
|
+
? this.#guarded(scope, table, request.filter)
|
|
119
|
+
: undefined;
|
|
120
|
+
const key = guarded && !guarded.also.length ? guarded.key : undefined;
|
|
121
|
+
// Asked again after a statement that moved the generation, of a column the row does not carry, or of a value it does not hold exactly: in its turn.
|
|
122
|
+
const answer = async (kept) => {
|
|
123
|
+
const rows = await kept.rows;
|
|
124
|
+
const names = [
|
|
125
|
+
...(request.columns?.length ? request.columns : table.columns.map((column) => column.name)),
|
|
126
|
+
// A scoped write's read of the stored texts is answered only by a row read with them (storedText.ts).
|
|
127
|
+
...(request.storedText ? [storedTextOf(schema, table)?.alias ?? []].flat() : []),
|
|
128
|
+
];
|
|
129
|
+
const sql = statementOf(request);
|
|
130
|
+
if (!rows ||
|
|
131
|
+
!sql ||
|
|
132
|
+
kept.generation !== this.generation() ||
|
|
133
|
+
!rows.every((row) => names.every((name) => Object.hasOwn(row, name))) ||
|
|
134
|
+
!rows.every((row) => guarded.also.every((condition) => Object.hasOwn(row, condition.column) && row[condition.column] === condition.value)))
|
|
135
|
+
return undefined;
|
|
136
|
+
kept.take?.();
|
|
137
|
+
return {
|
|
138
|
+
columns: request.columns?.length ? [...request.columns] : table.columns.map((column) => column.name),
|
|
139
|
+
rows: rows
|
|
140
|
+
.slice(0, clampLimit(request.limit))
|
|
141
|
+
.map((row) => format(Object.fromEntries(names.map((name) => [name, row[name]])), request)),
|
|
142
|
+
ms: 0,
|
|
143
|
+
sql,
|
|
144
|
+
};
|
|
145
|
+
};
|
|
146
|
+
const current = this.generation();
|
|
147
|
+
const kept = guarded === undefined ? undefined : this.#entries.get(guarded.key);
|
|
148
|
+
if (kept && kept.generation === current) {
|
|
149
|
+
const answered = await answer(kept);
|
|
150
|
+
if (answered)
|
|
151
|
+
return answered;
|
|
152
|
+
}
|
|
153
|
+
else if (key !== undefined && current !== undefined && widen?.held(table, guarded.values)) {
|
|
154
|
+
// With the stored texts, so the scoped write's own reads of the row are answered from it too.
|
|
155
|
+
const sent = widen.reads.query({ table: request.table, filter: request.filter, limit: 2, offset: 0, storedText: true });
|
|
156
|
+
/* Its generation is the one it was sent under: what waited for the COMMIT leaves in front of it, in its flight
|
|
157
|
+
(postgresTransactionHandle), moving the generation as it goes, and the row it reads is after that. Kept
|
|
158
|
+
under the generation before it was sent, it would answer nothing after it. Reads are sent as they are
|
|
159
|
+
asked (createScopedReads compiles before it executes), so this is that moment. */
|
|
160
|
+
const generation = this.generation();
|
|
161
|
+
// A failure is the read's own: thrown as it would have been asked.
|
|
162
|
+
const full = await sent;
|
|
163
|
+
const read = { generation: generation ?? current, rows: Promise.resolve(full.rows) };
|
|
164
|
+
this.#entries.set(key, read);
|
|
165
|
+
const answered = await answer(read);
|
|
166
|
+
if (answered)
|
|
167
|
+
return answered;
|
|
168
|
+
}
|
|
169
|
+
if (!keeps || key === undefined || request.columns?.length)
|
|
170
|
+
return reads.query(request);
|
|
171
|
+
const generation = this.generation();
|
|
172
|
+
const result = await reads.query(request);
|
|
173
|
+
if (generation !== undefined && generation === this.generation())
|
|
174
|
+
this.#entries.set(key, { generation, rows: Promise.resolve(result.rows) });
|
|
175
|
+
return result;
|
|
176
|
+
};
|
|
177
|
+
return Object.freeze({ ...reads, query });
|
|
178
|
+
}
|
|
179
|
+
}
|
|
@@ -0,0 +1,34 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* The types a scoped write takes as a row's identity (docs/trigger-effects.md, "Key types").
|
|
3
|
+
*
|
|
4
|
+
* Under a row policy, every check names a row by a value: a write's own row by its primary key, a parent by the
|
|
5
|
+
* reference that points at it, a row a trigger reaches by its effect's key. The check is sound only where the value
|
|
6
|
+
* it binds is the value the database compares. Six reviews found the same defect in new places: the driver's
|
|
7
|
+
* JavaScript reading of a jsonb key (2^53 rounded, "123" read as 123), SQLite's numeric(p,s) said with its scale
|
|
8
|
+
* (19.987 read as "19.99"), a float or timestamp whose text depends on the session's settings. So a column that is a
|
|
9
|
+
* row's identity — a primary key, either side of a foreign key, either side of a trigger effect's key — must be of a
|
|
10
|
+
* type whose value reads back exactly, through the driver and through text, and any other is refused from the
|
|
11
|
+
* catalog, before a value is read:
|
|
12
|
+
*
|
|
13
|
+
* - PostgreSQL, a domain read as the type it is over: text, varchar, char, name, citext; int2, int4, int8; numeric
|
|
14
|
+
* (the driver reads it as its exact text); uuid; date (its text pinned to ISO for the transaction, postgres.ts);
|
|
15
|
+
* boolean; an enum. Never json or jsonb, a float, a time or timestamp, an interval, money, bytea, a network
|
|
16
|
+
* address, an array, a range or a composite.
|
|
17
|
+
* - SQLite, by the affinity its declared type gives: INTEGER or TEXT. Never REAL, NUMERIC (a decimal with a declared
|
|
18
|
+
* scale is said with it), BLOB or a column declared without a type; except that a typeless column may reference an
|
|
19
|
+
* allowed key, which its foreign key compares as the check does (sqliteScopeCatalog.ts affinitiesPart).
|
|
20
|
+
*/
|
|
21
|
+
/** Why a column of `type` cannot be a row's identity in a scoped write, as a refusal says it (no full stop: it is said inside others). */
|
|
22
|
+
export declare const keyTypeRefusal: (dialect: 'postgres' | 'sqlite', table: string, column: string, type: string) => string;
|
|
23
|
+
/** SQLite's affinity for a declared type (datatype3.html, 3.1), and ANY as itself: a STRICT table's ANY converts nothing. */
|
|
24
|
+
export declare function sqliteAffinity(declared: string): string;
|
|
25
|
+
/** Whether a SQLite column declared `declared` may be a row's identity in a scoped write. */
|
|
26
|
+
export declare const sqliteKeyType: (declared: string) => boolean;
|
|
27
|
+
/** A SQLite column's type as a refusal names it. */
|
|
28
|
+
export declare const sqliteTypeSaid: (declared: string) => string;
|
|
29
|
+
/**
|
|
30
|
+
* Whether the base type `type` (an oid expression, its domains already unwrapped) may be a row's identity, as a SQL
|
|
31
|
+
* boolean: one of the built-in types above, an enum, or the citext extension's own type (an extension's member is
|
|
32
|
+
* recorded in pg_depend, so a type merely named citext is not it). Every operator named in pg_catalog.
|
|
33
|
+
*/
|
|
34
|
+
export declare const postgresKeyType: (type: string) => string;
|
|
@@ -0,0 +1,66 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* The types a scoped write takes as a row's identity (docs/trigger-effects.md, "Key types").
|
|
3
|
+
*
|
|
4
|
+
* Under a row policy, every check names a row by a value: a write's own row by its primary key, a parent by the
|
|
5
|
+
* reference that points at it, a row a trigger reaches by its effect's key. The check is sound only where the value
|
|
6
|
+
* it binds is the value the database compares. Six reviews found the same defect in new places: the driver's
|
|
7
|
+
* JavaScript reading of a jsonb key (2^53 rounded, "123" read as 123), SQLite's numeric(p,s) said with its scale
|
|
8
|
+
* (19.987 read as "19.99"), a float or timestamp whose text depends on the session's settings. So a column that is a
|
|
9
|
+
* row's identity — a primary key, either side of a foreign key, either side of a trigger effect's key — must be of a
|
|
10
|
+
* type whose value reads back exactly, through the driver and through text, and any other is refused from the
|
|
11
|
+
* catalog, before a value is read:
|
|
12
|
+
*
|
|
13
|
+
* - PostgreSQL, a domain read as the type it is over: text, varchar, char, name, citext; int2, int4, int8; numeric
|
|
14
|
+
* (the driver reads it as its exact text); uuid; date (its text pinned to ISO for the transaction, postgres.ts);
|
|
15
|
+
* boolean; an enum. Never json or jsonb, a float, a time or timestamp, an interval, money, bytea, a network
|
|
16
|
+
* address, an array, a range or a composite.
|
|
17
|
+
* - SQLite, by the affinity its declared type gives: INTEGER or TEXT. Never REAL, NUMERIC (a decimal with a declared
|
|
18
|
+
* scale is said with it), BLOB or a column declared without a type; except that a typeless column may reference an
|
|
19
|
+
* allowed key, which its foreign key compares as the check does (sqliteScopeCatalog.ts affinitiesPart).
|
|
20
|
+
*/
|
|
21
|
+
/** Why a column of `type` cannot be a row's identity in a scoped write, as a refusal says it (no full stop: it is said inside others). */
|
|
22
|
+
export const keyTypeRefusal = (dialect, table, column, type) => `"${table}".${column} is of type ${type}, which is not supported as a key for writes under a row policy ` +
|
|
23
|
+
"(a primary key, either side of a foreign key, or a trigger effect's key): " +
|
|
24
|
+
(dialect === 'sqlite'
|
|
25
|
+
? 'on SQLite a key must have INTEGER or TEXT affinity'
|
|
26
|
+
: 'on PostgreSQL a key must be text, varchar, char, citext, name, an integer, numeric, uuid, date, boolean or an enum') +
|
|
27
|
+
', whose value reads back exactly as the database compares it' +
|
|
28
|
+
(dialect === 'sqlite' && looksLikeText(type) ? '; declare it TEXT (or INTEGER) to use it as a key under a row policy' : '');
|
|
29
|
+
/* A SQLite type named as another engine's (UUID, STRING, DATETIME, BOOLEAN, GUID) is NUMERIC by SQLite's rules, which
|
|
30
|
+
its author rarely meant: the refusal says what to declare instead. `said` is sqliteTypeSaid's. */
|
|
31
|
+
const looksLikeText = (said) => said.endsWith(' (NUMERIC affinity)') && /UUID|GUID|STRING|DATE|TIME|BOOL/i.test(said.slice(0, -' (NUMERIC affinity)'.length));
|
|
32
|
+
/** SQLite's affinity for a declared type (datatype3.html, 3.1), and ANY as itself: a STRICT table's ANY converts nothing. */
|
|
33
|
+
export function sqliteAffinity(declared) {
|
|
34
|
+
const type = declared.toUpperCase();
|
|
35
|
+
if (type.trim() === 'ANY')
|
|
36
|
+
return 'ANY';
|
|
37
|
+
if (type.includes('INT'))
|
|
38
|
+
return 'INTEGER';
|
|
39
|
+
if (/CHAR|CLOB|TEXT/.test(type))
|
|
40
|
+
return 'TEXT';
|
|
41
|
+
if (type.includes('BLOB') || !type.trim())
|
|
42
|
+
return 'BLOB';
|
|
43
|
+
if (/REAL|FLOA|DOUB/.test(type))
|
|
44
|
+
return 'REAL';
|
|
45
|
+
return 'NUMERIC';
|
|
46
|
+
}
|
|
47
|
+
/** Whether a SQLite column declared `declared` may be a row's identity in a scoped write. */
|
|
48
|
+
export const sqliteKeyType = (declared) => ['INTEGER', 'TEXT'].includes(sqliteAffinity(declared));
|
|
49
|
+
/** A SQLite column's type as a refusal names it. */
|
|
50
|
+
export const sqliteTypeSaid = (declared) => declared.trim() ? `${declared.trim()} (${sqliteAffinity(declared)} affinity)` : 'none declared (BLOB affinity)';
|
|
51
|
+
/* PostgreSQL's built-in types on the list, by oid (pg_type.dat, fixed by the server's source): bool 16, name 19,
|
|
52
|
+
int8 20, int2 21, int4 23, text 25, bpchar 1042, varchar 1043, date 1082, numeric 1700, uuid 2950. */
|
|
53
|
+
const POSTGRES_KEY_OIDS = '{16,19,20,21,23,25,1042,1043,1082,1700,2950}';
|
|
54
|
+
/**
|
|
55
|
+
* Whether the base type `type` (an oid expression, its domains already unwrapped) may be a row's identity, as a SQL
|
|
56
|
+
* boolean: one of the built-in types above, an enum, or the citext extension's own type (an extension's member is
|
|
57
|
+
* recorded in pg_depend, so a type merely named citext is not it). Every operator named in pg_catalog.
|
|
58
|
+
*/
|
|
59
|
+
export const postgresKeyType = (type) => `(${type} OPERATOR(pg_catalog.=) ANY ('${POSTGRES_KEY_OIDS}'::pg_catalog.oid[])
|
|
60
|
+
OR EXISTS (SELECT FROM pg_catalog.pg_type kt WHERE kt.oid OPERATOR(pg_catalog.=) ${type} AND kt.typtype OPERATOR(pg_catalog.=) 'e')
|
|
61
|
+
OR EXISTS (SELECT FROM pg_catalog.pg_type kt
|
|
62
|
+
JOIN pg_catalog.pg_depend kd ON kd.objid OPERATOR(pg_catalog.=) kt.oid AND kd.classid OPERATOR(pg_catalog.=) 1247::pg_catalog.oid
|
|
63
|
+
AND kd.refclassid OPERATOR(pg_catalog.=) 3079::pg_catalog.oid AND kd.deptype OPERATOR(pg_catalog.=) 'e'
|
|
64
|
+
JOIN pg_catalog.pg_extension kx ON kx.oid OPERATOR(pg_catalog.=) kd.refobjid
|
|
65
|
+
WHERE kt.oid OPERATOR(pg_catalog.=) ${type} AND kt.typname OPERATOR(pg_catalog.=) 'citext'
|
|
66
|
+
AND kx.extname OPERATOR(pg_catalog.=) 'citext'))`;
|