@cosmicdrift/kumiko-framework 0.413.1 → 0.415.0
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/AGENTS.md +5 -2
- package/agents/api/framework-db.md +14 -3
- package/agents/api/framework-engine.md +69 -13
- package/agents/api/framework-errors.md +1 -1
- package/agents/api/framework-event-store.md +14 -0
- package/agents/api/framework-ui-types.md +158 -21
- package/agents/api/renderer-web.md +112 -11
- package/agents/api/testing-helpers.md +3 -2
- package/agents/api/testing-stack.md +3 -0
- package/agents/api/types.md +248 -24
- package/agents/api.md +7 -7
- package/agents/boot-rules.md +66 -10
- package/agents/examples/api-docs.md +2 -6
- package/agents/examples/auth-mfa.md +57 -10
- package/agents/examples/chat-channels.md +2 -0
- package/agents/examples/crypto-shredding-hr.md +63 -1
- package/agents/examples/currencies-global.md +1 -0
- package/agents/examples/env-composition.md +7 -11
- package/agents/examples/managed-pages.md +90 -1
- package/agents/examples/pwa-shell.md +210 -0
- package/agents/examples/rate-limiting.md +3 -3
- package/agents/examples/record-detail-layout.md +1643 -67
- package/agents/examples/workflow-engine.md +16 -12
- package/agents/examples.md +1 -0
- package/agents/features-index.md +4 -2
- package/agents/features.md +22 -7
- package/agents/widgets.md +26 -1
- package/dist/api/api-constants.d.ts +1 -0
- package/dist/api/api-constants.js +4 -0
- package/dist/api/auth-middleware.js +4 -3
- package/dist/api/auth-routes-shared.js +2 -1
- package/dist/api/entity-read-access.d.ts +1 -0
- package/dist/api/entity-read-access.js +18 -0
- package/dist/api/export/export-route.d.ts +6 -1
- package/dist/api/export/export-route.js +27 -1
- package/dist/api/export/export-rows.js +19 -3
- package/dist/api/request-context-internals.d.ts +2 -0
- package/dist/api/request-context-scopes.js +9 -2
- package/dist/api/request-context.js +1 -1
- package/dist/api/routes.d.ts +2 -0
- package/dist/api/routes.js +9 -1
- package/dist/api/server-event-dispatcher.js +3 -0
- package/dist/api/server-extra-routes.js +2 -1
- package/dist/api/server-feature-http-routes.d.ts +9 -0
- package/dist/api/server-feature-http-routes.js +109 -0
- package/dist/api/server-middleware.js +2 -19
- package/dist/api/server-pat-rate-limit-guard.d.ts +3 -0
- package/dist/api/server-pat-rate-limit-guard.js +19 -0
- package/dist/api/server-rate-limit-wiring.d.ts +10 -0
- package/dist/api/server-rate-limit-wiring.js +37 -0
- package/dist/api/server-routes.d.ts +4 -12
- package/dist/api/server-routes.js +12 -171
- package/dist/api/server-schema-route.d.ts +3 -0
- package/dist/api/server-schema-route.js +58 -0
- package/dist/api/server-wiring.js +2 -37
- package/dist/api/server.js +3 -1
- package/dist/compliance/override-schema.js +5 -5
- package/dist/compliance/sub-processors.js +10 -1
- package/dist/crypto/index.d.ts +1 -1
- package/dist/crypto/index.js +1 -1
- package/dist/crypto/pii-field-encryption.d.ts +2 -0
- package/dist/crypto/pii-field-encryption.js +16 -1
- package/dist/db/apply-entity-event.js +4 -0
- package/dist/db/bun-sql-connection-codes.d.ts +1 -0
- package/dist/db/bun-sql-connection-codes.js +7 -0
- package/dist/db/collect-table-metas.js +4 -1
- package/dist/db/config-seed.js +1 -1
- package/dist/db/derived-field-sql.js +15 -13
- package/dist/db/derived-related-sql.d.ts +2 -2
- package/dist/db/derived-related-sql.js +4 -2
- package/dist/db/dialect.d.ts +3 -0
- package/dist/db/dialect.js +1 -3
- package/dist/db/driver-row-coercion.js +2 -2
- package/dist/db/driver-value-preparation.js +1 -1
- package/dist/db/eagerload.js +15 -12
- package/dist/db/entity-table-meta.d.ts +2 -0
- package/dist/db/entity-table-meta.js +7 -0
- package/dist/db/event-store-executor-context.js +13 -8
- package/dist/db/event-store-executor-read-aggregate-currencies.js +2 -2
- package/dist/db/event-store-executor-read-aggregate.js +2 -2
- package/dist/db/event-store-executor-read-filter.d.ts +4 -0
- package/dist/db/event-store-executor-read-filter.js +28 -11
- package/dist/db/event-store-executor-read-search.d.ts +1 -0
- package/dist/db/event-store-executor-read-search.js +6 -6
- package/dist/db/event-store-executor-read-sort.js +3 -3
- package/dist/db/event-store-executor-read-where.js +14 -5
- package/dist/db/event-store-executor-read.js +7 -7
- package/dist/db/event-store-executor-write.js +50 -95
- package/dist/db/executor-managed-tables.js +4 -1
- package/dist/db/index.d.ts +4 -2
- package/dist/db/index.js +4 -2
- package/dist/db/known-table-names.d.ts +1 -0
- package/dist/db/known-table-names.js +7 -5
- package/dist/db/list-aggregate-labels.d.ts +1 -0
- package/dist/db/list-aggregate-labels.js +9 -1
- package/dist/db/migrate-generator.js +23 -4
- package/dist/db/migrate-rls-diff.d.ts +1 -0
- package/dist/db/migrate-rls-diff.js +15 -1
- package/dist/db/migrate-runner.js +2 -2
- package/dist/db/money.d.ts +1 -1
- package/dist/db/money.js +1 -4
- package/dist/db/parent-ref-clause.d.ts +6 -2
- package/dist/db/parent-ref-clause.js +105 -24
- package/dist/db/parent-ref-global-hosts.d.ts +23 -0
- package/dist/db/parent-ref-global-hosts.js +85 -0
- package/dist/db/production-schema-command-hint.d.ts +1 -0
- package/dist/db/production-schema-command-hint.js +3 -0
- package/dist/db/queries/backfill-pii.js +55 -29
- package/dist/db/queries/ddl.js +13 -2
- package/dist/db/queries/event-store-open-streams.d.ts +15 -0
- package/dist/db/queries/event-store-open-streams.js +33 -0
- package/dist/db/queries/event-store-payload-scrub.d.ts +5 -0
- package/dist/db/queries/event-store-payload-scrub.js +11 -0
- package/dist/db/queries/event-store.js +0 -1
- package/dist/db/queries/raw-sql.js +0 -1
- package/dist/db/queries/rebuild-rls-guard.d.ts +2 -1
- package/dist/db/queries/rebuild-rls-guard.js +24 -11
- package/dist/db/queries/rls-boot-catalog.d.ts +1 -0
- package/dist/db/queries/rls-boot-catalog.js +13 -9
- package/dist/db/queries/rls-shape.d.ts +3 -1
- package/dist/db/queries/rls-shape.js +31 -6
- package/dist/db/queries/session-advisory-lock.js +2 -1
- package/dist/db/queries/test-stack.js +7 -7
- package/dist/db/query.js +16 -11
- package/dist/db/rebuild-marker.js +11 -2
- package/dist/db/render-rls-ddl.d.ts +2 -0
- package/dist/db/render-rls-ddl.js +16 -11
- package/dist/db/replay-migration-sql.js +1 -1
- package/dist/db/row-level-security-boot-check.js +18 -5
- package/dist/db/row-level-security-connection.js +25 -12
- package/dist/db/row-level-security-scope.d.ts +2 -1
- package/dist/db/row-level-security-scope.js +9 -5
- package/dist/db/sql-identifier.d.ts +1 -0
- package/dist/db/sql-identifier.js +3 -0
- package/dist/db/system-tenant-read-db.d.ts +5 -0
- package/dist/db/system-tenant-read-db.js +28 -0
- package/dist/db/table-builder.d.ts +3 -1
- package/dist/db/table-builder.js +18 -8
- package/dist/db/table-info.d.ts +1 -2
- package/dist/db/table-introspection.d.ts +3 -0
- package/dist/db/table-introspection.js +6 -0
- package/dist/db/table-push.d.ts +1 -0
- package/dist/db/table-push.js +7 -1
- package/dist/db/tenant-db-runner.d.ts +3 -0
- package/dist/db/tenant-db-runner.js +19 -1
- package/dist/db/transaction-serialization.d.ts +1 -0
- package/dist/db/transaction-serialization.js +20 -3
- package/dist/db/where-clause.js +11 -2
- package/dist/db/write-ownership-failures.d.ts +25 -0
- package/dist/db/write-ownership-failures.js +82 -0
- package/dist/engine/boot-validator/boot-check.js +7 -1
- package/dist/engine/boot-validator/boot-phases-app.js +5 -5
- package/dist/engine/boot-validator/boot-phases.js +3 -2
- package/dist/engine/boot-validator/boot-rules.d.ts +305 -28
- package/dist/engine/boot-validator/boot-rules.js +4 -0
- package/dist/engine/boot-validator/bundled-lists-table.js +2 -2
- package/dist/engine/boot-validator/card-meta-overflow-rules.d.ts +2 -2
- package/dist/engine/boot-validator/card-meta-overflow-rules.js +2 -2
- package/dist/engine/boot-validator/card-meta-overflow.js +8 -5
- package/dist/engine/boot-validator/config-deps.d.ts +0 -1
- package/dist/engine/boot-validator/config-deps.js +0 -28
- package/dist/engine/boot-validator/config-key-rules.d.ts +0 -15
- package/dist/engine/boot-validator/config-key-rules.js +0 -15
- package/dist/engine/boot-validator/dashboard-screen-target.d.ts +22 -0
- package/dist/engine/boot-validator/dashboard-screen-target.js +20 -0
- package/dist/engine/boot-validator/dashboard-stat-navigate.d.ts +1 -0
- package/dist/engine/boot-validator/dashboard-stat-navigate.js +25 -17
- package/dist/engine/boot-validator/definition-webhook-events-rules.d.ts +5 -0
- package/dist/engine/boot-validator/definition-webhook-events-rules.js +5 -0
- package/dist/engine/boot-validator/derived-sql-fields.js +1 -2
- package/dist/engine/boot-validator/entity-declaration-rules.d.ts +5 -0
- package/dist/engine/boot-validator/entity-declaration-rules.js +5 -0
- package/dist/engine/boot-validator/entity-list-screens.d.ts +1 -0
- package/dist/engine/boot-validator/entity-list-screens.js +35 -13
- package/dist/engine/boot-validator/entity-structure-rules.d.ts +5 -0
- package/dist/engine/boot-validator/entity-structure-rules.js +5 -0
- package/dist/engine/boot-validator/list-column-layout.js +10 -6
- package/dist/engine/boot-validator/list-row-guidance-rules.d.ts +67 -0
- package/dist/engine/boot-validator/list-row-guidance-rules.js +67 -0
- package/dist/engine/boot-validator/list-row-guidance.d.ts +20 -0
- package/dist/engine/boot-validator/list-row-guidance.js +143 -0
- package/dist/engine/boot-validator/list-sort-summary-rules.d.ts +42 -0
- package/dist/engine/boot-validator/list-sort-summary-rules.js +42 -0
- package/dist/engine/boot-validator/list-sort-summary.d.ts +5 -0
- package/dist/engine/boot-validator/list-sort-summary.js +160 -0
- package/dist/engine/boot-validator/list-table-options.js +15 -1
- package/dist/engine/boot-validator/list-table-rules.d.ts +10 -5
- package/dist/engine/boot-validator/list-table-rules.js +10 -5
- package/dist/engine/boot-validator/list-toolbar-options.d.ts +10 -0
- package/dist/engine/boot-validator/list-toolbar-options.js +30 -0
- package/dist/engine/boot-validator/named-filter-rules.d.ts +42 -2
- package/dist/engine/boot-validator/named-filter-rules.js +42 -2
- package/dist/engine/boot-validator/ownership.js +10 -1
- package/dist/engine/boot-validator/parent-ref.js +87 -50
- package/dist/engine/boot-validator/projection-list-screens.d.ts +1 -0
- package/dist/engine/boot-validator/projection-list-screens.js +32 -1
- package/dist/engine/boot-validator/query-output-columns.js +62 -9
- package/dist/engine/boot-validator/query-output-guidance.d.ts +7 -0
- package/dist/engine/boot-validator/query-output-guidance.js +40 -0
- package/dist/engine/boot-validator/query-refs.js +34 -1
- package/dist/engine/boot-validator/row-decoration.d.ts +11 -0
- package/dist/engine/boot-validator/row-decoration.js +16 -0
- package/dist/engine/boot-validator/screens-actions.js +1 -1
- package/dist/engine/boot-validator/screens-dashboard-links.d.ts +10 -0
- package/dist/engine/boot-validator/screens-dashboard-links.js +36 -0
- package/dist/engine/boot-validator/screens-dashboard-narrow.d.ts +4 -0
- package/dist/engine/boot-validator/screens-dashboard-narrow.js +211 -0
- package/dist/engine/boot-validator/screens-dashboard-rules.d.ts +84 -4
- package/dist/engine/boot-validator/screens-dashboard-rules.js +84 -4
- package/dist/engine/boot-validator/screens-dashboard.js +29 -7
- package/dist/engine/boot-validator/screens-kind-entity-list.js +32 -27
- package/dist/engine/boot-validator/screens-kind-projection-detail-guidance.d.ts +3 -0
- package/dist/engine/boot-validator/screens-kind-projection-detail-guidance.js +46 -0
- package/dist/engine/boot-validator/screens-kind-projection-detail-rules.d.ts +20 -0
- package/dist/engine/boot-validator/screens-kind-projection-detail-rules.js +20 -0
- package/dist/engine/boot-validator/screens-kind-projection-detail.js +2 -0
- package/dist/engine/boot-validator/screens-kind-projection-list.js +4 -0
- package/dist/engine/boot-validator/screens-kind-rules.d.ts +25 -0
- package/dist/engine/boot-validator/screens-kind-rules.js +25 -0
- package/dist/engine/boot-validator/screens-lists.d.ts +8 -2
- package/dist/engine/boot-validator/screens-lists.js +19 -3
- package/dist/engine/boot-validator/screens.js +1 -1
- package/dist/engine/boot-validator/sort-nulls.d.ts +2 -0
- package/dist/engine/boot-validator/sort-nulls.js +15 -0
- package/dist/engine/boot-validator/zod-shape.d.ts +2 -1
- package/dist/engine/boot-validator/zod-shape.js +19 -1
- package/dist/engine/build-app-schema.js +4 -0
- package/dist/engine/config-helpers.d.ts +1 -2
- package/dist/engine/config-helpers.js +6 -7
- package/dist/engine/define-feature.js +1 -0
- package/dist/engine/define-handler.d.ts +1 -0
- package/dist/engine/define-handler.js +4 -2
- package/dist/engine/definition-violations.js +2 -2
- package/dist/engine/entity-handlers.js +3 -8
- package/dist/engine/entity-list-runtime-options.js +9 -8
- package/dist/engine/factories.d.ts +2 -0
- package/dist/engine/feature-config-events-jobs.js +1 -0
- package/dist/engine/feature-entity-handlers.js +5 -2
- package/dist/engine/field-access.d.ts +1 -1
- package/dist/engine/field-access.js +7 -10
- package/dist/engine/find-entity.js +3 -3
- package/dist/engine/form-derivations.js +3 -3
- package/dist/engine/index.d.ts +3 -3
- package/dist/engine/index.js +2 -2
- package/dist/engine/named-filter-roles.d.ts +3 -0
- package/dist/engine/named-filter-roles.js +15 -0
- package/dist/engine/pipeline.js +0 -1
- package/dist/engine/project-app-schema-for-roles.js +17 -2
- package/dist/engine/qualified-name.js +0 -1
- package/dist/engine/registry-facade.js +1 -2
- package/dist/engine/registry-state.d.ts +1 -1
- package/dist/engine/registry-state.js +5 -2
- package/dist/engine/registry-validate.js +2 -1
- package/dist/engine/resolve-named-list-filters.js +5 -2
- package/dist/engine/schema-builder.js +9 -11
- package/dist/engine/screen-helpers.d.ts +12 -0
- package/dist/engine/screen-helpers.js +17 -1
- package/dist/engine/soft-delete-cleanup.js +3 -5
- package/dist/engine/state-machine.js +0 -1
- package/dist/engine/steps/_database-clock.d.ts +2 -0
- package/dist/engine/steps/_database-clock.js +6 -0
- package/dist/engine/steps/compute.js +1 -1
- package/dist/engine/steps/retry.js +5 -1
- package/dist/engine/steps/return.js +0 -1
- package/dist/engine/steps/wait-for-event.js +2 -1
- package/dist/engine/steps/wait.js +2 -1
- package/dist/engine/system-user.d.ts +2 -2
- package/dist/engine/system-user.js +2 -2
- package/dist/engine/types/handlers.d.ts +1 -1
- package/dist/engine/types/handlers.js +1 -1
- package/dist/engine/types/screen.d.ts +1 -1
- package/dist/engine/types/screen.js +1 -1
- package/dist/engine/webhook-contracts.d.ts +2 -3
- package/dist/engine/webhook-contracts.js +2 -25
- package/dist/engine/webhook-events.js +48 -29
- package/dist/engine/webhook-payload-strictness.d.ts +7 -0
- package/dist/engine/webhook-payload-strictness.js +53 -0
- package/dist/env/_zod-introspect.d.ts +1 -0
- package/dist/env/dry-run.d.ts +1 -1
- package/dist/env/dry-run.js +1 -1
- package/dist/env/field-meta.d.ts +4 -0
- package/dist/env/field-meta.js +67 -0
- package/dist/env/field-rules.d.ts +9 -0
- package/dist/env/field-rules.js +46 -0
- package/dist/env/index.d.ts +3 -3
- package/dist/env/index.js +16 -71
- package/dist/env/internals.d.ts +3 -0
- package/dist/env/internals.js +1 -2
- package/dist/env/required-env.d.ts +3 -1
- package/dist/env/required-env.js +5 -2
- package/dist/errors/reasons.d.ts +1 -0
- package/dist/errors/reasons.js +4 -0
- package/dist/errors/serialize.js +2 -2
- package/dist/errors/write-error-info.js +0 -2
- package/dist/es-ops/operations-schema.js +18 -7
- package/dist/event-store/admin-api.js +3 -3
- package/dist/event-store/event-store.js +0 -3
- package/dist/event-store/index.d.ts +1 -0
- package/dist/event-store/index.js +1 -0
- package/dist/event-store/transfer.js +1 -1
- package/dist/files/assert-file-refs-belong-to-tenant.d.ts +2 -1
- package/dist/files/assert-file-refs-belong-to-tenant.js +15 -13
- package/dist/files/bind-pending-file-refs.d.ts +3 -1
- package/dist/files/bind-pending-file-refs.js +54 -27
- package/dist/files/copy-pending-file-refs-to-tenant.js +7 -3
- package/dist/files/create-file-ref.d.ts +4 -1
- package/dist/files/create-file-ref.js +14 -3
- package/dist/files/default-file-guard.js +4 -1
- package/dist/files/file-claim.d.ts +6 -0
- package/dist/files/file-claim.js +17 -0
- package/dist/files/file-field-slots.d.ts +2 -0
- package/dist/files/file-field-slots.js +28 -0
- package/dist/files/file-ref-entity.d.ts +3 -0
- package/dist/files/file-ref-entity.js +2 -0
- package/dist/files/file-ref-table.d.ts +3 -0
- package/dist/files/file-routes.d.ts +4 -1
- package/dist/files/file-routes.js +80 -16
- package/dist/files/in-memory-provider.d.ts +1 -1
- package/dist/files/in-memory-provider.js +2 -1
- package/dist/files/index.d.ts +1 -1
- package/dist/files/index.js +1 -1
- package/dist/files/invalid-file-ref-error.d.ts +2 -0
- package/dist/files/invalid-file-ref-error.js +15 -0
- package/dist/files/local-provider.js +9 -2
- package/dist/files/provider-resolver.js +1 -1
- package/dist/files/rebind-file-ref.d.ts +3 -2
- package/dist/files/rebind-file-ref.js +24 -18
- package/dist/files/resolve-file-handles.d.ts +13 -0
- package/dist/files/resolve-file-handles.js +57 -0
- package/dist/files/storage-tracking.d.ts +1 -1
- package/dist/files/storage-tracking.js +5 -2
- package/dist/files/sweep-stale-pending-file-refs.js +10 -4
- package/dist/files/types.d.ts +4 -0
- package/dist/files/types.js +10 -0
- package/dist/files/upload-field-resolution.d.ts +1 -0
- package/dist/files/upload-field-resolution.js +16 -2
- package/dist/files/upload-ledger.js +1 -1
- package/dist/i18n/required-surface-guidance-keys.d.ts +3 -0
- package/dist/i18n/required-surface-guidance-keys.js +9 -0
- package/dist/i18n/required-surface-keys.js +21 -5
- package/dist/internal/boot-rule-table-expectations.d.ts +2 -0
- package/dist/internal/boot-rule-table-expectations.js +29 -0
- package/dist/internal/row-level-security.d.ts +1 -0
- package/dist/internal/row-level-security.js +1 -0
- package/dist/internal/testing.d.ts +1 -0
- package/dist/internal/testing.js +1 -0
- package/dist/jobs/index.d.ts +1 -0
- package/dist/jobs/index.js +1 -0
- package/dist/jobs/job-load-events.d.ts +10 -0
- package/dist/jobs/job-load-events.js +12 -0
- package/dist/jobs/job-runner-context.js +6 -158
- package/dist/jobs/job-runner-dispatch.d.ts +7 -0
- package/dist/jobs/job-runner-dispatch.js +57 -0
- package/dist/jobs/job-runner-event-triggers.js +18 -9
- package/dist/jobs/job-runner-execution.js +5 -2
- package/dist/jobs/job-runner-facets.d.ts +48 -0
- package/dist/jobs/job-runner-facets.js +156 -0
- package/dist/jobs/job-runner-gates.js +19 -11
- package/dist/jobs/job-runner-helpers.d.ts +5 -1
- package/dist/jobs/job-runner-helpers.js +18 -3
- package/dist/jobs/job-runner-scope.d.ts +1 -0
- package/dist/jobs/job-runner-scope.js +2 -0
- package/dist/jobs/job-runner-tenant-cap-lock.d.ts +2 -0
- package/dist/jobs/job-runner-tenant-cap-lock.js +30 -0
- package/dist/jobs/job-runner-types.d.ts +1 -0
- package/dist/jobs/job-runner.js +39 -70
- package/dist/jobs/obliterate-job-queues.d.ts +6 -0
- package/dist/jobs/obliterate-job-queues.js +23 -0
- package/dist/lifecycle/lifecycle.js +1 -1
- package/dist/migrations/event-header-scrub.d.ts +11 -0
- package/dist/migrations/event-header-scrub.js +33 -0
- package/dist/migrations/event-payload-scrub.d.ts +1 -1
- package/dist/migrations/event-payload-scrub.js +36 -4
- package/dist/migrations/index.d.ts +1 -0
- package/dist/migrations/index.js +2 -0
- package/dist/migrations/kumiko-drift.d.ts +5 -2
- package/dist/migrations/kumiko-drift.js +51 -14
- package/dist/migrations/pending-rebuilds.js +4 -5
- package/dist/observability/sensitive-filter.js +0 -12
- package/dist/pipeline/aggregate-type-removal.js +17 -4
- package/dist/pipeline/context-services.d.ts +2 -0
- package/dist/pipeline/context-services.js +5 -2
- package/dist/pipeline/dispatch-batch.js +4 -3
- package/dist/pipeline/dispatch-context-helpers.d.ts +11 -0
- package/dist/pipeline/dispatch-context-helpers.js +58 -0
- package/dist/pipeline/dispatch-nested-write.d.ts +7 -0
- package/dist/pipeline/dispatch-nested-write.js +119 -0
- package/dist/pipeline/dispatch-query.js +10 -3
- package/dist/pipeline/dispatch-scope.js +4 -3
- package/dist/pipeline/dispatch-shared.d.ts +2 -6
- package/dist/pipeline/dispatch-shared.js +6 -38
- package/dist/pipeline/dispatch-write.d.ts +0 -1
- package/dist/pipeline/dispatch-write.js +3 -302
- package/dist/pipeline/dispatcher-utils.js +6 -0
- package/dist/pipeline/effective-system-scope.d.ts +3 -0
- package/dist/pipeline/effective-system-scope.js +22 -0
- package/dist/pipeline/event-dispatcher-delivery.d.ts +1 -0
- package/dist/pipeline/event-dispatcher-delivery.js +20 -9
- package/dist/pipeline/event-dispatcher.d.ts +6 -1
- package/dist/pipeline/event-dispatcher.js +6 -7
- package/dist/pipeline/handler-context-auth.d.ts +3 -2
- package/dist/pipeline/handler-context-auth.js +3 -4
- package/dist/pipeline/handler-context-db.js +11 -4
- package/dist/pipeline/handler-context-dispatch.js +2 -2
- package/dist/pipeline/handler-context-events.d.ts +8 -3
- package/dist/pipeline/handler-context-events.js +20 -65
- package/dist/pipeline/handler-context-member-resolution.js +16 -8
- package/dist/pipeline/handler-context-notify.d.ts +1 -0
- package/dist/pipeline/handler-context-notify.js +2 -0
- package/dist/pipeline/handler-context-phase-denials.js +3 -2
- package/dist/pipeline/handler-context-projection.d.ts +3 -0
- package/dist/pipeline/handler-context-projection.js +39 -0
- package/dist/pipeline/handler-context-scope.d.ts +1 -1
- package/dist/pipeline/handler-context-scope.js +14 -2
- package/dist/pipeline/index.d.ts +1 -1
- package/dist/pipeline/index.js +1 -1
- package/dist/pipeline/irreversible-operation-gate.js +36 -10
- package/dist/pipeline/lifecycle-pipeline.d.ts +1 -0
- package/dist/pipeline/lifecycle-pipeline.js +7 -4
- package/dist/pipeline/member-reader.js +4 -2
- package/dist/pipeline/msp-rebuild.js +1 -1
- package/dist/pipeline/nested-write-parent-guard.d.ts +5 -0
- package/dist/pipeline/nested-write-parent-guard.js +81 -0
- package/dist/pipeline/projection-rebuild.d.ts +2 -0
- package/dist/pipeline/projection-rebuild.js +16 -7
- package/dist/pipeline/projection-state.js +4 -6
- package/dist/pipeline/system-hooks.js +36 -6
- package/dist/pipeline/write-result-masking.js +31 -3
- package/dist/pipeline/write-transition-guard.d.ts +7 -0
- package/dist/pipeline/write-transition-guard.js +95 -0
- package/dist/schema-cli/shared.d.ts +2 -0
- package/dist/schema-cli/shared.js +4 -2
- package/dist/schema-cli/validate-command.js +43 -28
- package/dist/search/meilisearch-adapter-internals.d.ts +2 -0
- package/dist/search/meilisearch-adapter-internals.js +5 -0
- package/dist/search/meilisearch-adapter.d.ts +1 -0
- package/dist/search/meilisearch-adapter.js +17 -11
- package/dist/search/reindex-entity.d.ts +2 -0
- package/dist/search/reindex-entity.js +32 -4
- package/dist/search/reindex-tenants-search.js +20 -4
- package/dist/time/tz-context.js +1 -1
- package/dist/ui-types/card-column-roles.d.ts +6 -0
- package/dist/ui-types/card-column-roles.js +21 -3
- package/dist/ui-types/index.d.ts +3 -3
- package/dist/ui-types/index.js +2 -2
- package/dist/utils/ids.js +0 -1
- package/dist/utils/index.d.ts +1 -0
- package/dist/utils/index.js +1 -0
- package/dist/utils/return-path-limit.d.ts +1 -0
- package/dist/utils/return-path-limit.js +1 -0
- package/package.json +5 -3
- package/presets/biome-app.json +39 -21
- package/presets/biome-plugins/admin-api.grit +10 -0
- package/presets/biome-plugins/error-reasons.grit +53 -0
- package/presets/biome-plugins/es-literal-writes-tests.grit +18 -0
- package/presets/biome-plugins/es-literal-writes.grit +22 -0
- package/presets/biome-plugins/i18n-locale-terminology-de.grit +15 -0
- package/presets/biome-plugins/i18n-locale-terminology-romance.grit +10 -0
- package/presets/biome-plugins/no-create-test-dispatcher.grit +5 -0
- package/presets/biome-plugins/no-css-properties-type.grit +7 -0
- package/presets/biome-plugins/no-date-api.grit +11 -0
- package/presets/biome-plugins/no-direct-fetch.grit +16 -0
- package/presets/biome-plugins/no-direct-fs.grit +16 -0
- package/presets/biome-plugins/no-external-font-cdn-css.grit +9 -0
- package/presets/biome-plugins/no-external-font-cdn.grit +12 -0
- package/presets/biome-plugins/no-raw-hooks.grit +10 -0
- package/presets/biome-plugins/no-same-folder-barrel-import.grit +11 -0
- package/presets/biome-plugins/no-screen-container-classes.grit +7 -0
- package/presets/biome-plugins/no-skipped-or-retried-tests.grit +34 -0
- package/presets/biome-plugins/no-temporal-polyfill-require.grit +10 -0
- package/presets/biome-plugins/raw-html-in-web.grit +40 -0
- package/presets/biome-plugins/raw-ui-in-app.grit +142 -0
- package/presets/biome-plugins/restricted-event-store-symbols.grit +18 -0
- package/presets/biome-plugins/test-title.grit +20 -0
- package/presets/biome-plugins/unsafe-json-parse.grit +12 -0
- package/presets/biome-rules.json +467 -0
- package/src/changes.json +366 -0
- package/dist/engine/minor-units.d.ts +0 -2
- package/dist/engine/minor-units.js +0 -8
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
import { InternalError } from "../errors/index.js";
|
|
2
2
|
import { applyRowLevelSecurityScope, buildRowLevelSecurityScopeQuery, } from "./queries/rls-scope.js";
|
|
3
|
-
import { activeRowLevelSecurityScope, innerOfScopedRunner, rowLevelSecurityScopeKey, runInCapturedRowLevelSecurityScope, } from "./row-level-security-scope.js";
|
|
3
|
+
import { activeRowLevelSecurityScope, innerOfScopedRunner, isOutsideRowLevelSecurityScope, rowLevelSecurityScopeKey, runInCapturedRowLevelSecurityScope, } from "./row-level-security-scope.js";
|
|
4
4
|
import { registerRunnerProxyTarget } from "./transaction-serialization.js";
|
|
5
5
|
const enforcedHandles = new WeakSet();
|
|
6
6
|
// Differs from every scope key, so the next statement always re-applies its scope.
|
|
@@ -58,8 +58,16 @@ function withCapturedCallback(args, wrap) {
|
|
|
58
58
|
function alignedStatement(target, state, run) {
|
|
59
59
|
const desired = activeRowLevelSecurityScope();
|
|
60
60
|
return enqueue(state, async () => {
|
|
61
|
-
|
|
62
|
-
|
|
61
|
+
// The scope and the statement go out back to back; a failing set_config aborts the transaction,
|
|
62
|
+
// so the statement fails behind it.
|
|
63
|
+
const scoped = startAlignScope(target, state, desired);
|
|
64
|
+
const statement = startQuery(run);
|
|
65
|
+
const [scopeResult, statementResult] = await Promise.allSettled([scoped, statement]);
|
|
66
|
+
if (scopeResult.status === "rejected")
|
|
67
|
+
throw scopeResult.reason;
|
|
68
|
+
if (statementResult.status === "rejected")
|
|
69
|
+
throw statementResult.reason;
|
|
70
|
+
return statementResult.value;
|
|
63
71
|
});
|
|
64
72
|
}
|
|
65
73
|
function transactionHandleProxy(handle, state) {
|
|
@@ -104,17 +112,20 @@ function transactionHandleProxy(handle, state) {
|
|
|
104
112
|
registerRunnerProxyTarget(proxy, handle);
|
|
105
113
|
return proxy;
|
|
106
114
|
}
|
|
107
|
-
|
|
115
|
+
function startAlignScope(handle, state, desired) {
|
|
108
116
|
const key = rowLevelSecurityScopeKey(desired);
|
|
109
117
|
// skip: scope already applied on this connection
|
|
110
118
|
if (key === state.applied)
|
|
111
|
-
return;
|
|
119
|
+
return Promise.resolve();
|
|
112
120
|
state.applied = UNKNOWN_SCOPE_KEY;
|
|
113
|
-
|
|
114
|
-
|
|
121
|
+
return startQuery(() => buildRowLevelSecurityScopeQuery(handle, desired)).then(() => {
|
|
122
|
+
state.applied = key;
|
|
123
|
+
});
|
|
115
124
|
}
|
|
116
125
|
function newTransactionState() {
|
|
117
|
-
|
|
126
|
+
// Not "none": a pooled connection may carry a session-level scope GUC set by raw SQL, so even a
|
|
127
|
+
// scope-free transaction has to reset both settings itself.
|
|
128
|
+
return { applied: UNKNOWN_SCOPE_KEY, tail: Promise.resolve() };
|
|
118
129
|
}
|
|
119
130
|
const templateOf = (strings) => strings;
|
|
120
131
|
// Tagged-template statements pipeline behind each other; unsafe() without parameters is sent as a
|
|
@@ -171,13 +182,15 @@ async function pipelinedScopedTransaction(pool, scope, run) {
|
|
|
171
182
|
callMethod(conn, "release", []);
|
|
172
183
|
}
|
|
173
184
|
}
|
|
174
|
-
//
|
|
175
|
-
//
|
|
185
|
+
// Every pool statement runs as its own short transaction that sets both scope settings, to '' when
|
|
186
|
+
// no scope is active: a pooled connection may carry a session-level scope set by raw SQL, which a
|
|
187
|
+
// pass-through would let every scope-free statement inherit. Only outsideRowLevelSecurityScope
|
|
188
|
+
// (CONCURRENTLY and other non-transactional DDL) sends a statement straight to the connection.
|
|
176
189
|
export function enforceRowLevelSecurity(pool) {
|
|
177
190
|
const inScopedTransaction = (run) => pipelinedScopedTransaction(pool, activeRowLevelSecurityScope(), run);
|
|
178
191
|
const proxy = new Proxy(pool, {
|
|
179
192
|
apply(target, _thisArg, args) {
|
|
180
|
-
if (!isTaggedTemplateCall(args) ||
|
|
193
|
+
if (!isTaggedTemplateCall(args) || isOutsideRowLevelSecurityScope()) {
|
|
181
194
|
return applyOnTarget(target, args);
|
|
182
195
|
}
|
|
183
196
|
return inScopedTransaction((conn) => applyOnTarget(conn, args));
|
|
@@ -188,7 +201,7 @@ export function enforceRowLevelSecurity(pool) {
|
|
|
188
201
|
return value;
|
|
189
202
|
if (prop === "unsafe" || prop === "file") {
|
|
190
203
|
return (...args) => {
|
|
191
|
-
if (
|
|
204
|
+
if (isOutsideRowLevelSecurityScope())
|
|
192
205
|
return callMethod(target, prop, args);
|
|
193
206
|
if (prop === "file") {
|
|
194
207
|
// Bun sends file() only after its async file read, i.e. after the pipelined COMMIT.
|
|
@@ -7,13 +7,14 @@ export type RowLevelSecurityScope = {
|
|
|
7
7
|
readonly kind: "system";
|
|
8
8
|
readonly reason: string;
|
|
9
9
|
};
|
|
10
|
-
export declare
|
|
10
|
+
export declare function systemRowLevelSecurityScope(reason: string): RowLevelSecurityScope;
|
|
11
11
|
export declare function tenantRowLevelSecurityScope(tenantId: TenantId): RowLevelSecurityScope;
|
|
12
12
|
export declare function activeRowLevelSecurityScope(): RowLevelSecurityScope | undefined;
|
|
13
13
|
export declare function runInRowLevelSecurityScope<T>(scope: RowLevelSecurityScope, fn: () => T): T;
|
|
14
14
|
export declare function runInSystemRowLevelSecurityScope<T>(reason: string, fn: () => T): T;
|
|
15
15
|
export declare function runInCapturedRowLevelSecurityScope<T>(captured: RowLevelSecurityScope | undefined, fn: () => T): T;
|
|
16
16
|
export declare function outsideRowLevelSecurityScope<T>(fn: () => T): T;
|
|
17
|
+
export declare function isOutsideRowLevelSecurityScope(): boolean;
|
|
17
18
|
export declare function rowLevelSecurityScopeKey(scope: RowLevelSecurityScope | undefined): string;
|
|
18
19
|
export type TenantDbModeOptions = {
|
|
19
20
|
readonly mode: "tenant";
|
|
@@ -2,7 +2,7 @@ import { AsyncLocalStorage } from "node:async_hooks";
|
|
|
2
2
|
import { InternalError } from "../errors/index.js";
|
|
3
3
|
import { asEntityTableMeta } from "./table-introspection.js";
|
|
4
4
|
import { registerRunnerProxyTarget } from "./transaction-serialization.js";
|
|
5
|
-
function systemRowLevelSecurityScope(reason) {
|
|
5
|
+
export function systemRowLevelSecurityScope(reason) {
|
|
6
6
|
if (reason.trim() === "") {
|
|
7
7
|
throw new InternalError({
|
|
8
8
|
message: "A system row-level-security scope requires a non-empty reason.",
|
|
@@ -10,7 +10,6 @@ function systemRowLevelSecurityScope(reason) {
|
|
|
10
10
|
}
|
|
11
11
|
return { kind: "system", reason };
|
|
12
12
|
}
|
|
13
|
-
export const SYSTEM_ROW_LEVEL_SECURITY_SCOPE = systemRowLevelSecurityScope("framework-internal cross-tenant access");
|
|
14
13
|
function describeRowLevelSecurityScope(scope) {
|
|
15
14
|
return scope.kind === "system"
|
|
16
15
|
? `system (reason: ${scope.reason})`
|
|
@@ -33,9 +32,14 @@ export function runInSystemRowLevelSecurityScope(reason, fn) {
|
|
|
33
32
|
export function runInCapturedRowLevelSecurityScope(captured, fn) {
|
|
34
33
|
return captured === undefined ? storage.exit(fn) : storage.run(captured, fn);
|
|
35
34
|
}
|
|
36
|
-
|
|
35
|
+
const outsideScopeStorage = new AsyncLocalStorage();
|
|
36
|
+
// Use for non-transactional DDL (CREATE INDEX CONCURRENTLY) and session-level statements on an RLS-enforced
|
|
37
|
+
// pool: it opens a per-statement transaction for every statement, and only this opt-out bypasses it.
|
|
37
38
|
export function outsideRowLevelSecurityScope(fn) {
|
|
38
|
-
return storage.exit(fn);
|
|
39
|
+
return storage.exit(() => outsideScopeStorage.run(true, fn));
|
|
40
|
+
}
|
|
41
|
+
export function isOutsideRowLevelSecurityScope() {
|
|
42
|
+
return outsideScopeStorage.getStore() === true;
|
|
39
43
|
}
|
|
40
44
|
export function rowLevelSecurityScopeKey(scope) {
|
|
41
45
|
if (scope === undefined)
|
|
@@ -52,7 +56,7 @@ export function tenantDbRowLevelSecurityScope(options, tenantId, table) {
|
|
|
52
56
|
if (options.mode === "system")
|
|
53
57
|
return systemRowLevelSecurityScope(options.reason);
|
|
54
58
|
if (asEntityTableMeta(table)?.tenancy === "global")
|
|
55
|
-
return
|
|
59
|
+
return systemRowLevelSecurityScope("global-tenancy table access");
|
|
56
60
|
return tenantRowLevelSecurityScope(tenantId);
|
|
57
61
|
}
|
|
58
62
|
// A server or loop that inherits an ambient scope would run every later request fail-open.
|
|
@@ -0,0 +1,5 @@
|
|
|
1
|
+
import type { TenantDb } from "@cosmicdrift/kumiko-types/tenant-db-types";
|
|
2
|
+
import type { DbRunner } from "./connection.ts";
|
|
3
|
+
export declare function systemTenantReadDb(db: TenantDb | DbRunner): TenantDb;
|
|
4
|
+
export declare function systemTenantReadRunner(db: TenantDb | DbRunner): DbRunner;
|
|
5
|
+
export declare function systemTenantWriteRunner(db: TenantDb | DbRunner, reason: string): DbRunner;
|
|
@@ -0,0 +1,28 @@
|
|
|
1
|
+
import { assertReason } from "../engine/escape-hatch-reason.js";
|
|
2
|
+
import { SYSTEM_TENANT_ID } from "../engine/types/identifiers.js";
|
|
3
|
+
import { createTenantDb } from "./tenant-db.js";
|
|
4
|
+
import { isBoundTenantDb, tenantDbRunner } from "./tenant-db-runner.js";
|
|
5
|
+
// Tenant mode on the system tenant: RLS isolation passes exactly the system tenant's rows, never
|
|
6
|
+
// another tenant's, which a `kumiko.scope = 'system'` bypass would also expose.
|
|
7
|
+
export function systemTenantReadDb(db) {
|
|
8
|
+
return createTenantDb({
|
|
9
|
+
db: isBoundTenantDb(db) ? tenantDbRunner(db) : db,
|
|
10
|
+
tenantId: SYSTEM_TENANT_ID,
|
|
11
|
+
mode: "tenant",
|
|
12
|
+
grants: { writesDeniedReason: "on a handle that reads the system tenant's rows only" },
|
|
13
|
+
});
|
|
14
|
+
}
|
|
15
|
+
// Raw runner for event-store reads that take a DbRunner (event streaming, archive checks).
|
|
16
|
+
export function systemTenantReadRunner(db) {
|
|
17
|
+
return tenantDbRunner(systemTenantReadDb(db));
|
|
18
|
+
}
|
|
19
|
+
// Raw runner for event-store writes that take a DbRunner (stream archival, note erasure); RLS
|
|
20
|
+
// isolation limits its writes to system-tenant rows.
|
|
21
|
+
export function systemTenantWriteRunner(db, reason) {
|
|
22
|
+
assertReason("systemTenantWriteRunner", reason);
|
|
23
|
+
return tenantDbRunner(createTenantDb({
|
|
24
|
+
db: isBoundTenantDb(db) ? tenantDbRunner(db) : db,
|
|
25
|
+
tenantId: SYSTEM_TENANT_ID,
|
|
26
|
+
mode: "tenant",
|
|
27
|
+
}));
|
|
28
|
+
}
|
|
@@ -7,7 +7,7 @@ import type { MoneyRead } from "./money.ts";
|
|
|
7
7
|
export { toSnakeCase } from "../utils/case.ts";
|
|
8
8
|
import { type ColumnBuilder, type ColumnHandle, type SchemaTable, type TableColumns } from "./dialect.ts";
|
|
9
9
|
export { SOFT_DELETE_LIVE_ROW_PREDICATE } from "./entity-table-indexes.ts";
|
|
10
|
-
export declare function physicalColumnName(table:
|
|
10
|
+
export declare function physicalColumnName(table: SchemaTable, field: string): string;
|
|
11
11
|
export type AnyPgColumn = ColumnHandle;
|
|
12
12
|
export declare const READ_MODEL_PREFIX = "read_";
|
|
13
13
|
export declare function toTableName(entityName: string): string;
|
|
@@ -227,4 +227,6 @@ export type BuildEntityTableOptions = {
|
|
|
227
227
|
* Throws if the table has a `tenant_id` column or no EntityTableMeta to stamp.
|
|
228
228
|
*/
|
|
229
229
|
export declare function declareGlobalTenancy<T extends SchemaTable>(table: T): T & TenancyBrand<"global">;
|
|
230
|
+
/** Stamps `systemRowsReadable` onto an entity table's meta in place (no-op if already set). */
|
|
231
|
+
export declare function declareSystemRowsReadable(table: object): void;
|
|
230
232
|
export declare function buildEntityTable<E extends EntityDefinition>(entityName: string, entity: E, options?: BuildEntityTableOptions): EntityTable<E>;
|
package/dist/db/table-builder.js
CHANGED
|
@@ -2,7 +2,7 @@ import { KUMIKO_META_SYMBOL } from "@cosmicdrift/kumiko-types/schema-table-types
|
|
|
2
2
|
import { toSnakeCase } from "../utils/case.js";
|
|
3
3
|
import { buildEntityIndexes } from "./entity-table-indexes.js";
|
|
4
4
|
import { markExecutorManagedTable } from "./executor-managed-tables.js";
|
|
5
|
-
import { columnHandleName } from "./table-introspection.js";
|
|
5
|
+
import { asEntityTableMeta, columnHandleName } from "./table-introspection.js";
|
|
6
6
|
export { toSnakeCase } from "../utils/case.js";
|
|
7
7
|
import { bigint, boolean, decimalColumn, doublePrecision, instant, integer, jsonb, moneyAmount, table as pgTable, plainDate, serial, sql, text, uuid, } from "./dialect.js";
|
|
8
8
|
export { SOFT_DELETE_LIVE_ROW_PREDICATE } from "./entity-table-indexes.js";
|
|
@@ -117,7 +117,7 @@ const COLUMN_EMITTERS = {
|
|
|
117
117
|
function emitFieldColumns(type, name, field, entity) {
|
|
118
118
|
// A type from untyped input must not reach an Object.prototype member.
|
|
119
119
|
if (!Object.hasOwn(COLUMN_EMITTERS, type)) {
|
|
120
|
-
throw new Error(`[Kumiko] unhandled field type: ${String(
|
|
120
|
+
throw new Error(`[Kumiko] unhandled field type: ${String(type)}`);
|
|
121
121
|
}
|
|
122
122
|
const emit = COLUMN_EMITTERS[type];
|
|
123
123
|
return emit(name, toSnakeCase(name), field, entity);
|
|
@@ -198,6 +198,10 @@ const ROW_META_WITH_SOFT_DELETE = new Set(Object.keys(buildBaseColumns(true)));
|
|
|
198
198
|
export function rowMetaFieldNames(softDelete) {
|
|
199
199
|
return softDelete ? ROW_META_WITH_SOFT_DELETE : ROW_META_BASE;
|
|
200
200
|
}
|
|
201
|
+
function writeTableMeta(table, meta) {
|
|
202
|
+
// The meta slot is symbol-keyed and set by table(); it is absent from the static table type.
|
|
203
|
+
table[KUMIKO_META_SYMBOL] = meta;
|
|
204
|
+
}
|
|
201
205
|
// pgTable's own meta stamp sees neither entity.tenancy nor that this table is an executor-managed projection;
|
|
202
206
|
// patch both so db.global()'s runtime guards match the type brands.
|
|
203
207
|
function stampEntityTableMeta(table, entity) {
|
|
@@ -205,11 +209,12 @@ function stampEntityTableMeta(table, entity) {
|
|
|
205
209
|
// skip: no meta stamp present — nothing to patch
|
|
206
210
|
if (!meta)
|
|
207
211
|
return;
|
|
208
|
-
table
|
|
212
|
+
writeTableMeta(table, {
|
|
209
213
|
...meta,
|
|
210
214
|
source: "managed",
|
|
211
215
|
...(entity.tenancy === "global" && { tenancy: "global" }),
|
|
212
|
-
|
|
216
|
+
...(entity.systemRowsReadable === true && { systemRowsReadable: true }),
|
|
217
|
+
});
|
|
213
218
|
}
|
|
214
219
|
/**
|
|
215
220
|
* Stamps `tenancy: "global"` onto a `table()`/SchemaTable's meta in place.
|
|
@@ -225,13 +230,18 @@ export function declareGlobalTenancy(table) {
|
|
|
225
230
|
'declared tenancy: "global" — a global table\'s rows carry the system tenant, not a ' +
|
|
226
231
|
"per-row tenant identity.");
|
|
227
232
|
}
|
|
228
|
-
table
|
|
229
|
-
...meta,
|
|
230
|
-
tenancy: "global",
|
|
231
|
-
};
|
|
233
|
+
writeTableMeta(table, { ...meta, tenancy: "global" });
|
|
232
234
|
// @cast-boundary phantom-brand — TenancyBrand<"global"> is a phantom marker with no runtime representation.
|
|
233
235
|
return table;
|
|
234
236
|
}
|
|
237
|
+
/** Stamps `systemRowsReadable` onto an entity table's meta in place (no-op if already set). */
|
|
238
|
+
export function declareSystemRowsReadable(table) {
|
|
239
|
+
const meta = KUMIKO_META_SYMBOL in table ? asEntityTableMeta(table) : undefined;
|
|
240
|
+
// skip: no meta stamp, or already readable — nothing to patch
|
|
241
|
+
if (!meta || meta.systemRowsReadable === true)
|
|
242
|
+
return;
|
|
243
|
+
writeTableMeta(table, { ...meta, systemRowsReadable: true });
|
|
244
|
+
}
|
|
235
245
|
// The featureName prefix is inserted between read_ and the base name so all
|
|
236
246
|
// read models consistently start with `read_`, whether or not featureName is set:
|
|
237
247
|
// featureName="shop", base="read_orders" → "read_shop_orders"
|
package/dist/db/table-info.d.ts
CHANGED
|
@@ -1,4 +1,3 @@
|
|
|
1
|
-
import type { TableLike } from "./query.ts";
|
|
2
1
|
export type TableInfo = {
|
|
3
2
|
readonly name: string;
|
|
4
3
|
readonly columnOf: (field: string) => string;
|
|
@@ -7,4 +6,4 @@ export type TableInfo = {
|
|
|
7
6
|
readonly fieldOf: (column: string) => string;
|
|
8
7
|
readonly hasColumn: (fieldOrColumn: string) => boolean;
|
|
9
8
|
};
|
|
10
|
-
export declare function extractTableInfo(table:
|
|
9
|
+
export declare function extractTableInfo(table: unknown): TableInfo;
|
|
@@ -1,6 +1,9 @@
|
|
|
1
1
|
import type { EntityTableMeta } from "@cosmicdrift/kumiko-types/entity-table-meta-types";
|
|
2
2
|
import type { Writable } from "@cosmicdrift/kumiko-types/executor-brand";
|
|
3
|
+
import { type SchemaTable } from "@cosmicdrift/kumiko-types/schema-table-types";
|
|
3
4
|
export declare function isEntityTableMeta(value: unknown): value is EntityTableMeta;
|
|
5
|
+
/** True for tables built by table(): all three identity slots are present and well-formed. */
|
|
6
|
+
export declare function isSchemaTable(value: unknown): value is SchemaTable;
|
|
4
7
|
export declare function asEntityTableMeta(table: unknown): EntityTableMeta | undefined;
|
|
5
8
|
export declare function requireEntityTableMeta(table: unknown, tableName: string): EntityTableMeta;
|
|
6
9
|
/** Physical table name from the unshadowable name symbol; undefined when absent. */
|
|
@@ -17,6 +17,12 @@ export function isEntityTableMeta(value) {
|
|
|
17
17
|
"source" in value &&
|
|
18
18
|
(value.source === "managed" || value.source === "unmanaged"));
|
|
19
19
|
}
|
|
20
|
+
/** True for tables built by table(): all three identity slots are present and well-formed. */
|
|
21
|
+
export function isSchemaTable(value) {
|
|
22
|
+
return (schemaTableName(value) !== undefined &&
|
|
23
|
+
tableColumnsOf(value) !== undefined &&
|
|
24
|
+
asEntityTableMeta(value) !== undefined);
|
|
25
|
+
}
|
|
20
26
|
export function asEntityTableMeta(table) {
|
|
21
27
|
if (typeof table !== "object" || table === null)
|
|
22
28
|
return undefined;
|
package/dist/db/table-push.d.ts
CHANGED
|
@@ -31,3 +31,4 @@ export declare function ensureTableRowLevelSecurity(db: DbConnection, table: unk
|
|
|
31
31
|
export declare function unsafePushTables(db: DbConnection, tables: Record<string, unknown>, prevTables?: Record<string, unknown>, options?: {
|
|
32
32
|
readonly rowLevelSecurity?: RowLevelSecurityMode;
|
|
33
33
|
}): Promise<void>;
|
|
34
|
+
export declare function pushTableIfMissing(db: DbConnection, fullyQualifiedName: string, tables: Record<string, unknown>): Promise<void>;
|
package/dist/db/table-push.js
CHANGED
|
@@ -93,7 +93,13 @@ export async function unsafePushTables(db, tables, prevTables, options = {}) {
|
|
|
93
93
|
await applyTableRowLevelSecurity(db, meta);
|
|
94
94
|
}
|
|
95
95
|
}
|
|
96
|
-
//
|
|
96
|
+
// Idempotent bootstrap for a framework meta-table that several boot paths create.
|
|
97
|
+
export async function pushTableIfMissing(db, fullyQualifiedName, tables) {
|
|
98
|
+
// skip: table already exists — bootstrap runs from multiple paths
|
|
99
|
+
if (await tableExists(db, fullyQualifiedName))
|
|
100
|
+
return;
|
|
101
|
+
await unsafePushTables(db, tables);
|
|
102
|
+
}
|
|
97
103
|
function renderColumnType(col) {
|
|
98
104
|
return pgTypeToSqlType(col.pgType);
|
|
99
105
|
}
|
|
@@ -7,7 +7,10 @@ export declare function isBoundTenantDb(value: unknown): value is TenantDb;
|
|
|
7
7
|
export declare function isDbRunner(value: unknown): value is DbRunner;
|
|
8
8
|
export declare function bindTenantDbRunner(tenantDb: TenantDb, runner: DbRunner, modeOptions: TenantDbModeOptions, tenantId: TenantId): void;
|
|
9
9
|
export declare function tenantDbRunner(tenantDb: TenantDb): DbRunner;
|
|
10
|
+
export declare function isGlobalTenancyTable(table: unknown): boolean;
|
|
11
|
+
export declare function tenantDbRunnerForTable(tenantDb: TenantDb, table: unknown): DbRunner;
|
|
10
12
|
export declare function denyTenantDbWrites(tenantDb: TenantDb, reason: string): void;
|
|
11
13
|
export declare function tenantDbWritesDeniedReason(tenantDb: TenantDb): string | undefined;
|
|
12
14
|
export declare function tenantDbWritesDeniedError(operation: string, reason: string): InternalError;
|
|
13
15
|
export declare function tenantDbWriteRunner(tenantDb: TenantDb, operation: string): DbRunner;
|
|
16
|
+
export declare function tenantDbWriteRunnerForTable(tenantDb: TenantDb, operation: string, table: unknown): DbRunner;
|
|
@@ -1,6 +1,7 @@
|
|
|
1
1
|
import { propertyOf } from "@cosmicdrift/kumiko-types/type-guards";
|
|
2
2
|
import { InternalError } from "../errors/index.js";
|
|
3
|
-
import { tenantDbRowLevelSecurityScope, withRowLevelSecurityScope, } from "./row-level-security-scope.js";
|
|
3
|
+
import { systemScopedRunner, tenantDbRowLevelSecurityScope, withRowLevelSecurityScope, } from "./row-level-security-scope.js";
|
|
4
|
+
import { asEntityTableMeta } from "./table-introspection.js";
|
|
4
5
|
const tenantDbRunners = new WeakMap();
|
|
5
6
|
export function isBoundTenantDb(value) {
|
|
6
7
|
return typeof value === "object" && value !== null && tenantDbRunners.has(value);
|
|
@@ -23,6 +24,17 @@ export function tenantDbRunner(tenantDb) {
|
|
|
23
24
|
}
|
|
24
25
|
return runner;
|
|
25
26
|
}
|
|
27
|
+
export function isGlobalTenancyTable(table) {
|
|
28
|
+
return asEntityTableMeta(table)?.tenancy === "global";
|
|
29
|
+
}
|
|
30
|
+
// Raw statements against one entity table: a global table holds system tenant rows, so its reads run
|
|
31
|
+
// in the system scope like the TenantDb's own statements on it (tenantDbRowLevelSecurityScope).
|
|
32
|
+
export function tenantDbRunnerForTable(tenantDb, table) {
|
|
33
|
+
const runner = tenantDbRunner(tenantDb);
|
|
34
|
+
return isGlobalTenancyTable(table)
|
|
35
|
+
? systemScopedRunner(runner, "global table rows carry the system tenant")
|
|
36
|
+
: runner;
|
|
37
|
+
}
|
|
26
38
|
const writesDeniedReasons = new WeakMap();
|
|
27
39
|
export function denyTenantDbWrites(tenantDb, reason) {
|
|
28
40
|
writesDeniedReasons.set(tenantDb, reason);
|
|
@@ -43,3 +55,9 @@ export function tenantDbWriteRunner(tenantDb, operation) {
|
|
|
43
55
|
throw tenantDbWritesDeniedError(operation, reason);
|
|
44
56
|
return tenantDbRunner(tenantDb);
|
|
45
57
|
}
|
|
58
|
+
export function tenantDbWriteRunnerForTable(tenantDb, operation, table) {
|
|
59
|
+
const reason = writesDeniedReasons.get(tenantDb);
|
|
60
|
+
if (reason !== undefined)
|
|
61
|
+
throw tenantDbWritesDeniedError(operation, reason);
|
|
62
|
+
return tenantDbRunnerForTable(tenantDb, table);
|
|
63
|
+
}
|
|
@@ -3,4 +3,5 @@ export declare function registerRunnerProxyTarget(proxy: HandleKey, target: Hand
|
|
|
3
3
|
export declare function openSerializedSavepoint<T>(transactionHandle: HandleKey & {
|
|
4
4
|
savepoint: <R>(fn: (sp: unknown) => Promise<R>) => Promise<R>;
|
|
5
5
|
}, fn: (sp: unknown) => Promise<T>): Promise<T>;
|
|
6
|
+
export declare function runStatementBehindPendingUnits<T>(handle: HandleKey, statement: () => T): Promise<Awaited<T>>;
|
|
6
7
|
export {};
|
|
@@ -24,29 +24,35 @@ function transactionKeyOf(handle) {
|
|
|
24
24
|
}
|
|
25
25
|
function chainFor(transactionKey) {
|
|
26
26
|
const nested = nestedChainsInScope.getStore()?.get(transactionKey);
|
|
27
|
-
|
|
27
|
+
// Background tasks started inside a unit outlive it and inherit its scope; once the unit has
|
|
28
|
+
// finished their work must queue on the root chain again.
|
|
29
|
+
if (nested?.active)
|
|
28
30
|
return nested;
|
|
29
31
|
const root = rootChains.get(transactionKey);
|
|
30
32
|
if (root)
|
|
31
33
|
return root;
|
|
32
|
-
const created = { tail: Promise.resolve() };
|
|
34
|
+
const created = { tail: Promise.resolve(), active: true, pending: 0 };
|
|
33
35
|
rootChains.set(transactionKey, created);
|
|
34
36
|
return created;
|
|
35
37
|
}
|
|
36
38
|
async function runOnChain(transactionKey, work) {
|
|
37
39
|
const chain = chainFor(transactionKey);
|
|
38
40
|
const previous = chain.tail;
|
|
41
|
+
chain.pending++;
|
|
39
42
|
let release = () => { };
|
|
40
43
|
chain.tail = new Promise((resolve) => {
|
|
41
44
|
release = resolve;
|
|
42
45
|
});
|
|
43
46
|
await previous;
|
|
47
|
+
const nestedChain = { tail: Promise.resolve(), active: true, pending: 0 };
|
|
44
48
|
try {
|
|
45
49
|
const scope = new Map(nestedChainsInScope.getStore());
|
|
46
|
-
scope.set(transactionKey,
|
|
50
|
+
scope.set(transactionKey, nestedChain);
|
|
47
51
|
return await nestedChainsInScope.run(scope, work);
|
|
48
52
|
}
|
|
49
53
|
finally {
|
|
54
|
+
nestedChain.active = false;
|
|
55
|
+
chain.pending--;
|
|
50
56
|
release();
|
|
51
57
|
}
|
|
52
58
|
}
|
|
@@ -58,3 +64,14 @@ export function openSerializedSavepoint(transactionHandle, fn) {
|
|
|
58
64
|
return fn(sp);
|
|
59
65
|
}));
|
|
60
66
|
}
|
|
67
|
+
// Runs a statement on a transaction handle. With no unit queued on the current chain (the nested
|
|
68
|
+
// chain inside a running unit, else the root) it goes straight to the driver; otherwise it queues
|
|
69
|
+
// behind the pending units of that chain.
|
|
70
|
+
export async function runStatementBehindPendingUnits(handle, statement) {
|
|
71
|
+
const transactionKey = transactionKeyOf(handle);
|
|
72
|
+
const nested = nestedChainsInScope.getStore()?.get(transactionKey);
|
|
73
|
+
const chain = nested?.active ? nested : rootChains.get(transactionKey);
|
|
74
|
+
if ((chain?.pending ?? 0) === 0)
|
|
75
|
+
return await statement();
|
|
76
|
+
return runOnChain(transactionKey, async () => await statement());
|
|
77
|
+
}
|
package/dist/db/where-clause.js
CHANGED
|
@@ -138,8 +138,10 @@ function emitNotEqual(target, operator) {
|
|
|
138
138
|
}
|
|
139
139
|
function emitIn(target, operator) {
|
|
140
140
|
const operand = operator.in;
|
|
141
|
-
if (
|
|
141
|
+
if (operand === undefined)
|
|
142
142
|
return undefined;
|
|
143
|
+
if (!Array.isArray(operand))
|
|
144
|
+
throw new Error(`where: in on column "${target.column}" needs an array`);
|
|
143
145
|
if (target.pgType === "jsonb")
|
|
144
146
|
return jsonbContainsAny(target, operand);
|
|
145
147
|
if (operand.length === 0)
|
|
@@ -148,8 +150,11 @@ function emitIn(target, operator) {
|
|
|
148
150
|
}
|
|
149
151
|
function emitNotIn(target, operator) {
|
|
150
152
|
const operand = operator.notIn;
|
|
151
|
-
if (
|
|
153
|
+
if (operand === undefined)
|
|
152
154
|
return undefined;
|
|
155
|
+
if (!Array.isArray(operand)) {
|
|
156
|
+
throw new Error(`where: notIn on column "${target.column}" needs an array`);
|
|
157
|
+
}
|
|
153
158
|
if (target.pgType === "jsonb") {
|
|
154
159
|
throw new Error(`where: notIn is not supported on jsonb column "${target.column}"`);
|
|
155
160
|
}
|
|
@@ -177,6 +182,10 @@ function operatorConditions(target, operator) {
|
|
|
177
182
|
if (condition !== undefined)
|
|
178
183
|
conditions.push(condition);
|
|
179
184
|
}
|
|
185
|
+
// An empty result would drop the WHERE and turn deleteMany/selectMany into whole-table operations.
|
|
186
|
+
if (conditions.length === 0) {
|
|
187
|
+
throw new Error(`where: operator on column "${target.column}" has no defined operand`);
|
|
188
|
+
}
|
|
180
189
|
return conditions;
|
|
181
190
|
}
|
|
182
191
|
// Blind-index OR rewrite: if the column has a bidx
|
|
@@ -0,0 +1,25 @@
|
|
|
1
|
+
import type { EntityDefinition } from "@cosmicdrift/kumiko-types/fields";
|
|
2
|
+
import type { EntityId } from "@cosmicdrift/kumiko-types/identifiers";
|
|
3
|
+
import type { SessionUser, TenantId } from "../engine/types/index.ts";
|
|
4
|
+
import type { WriteFailure } from "../errors/index.ts";
|
|
5
|
+
import type { DbRow } from "./connection.ts";
|
|
6
|
+
export declare function createOwnershipFailure(options: {
|
|
7
|
+
readonly entity: EntityDefinition;
|
|
8
|
+
readonly entityName: string;
|
|
9
|
+
readonly user: SessionUser;
|
|
10
|
+
readonly streamTenantId: TenantId | undefined;
|
|
11
|
+
readonly payloadWithoutId: Record<string, unknown>;
|
|
12
|
+
readonly data: DbRow;
|
|
13
|
+
readonly applyDefaults: (payload: Record<string, unknown>) => Record<string, unknown>;
|
|
14
|
+
}): WriteFailure | undefined;
|
|
15
|
+
export declare function updateOwnershipFailure(options: {
|
|
16
|
+
readonly entity: EntityDefinition;
|
|
17
|
+
readonly entityName: string;
|
|
18
|
+
readonly user: SessionUser;
|
|
19
|
+
readonly streamTenantId: TenantId | undefined;
|
|
20
|
+
readonly id: EntityId;
|
|
21
|
+
readonly submittedChanges: Record<string, unknown>;
|
|
22
|
+
readonly previous: DbRow;
|
|
23
|
+
readonly changes: DbRow;
|
|
24
|
+
readonly mergedNew: Record<string, unknown>;
|
|
25
|
+
}): WriteFailure | undefined;
|
|
@@ -0,0 +1,82 @@
|
|
|
1
|
+
import { checkWriteFieldOwnership } from "../engine/field-access.js";
|
|
2
|
+
import { userCanCreateFieldRow, userCanWriteFieldRow } from "../engine/ownership.js";
|
|
3
|
+
import { ownershipSubject } from "./event-store-executor-context.js";
|
|
4
|
+
import { ownershipDeniedFailure } from "./event-store-executor-write-steps.js";
|
|
5
|
+
export function createOwnershipFailure(options) {
|
|
6
|
+
const { entity, entityName, user, streamTenantId, payloadWithoutId, data, applyDefaults } = options;
|
|
7
|
+
// H.2 — entity-level write-ownership on create. No oldRow exists, so
|
|
8
|
+
// only the new row is checked. No Straddle concern for creates.
|
|
9
|
+
if (!userCanCreateFieldRow(ownershipSubject(user, streamTenantId), entity.access?.write, data)) {
|
|
10
|
+
return ownershipDeniedFailure({
|
|
11
|
+
scope: "entity",
|
|
12
|
+
entityName,
|
|
13
|
+
action: "create",
|
|
14
|
+
userId: user.id,
|
|
15
|
+
});
|
|
16
|
+
}
|
|
17
|
+
// Field-level write-ownership on create — mirror of entity-level but
|
|
18
|
+
// per declared field. Role-level was already checked by the
|
|
19
|
+
// dispatcher; here we enforce ownership-rules against the new row.
|
|
20
|
+
//
|
|
21
|
+
// Which fields get checked is scoped to the pre-hook payload
|
|
22
|
+
// — a hook-derived field the user never submitted must not be
|
|
23
|
+
// field-ownership-checked against the user. The rule for a checked
|
|
24
|
+
// field is still evaluated against the full post-hook row (`data`) —
|
|
25
|
+
// an ownership rule can reference a column only a hook populates.
|
|
26
|
+
const fieldDeniedCreate = checkWriteFieldOwnership(entity, applyDefaults(payloadWithoutId), ownershipSubject(user, streamTenantId), undefined, data);
|
|
27
|
+
if (fieldDeniedCreate) {
|
|
28
|
+
return ownershipDeniedFailure({
|
|
29
|
+
scope: "field",
|
|
30
|
+
entityName,
|
|
31
|
+
action: "create",
|
|
32
|
+
field: fieldDeniedCreate,
|
|
33
|
+
userId: user.id,
|
|
34
|
+
});
|
|
35
|
+
}
|
|
36
|
+
return undefined;
|
|
37
|
+
}
|
|
38
|
+
export function updateOwnershipFailure(options) {
|
|
39
|
+
const { entity, entityName, user, streamTenantId, id, submittedChanges, previous, changes, mergedNew, } = options;
|
|
40
|
+
// H.2 — entity-level write-ownership on update. Load old row (already
|
|
41
|
+
// done above), build post-change row via shallow merge. Straddle-safe
|
|
42
|
+
// multi-role check: at least one role must accept BOTH old and new —
|
|
43
|
+
// prevents the attack where role A passes old, role B passes new and
|
|
44
|
+
// aggregation would wrongly allow a row-grab.
|
|
45
|
+
if (!userCanWriteFieldRow(ownershipSubject(user, streamTenantId), entity.access?.write, previous, mergedNew)) {
|
|
46
|
+
return ownershipDeniedFailure({
|
|
47
|
+
scope: "entity",
|
|
48
|
+
entityName,
|
|
49
|
+
action: "update",
|
|
50
|
+
userId: user.id,
|
|
51
|
+
entityId: id,
|
|
52
|
+
});
|
|
53
|
+
}
|
|
54
|
+
// Field-level write-ownership on update — this is the path the
|
|
55
|
+
// dispatcher could not evaluate (no oldRow). Now that we have
|
|
56
|
+
// `previous`, we can run the ownership rules per field against both
|
|
57
|
+
// sides and reject individual fields the user isn't entitled to
|
|
58
|
+
// touch on this specific row.
|
|
59
|
+
//
|
|
60
|
+
// Which fields get checked is scoped to `payload.changes` (the user's
|
|
61
|
+
// actual submission), NOT `changes` (post-preSave-hook data)
|
|
62
|
+
// — a hook-derived field the user never submitted (e.g. a system hook
|
|
63
|
+
// setting `assignedTo`) has no business being field-ownership-checked
|
|
64
|
+
// against the *user*, and doing so rejects writes the user is fully
|
|
65
|
+
// entitled to make. The dispatcher's role-gate (checkWriteFieldAccess)
|
|
66
|
+
// already runs on this same pre-hook payload for consistency. The rule
|
|
67
|
+
// for a checked field is still evaluated against the full post-hook
|
|
68
|
+
// row (`changes` merged onto `previous`) — an ownership rule can
|
|
69
|
+
// reference a column only a hook populates.
|
|
70
|
+
const fieldDeniedUpdate = checkWriteFieldOwnership(entity, submittedChanges, ownershipSubject(user, streamTenantId), previous, changes);
|
|
71
|
+
if (fieldDeniedUpdate) {
|
|
72
|
+
return ownershipDeniedFailure({
|
|
73
|
+
scope: "field",
|
|
74
|
+
entityName,
|
|
75
|
+
action: "update",
|
|
76
|
+
field: fieldDeniedUpdate,
|
|
77
|
+
userId: user.id,
|
|
78
|
+
entityId: id,
|
|
79
|
+
});
|
|
80
|
+
}
|
|
81
|
+
return undefined;
|
|
82
|
+
}
|
|
@@ -1,5 +1,6 @@
|
|
|
1
1
|
import { BOOT_CHECK_RULES } from "./boot-check-rules.js";
|
|
2
|
-
import {
|
|
2
|
+
import { isRuntimeCrash } from "./boot-report.js";
|
|
3
|
+
import { BootRuleFailures, BootRuleViolation, BootValidationError, bootRuleError, } from "./boot-rule.js";
|
|
3
4
|
// r.bootCheck(fn) lets a feature declare its own mount-invariant instead of
|
|
4
5
|
// relying on framework-internal knowledge (the gdpr-storage.ts guards are
|
|
5
6
|
// the framework-owned version of this same idea). Each registered fn gets
|
|
@@ -7,6 +8,9 @@ import { BootRuleFailures, BootRuleViolation, bootRuleError } from "./boot-rule.
|
|
|
7
8
|
// message with the owning feature's name so the error text points back at
|
|
8
9
|
// the feature that declared the check.
|
|
9
10
|
function prefixFailure(failure, prefix) {
|
|
11
|
+
// Already-structured violations of a nested report keep their own rule ids.
|
|
12
|
+
if (failure instanceof BootValidationError)
|
|
13
|
+
return failure;
|
|
10
14
|
const rule = failure instanceof BootRuleViolation ? failure.rule : BOOT_CHECK_RULES.failed;
|
|
11
15
|
return new BootRuleViolation(rule, prefix + failure.message);
|
|
12
16
|
}
|
|
@@ -17,6 +21,8 @@ export function runFeatureBootCheck(feature, check, features) {
|
|
|
17
21
|
check(ctx);
|
|
18
22
|
}
|
|
19
23
|
catch (err) {
|
|
24
|
+
if (isRuntimeCrash(err) || err instanceof BootValidationError)
|
|
25
|
+
throw err;
|
|
20
26
|
if (err instanceof BootRuleViolation)
|
|
21
27
|
throw prefixFailure(err, prefix);
|
|
22
28
|
if (err instanceof BootRuleFailures) {
|