@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
|
@@ -20,6 +20,8 @@ export const APP_CONTEXT_KEY_ROLES = {
|
|
|
20
20
|
_notifyFactory: "service",
|
|
21
21
|
_notifyInTransactionFactory: "service",
|
|
22
22
|
_notifyAfterCommitFactory: "service",
|
|
23
|
+
_deliveryAttemptLogFactory: "wiring",
|
|
24
|
+
_logOwnDeliveryAttempt: "service",
|
|
23
25
|
_escapeHatchAuditSink: "service",
|
|
24
26
|
db: "wiring",
|
|
25
27
|
systemDb: "wiring",
|
|
@@ -50,11 +52,12 @@ function isAppContextKey(key) {
|
|
|
50
52
|
function isServiceKey(key) {
|
|
51
53
|
return isAppContextKey(key) && APP_CONTEXT_KEY_ROLES[key] === "service";
|
|
52
54
|
}
|
|
53
|
-
// The dispatcher binds these
|
|
54
|
-
// context must not leak into a context that has none of its own.
|
|
55
|
+
// The dispatcher binds these to one call's caller and transaction; a binding inherited from an
|
|
56
|
+
// outer context must not leak into a context that has none of its own.
|
|
55
57
|
const PER_CALL_FACTORY_KEYS = new Set([
|
|
56
58
|
"_notifyInTransactionFactory",
|
|
57
59
|
"_notifyAfterCommitFactory",
|
|
60
|
+
"_logOwnDeliveryAttempt",
|
|
58
61
|
]);
|
|
59
62
|
function copyService(target, source, key) {
|
|
60
63
|
const value = source[key];
|
|
@@ -6,9 +6,10 @@ import { toWriteErrorInfo } from "../errors/write-error-info.js";
|
|
|
6
6
|
import { createFallbackLogger } from "../logging/utils.js";
|
|
7
7
|
import { parseJsonSafe } from "../utils/safe-json.js";
|
|
8
8
|
import { flushAfterRollback } from "./after-rollback-sink.js";
|
|
9
|
+
import { executeNestedWrite } from "./dispatch-nested-write.js";
|
|
9
10
|
import { runInDispatchScope } from "./dispatch-scope.js";
|
|
10
11
|
import { buildHandlerContext, resolveAppPoolDb } from "./dispatch-shared.js";
|
|
11
|
-
import {
|
|
12
|
+
import { executeWrite } from "./dispatch-write.js";
|
|
12
13
|
import { BatchRollback, isLifecycleResult, wrapToKumiko, } from "./dispatcher-utils.js";
|
|
13
14
|
import { reserveBeforeTransaction, runAsCommand, } from "./pre-transaction-reservations.js";
|
|
14
15
|
import { effectiveWriteOrigin, isPersonalDataGated, rootWriteOrigin } from "./write-origin.js";
|
|
@@ -184,8 +185,8 @@ async function runBatchBody(ctx, commands, user, requestId, inheritedOrigin) {
|
|
|
184
185
|
else if (lifecycleResult.kind === "delete")
|
|
185
186
|
deletes.push(lifecycleResult);
|
|
186
187
|
}
|
|
187
|
-
// skip: nothing to flush when there are no
|
|
188
|
-
if (!lifecycle || (saves.length === 0 && deletes.length === 0))
|
|
188
|
+
// skip: nothing to flush when there are no batch hooks or no successful save/delete
|
|
189
|
+
if (!lifecycle?.hasBatchHooks() || (saves.length === 0 && deletes.length === 0))
|
|
189
190
|
return;
|
|
190
191
|
// Post-commit context: batch hooks may write, but nothing is left to roll back.
|
|
191
192
|
const hookContext = await buildHandlerContext(ctx, BATCH_HOOKS_CONTEXT_TYPE, user, origin, {
|
|
@@ -0,0 +1,11 @@
|
|
|
1
|
+
import type { DbConnection, DbTx } from "../db/connection.ts";
|
|
2
|
+
import { buildEntityTable } from "../db/table-builder.ts";
|
|
3
|
+
import type { TenantDb } from "../db/tenant-db.ts";
|
|
4
|
+
import type { SessionUser } from "../engine/types/index.ts";
|
|
5
|
+
import type { DispatchContext } from "./dispatch-shared.ts";
|
|
6
|
+
export declare function resolveDbSource(ctx: DispatchContext, tx: DbTx | undefined): DbConnection | DbTx | undefined;
|
|
7
|
+
export declare function resolveAppPoolDb(ctx: DispatchContext): DbConnection | undefined;
|
|
8
|
+
export declare function createSystemScopedDbGuard(handlerType: string, fieldName: "db" | "db.outsideTransaction", hint: string): TenantDb;
|
|
9
|
+
export declare function isMemberResolutionPrincipal(user: SessionUser): boolean;
|
|
10
|
+
export declare function requireDbSource(ctx: DispatchContext, tx: DbTx | undefined, surfaceCall: string): DbConnection | DbTx;
|
|
11
|
+
export declare function getTable(ctx: DispatchContext, entityName: string): ReturnType<typeof buildEntityTable> | undefined;
|
|
@@ -0,0 +1,58 @@
|
|
|
1
|
+
import { buildEntityTable } from "../db/table-builder.js";
|
|
2
|
+
import { InternalError } from "../errors/index.js";
|
|
3
|
+
// Narrowing helper: AppContext.db is DbConnection|TenantDb|undefined. The
|
|
4
|
+
// dispatch paths need DbConnection (or DbTx from the caller scope) for
|
|
5
|
+
// appendEvent/projection writes; the TenantDb branch is excluded here.
|
|
6
|
+
export function resolveDbSource(ctx, tx) {
|
|
7
|
+
return tx ?? resolveAppPoolDb(ctx);
|
|
8
|
+
}
|
|
9
|
+
export function resolveAppPoolDb(ctx) {
|
|
10
|
+
return ctx.appContext.db; // @cast-boundary db-operator
|
|
11
|
+
}
|
|
12
|
+
// r.systemScope() handlers must go through ctx.systemDb's guarded methods
|
|
13
|
+
// (assertTenantMatch / acknowledgeCrossTenant) instead of plain ctx.db —
|
|
14
|
+
// "system" mode has no tenant filter at all, so silent ctx.db or
|
|
15
|
+
// ctx.db.outsideTransaction use there is a cross-tenant leak. HandlerContext
|
|
16
|
+
// has no way to make either field optional per handler (isSystem is a
|
|
17
|
+
// runtime-only registry lookup, not a type-level discriminant), so instead
|
|
18
|
+
// of omitting the key we hand back a Proxy that throws on first touch,
|
|
19
|
+
// naming the handler and pointing at the matching ctx.systemDb escape hatch.
|
|
20
|
+
// Only the db guard answers `outsideTransaction` (the inner guard, set by attachOutsideTransaction).
|
|
21
|
+
export function createSystemScopedDbGuard(handlerType, fieldName, hint) {
|
|
22
|
+
return new Proxy({}, {
|
|
23
|
+
get(target, prop) {
|
|
24
|
+
if (fieldName === "db" && prop === "outsideTransaction")
|
|
25
|
+
return Reflect.get(target, prop);
|
|
26
|
+
throw new InternalError({
|
|
27
|
+
message: `Handler "${handlerType}" is r.systemScope()'d — ctx.${fieldName} is unavailable ` +
|
|
28
|
+
`(it would be unfiltered across every tenant). Use ${hint} ` +
|
|
29
|
+
`instead (attempted to read "${String(prop)}").`,
|
|
30
|
+
});
|
|
31
|
+
},
|
|
32
|
+
});
|
|
33
|
+
}
|
|
34
|
+
export function isMemberResolutionPrincipal(user) {
|
|
35
|
+
return user.origin === "member-resolution";
|
|
36
|
+
}
|
|
37
|
+
export function requireDbSource(ctx, tx, surfaceCall) {
|
|
38
|
+
const dbSource = resolveDbSource(ctx, tx);
|
|
39
|
+
if (!dbSource) {
|
|
40
|
+
throw new InternalError({
|
|
41
|
+
message: `${surfaceCall} requires a database connection — none is configured.`,
|
|
42
|
+
});
|
|
43
|
+
}
|
|
44
|
+
return dbSource;
|
|
45
|
+
}
|
|
46
|
+
export function getTable(ctx, entityName) {
|
|
47
|
+
const { registry, tableCache } = ctx;
|
|
48
|
+
if (tableCache.has(entityName))
|
|
49
|
+
return tableCache.get(entityName);
|
|
50
|
+
const entity = registry.getEntity(entityName);
|
|
51
|
+
if (!entity)
|
|
52
|
+
return undefined;
|
|
53
|
+
const table = buildEntityTable(entityName, entity, {
|
|
54
|
+
relations: registry.getRelations(entityName),
|
|
55
|
+
});
|
|
56
|
+
tableCache.set(entityName, table);
|
|
57
|
+
return table;
|
|
58
|
+
}
|
|
@@ -0,0 +1,7 @@
|
|
|
1
|
+
import type { WriteResult } from "@cosmicdrift/kumiko-types/handlers";
|
|
2
|
+
import type { DbTx } from "../db/connection.ts";
|
|
3
|
+
import type { SessionUser } from "../engine/types/index.ts";
|
|
4
|
+
import type { DispatchContext, WriteOrigin } from "./dispatch-shared.ts";
|
|
5
|
+
import { type AfterCommitHook } from "./dispatcher-utils.ts";
|
|
6
|
+
export declare function unwrapSaveRow(data: unknown): Record<string, unknown>;
|
|
7
|
+
export declare function executeNestedWrite(ctx: DispatchContext, type: string, payload: unknown, user: SessionUser, origin: WriteOrigin, tx: DbTx | undefined, afterCommitHooks: AfterCommitHook[]): Promise<WriteResult>;
|
|
@@ -0,0 +1,119 @@
|
|
|
1
|
+
import { maskWriteOnlyFields } from "../engine/field-access.js";
|
|
2
|
+
import { InternalError, ValidationError, writeFailure } from "../errors/index.js";
|
|
3
|
+
import { executeWrite } from "./dispatch-write.js";
|
|
4
|
+
import { extractNestedSpecs, prefixValidationPath, } from "./dispatcher-utils.js";
|
|
5
|
+
import { rejectUnverifiedParent } from "./nested-write-parent-guard.js";
|
|
6
|
+
function collectNestedForeignKeyIssues(nested) {
|
|
7
|
+
// Pre-flight client-shape checks. Merge non-array issues (collected up
|
|
8
|
+
// front by extractNestedSpecs) with fk-injection issues into one error
|
|
9
|
+
// so the client sees every problem in a single round-trip.
|
|
10
|
+
//
|
|
11
|
+
// Security rail: the client MUST NOT supply the foreign key on nested
|
|
12
|
+
// items. The framework binds it from the parent's new id. Silent-overwrite
|
|
13
|
+
// would mask an attempt to attach children to a different parent — fail
|
|
14
|
+
// loud with a ValidationError carrying a client-mappable path.
|
|
15
|
+
const issues = [...nested.typeIssues];
|
|
16
|
+
for (const spec of nested.specs) {
|
|
17
|
+
for (let i = 0; i < spec.items.length; i++) {
|
|
18
|
+
const item = spec.items[i];
|
|
19
|
+
if (item && typeof item === "object" && spec.foreignKey in item) {
|
|
20
|
+
issues.push({
|
|
21
|
+
path: `${spec.key}.${i}.${spec.foreignKey}`,
|
|
22
|
+
code: "unexpected_field",
|
|
23
|
+
i18nKey: "errors.validation.unexpected_field",
|
|
24
|
+
});
|
|
25
|
+
}
|
|
26
|
+
}
|
|
27
|
+
}
|
|
28
|
+
return issues;
|
|
29
|
+
}
|
|
30
|
+
// Handlers built on the CRUD executor return a SaveContext wrapper —
|
|
31
|
+
// `{ kind: "save", id, data: <row>, changes, previous, event, ... }`.
|
|
32
|
+
// The wrapper is load-bearing for batch-level hooks downstream (see
|
|
33
|
+
// flushBatchHooks), so we mutate in place: nested children land on the
|
|
34
|
+
// inner `data` (which mirrors the entity shape the client expects) while
|
|
35
|
+
// the wrapper keeps its SaveContext semantics intact for the lifecycle
|
|
36
|
+
// pipeline. For handlers that return a bare row (no wrapper), children
|
|
37
|
+
// land directly on that object.
|
|
38
|
+
//
|
|
39
|
+
// Hook-ordering note: per-entity postSave hooks already ran inside the
|
|
40
|
+
// parent's executeWrite call — they never saw `tasks`, which is
|
|
41
|
+
// the right semantic (postSave gets the entity's own columns, not
|
|
42
|
+
// synthetic relation keys). A future postSaveBatch subscriber that
|
|
43
|
+
// enumerates columns generically WOULD see `tasks`; no such subscriber
|
|
44
|
+
// exists today. If you add one that iterates `Object.keys(save.data)`,
|
|
45
|
+
// filter by `entity.fields` membership to stay correct.
|
|
46
|
+
// handler-Result.data is generic across all entity handlers; nested-
|
|
47
|
+
// write inspects the shape structurally.
|
|
48
|
+
export function unwrapSaveRow(data) {
|
|
49
|
+
const wrapper = data; // @cast-boundary engine-payload
|
|
50
|
+
return (wrapper["data"] ?? wrapper); // @cast-boundary engine-payload
|
|
51
|
+
}
|
|
52
|
+
async function writeNestedChildren(ctx, spec, parentId, user, origin, tx, afterCommitHooks) {
|
|
53
|
+
const { registry } = ctx;
|
|
54
|
+
const subRows = [];
|
|
55
|
+
for (let i = 0; i < spec.items.length; i++) {
|
|
56
|
+
const rawItem = spec.items[i];
|
|
57
|
+
const itemObj = (rawItem ?? {}); // @cast-boundary engine-payload
|
|
58
|
+
const subPayload = { ...itemObj, [spec.foreignKey]: parentId };
|
|
59
|
+
const subResult = await executeWrite(ctx, spec.subType, subPayload, user, origin, tx, afterCommitHooks);
|
|
60
|
+
if (!subResult.isSuccess) {
|
|
61
|
+
return {
|
|
62
|
+
kind: "failed",
|
|
63
|
+
failure: {
|
|
64
|
+
isSuccess: false,
|
|
65
|
+
error: prefixValidationPath(subResult.error, `${spec.key}.${i}`),
|
|
66
|
+
},
|
|
67
|
+
};
|
|
68
|
+
}
|
|
69
|
+
const subRow = unwrapSaveRow(subResult.data);
|
|
70
|
+
const subEntityName = registry.getHandlerEntity(spec.subType);
|
|
71
|
+
const subEntity = subEntityName ? registry.getEntity(subEntityName) : undefined;
|
|
72
|
+
// parentRow is returned to the client; the child's own SaveContext keeps the plaintext.
|
|
73
|
+
subRows.push(subEntity ? maskWriteOnlyFields(subEntity, subRow) : subRow);
|
|
74
|
+
}
|
|
75
|
+
return { kind: "written", rows: subRows };
|
|
76
|
+
}
|
|
77
|
+
// Nested-write orchestration (v1: depth=1, create-only, hasMany-only).
|
|
78
|
+
//
|
|
79
|
+
// When a parent `:create` handler's payload carries values under keys
|
|
80
|
+
// declared as `hasMany` relations with `nestedWrite: true`, those values
|
|
81
|
+
// are expanded into child writes: parent first (so its new id exists),
|
|
82
|
+
// then each nested entry as a separate `<target>:create` write with the
|
|
83
|
+
// foreign key set by the framework — never taken from the client. All of
|
|
84
|
+
// this runs inside the caller's transaction, so a child failure rolls the
|
|
85
|
+
// parent (and any earlier children) back together.
|
|
86
|
+
//
|
|
87
|
+
// This wrapper is what runBatch calls, not executeWrite. Single writes
|
|
88
|
+
// (`dispatcher.write`) flow through runBatch as batch-of-one, so they get
|
|
89
|
+
// nested-expansion too for free. A batch with N heterogeneous commands
|
|
90
|
+
// can each independently carry nested-children — all still one TX.
|
|
91
|
+
export async function executeNestedWrite(ctx, type, payload, user, origin, tx, afterCommitHooks) {
|
|
92
|
+
const nested = extractNestedSpecs(type, payload, ctx.registry);
|
|
93
|
+
if (!nested)
|
|
94
|
+
return executeWrite(ctx, type, payload, user, origin, tx, afterCommitHooks);
|
|
95
|
+
const issues = collectNestedForeignKeyIssues(nested);
|
|
96
|
+
if (issues.length > 0) {
|
|
97
|
+
return writeFailure(new ValidationError({ fields: issues }));
|
|
98
|
+
}
|
|
99
|
+
const parentResult = await executeWrite(ctx, type, nested.cleanPayload, user, origin, tx, afterCommitHooks);
|
|
100
|
+
if (!parentResult.isSuccess)
|
|
101
|
+
return parentResult;
|
|
102
|
+
const parentRow = unwrapSaveRow(parentResult.data);
|
|
103
|
+
const parentId = parentRow["id"];
|
|
104
|
+
if (typeof parentId !== "string") {
|
|
105
|
+
return writeFailure(new InternalError({
|
|
106
|
+
message: `nested-write: parent handler "${type}" returned no string "id" — cannot attach children`,
|
|
107
|
+
}));
|
|
108
|
+
}
|
|
109
|
+
const parentRejection = await rejectUnverifiedParent(ctx, type, parentRow, parentId, user, tx);
|
|
110
|
+
if (parentRejection)
|
|
111
|
+
return parentRejection;
|
|
112
|
+
for (const spec of nested.specs) {
|
|
113
|
+
const children = await writeNestedChildren(ctx, spec, parentId, user, origin, tx, afterCommitHooks);
|
|
114
|
+
if (children.kind === "failed")
|
|
115
|
+
return children.failure;
|
|
116
|
+
parentRow[spec.key] = children.rows;
|
|
117
|
+
}
|
|
118
|
+
return parentResult;
|
|
119
|
+
}
|
|
@@ -1,9 +1,9 @@
|
|
|
1
|
-
import { isListAggregateResult } from "@cosmicdrift/kumiko-types/list-aggregate-types";
|
|
2
1
|
import { isPlainObject, propertyOf } from "@cosmicdrift/kumiko-types/type-guards";
|
|
2
|
+
import { isAnsweredListAggregate } from "../db/list-aggregate-labels.js";
|
|
3
3
|
import { hasAccess } from "../engine/access.js";
|
|
4
4
|
import { tenantOverrideDenied } from "../engine/cross-tenant.js";
|
|
5
5
|
import { filterReadFields } from "../engine/field-access.js";
|
|
6
|
-
import { NotFoundError, ValidationError, validationErrorFromZod } from "../errors/index.js";
|
|
6
|
+
import { AccessDeniedError, FrameworkReasons, NotFoundError, ValidationError, validationErrorFromZod, } from "../errors/index.js";
|
|
7
7
|
import { assertNoSecretLeak } from "../secrets/leak-guard.js";
|
|
8
8
|
import { runInDispatchScope } from "./dispatch-scope.js";
|
|
9
9
|
import { buildHandlerContext, enforceRateLimit, ensureFeatureEnabled, isMemberResolutionPrincipal, runHandlerInstrumented, } from "./dispatch-shared.js";
|
|
@@ -98,7 +98,14 @@ async function runQueryHandler(ctx, type, handler, payload, trash, user, origin,
|
|
|
98
98
|
const entityHooks = entityName ? registry.getEntityPostQueryHooks(entityName) : [];
|
|
99
99
|
const postQueryHooks = [...handlerHooks, ...entityHooks];
|
|
100
100
|
// Aggregate groups are not rows: their values are already read-gated and the hooks are row-shaped.
|
|
101
|
-
const isAggregate =
|
|
101
|
+
const isAggregate = isAnsweredListAggregate(result);
|
|
102
|
+
if (isAggregate && postQueryHooks.length > 0) {
|
|
103
|
+
// Hooks may hide rows; counts over the unfiltered set would leak them, and hooks cannot run on groups.
|
|
104
|
+
throw new AccessDeniedError({
|
|
105
|
+
message: `aggregate on "${type}" is refused: postQuery hooks filter rows and cannot be applied to aggregate groups`,
|
|
106
|
+
details: { reason: FrameworkReasons.fieldAccessDenied, handler: type },
|
|
107
|
+
});
|
|
108
|
+
}
|
|
102
109
|
if (!isAggregate && postQueryHooks.length > 0 && result && typeof result === "object") {
|
|
103
110
|
if (Array.isArray(result)) {
|
|
104
111
|
let rows = result; // @cast-boundary engine-payload
|
|
@@ -1,10 +1,11 @@
|
|
|
1
|
-
import { runInRowLevelSecurityScope,
|
|
1
|
+
import { runInRowLevelSecurityScope, systemRowLevelSecurityScope, tenantRowLevelSecurityScope, } from "../db/row-level-security-scope.js";
|
|
2
|
+
import { isEffectivelySystemScoped } from "./effective-system-scope.js";
|
|
2
3
|
// Handlers declared with r.systemScope() act across tenants, so a single-type dispatch of one runs system-scoped.
|
|
3
4
|
// The caller picks the types of a batch, so a batch is system-scoped only when every command is; each command then
|
|
4
5
|
// narrows or widens to its own type's scope (runInDispatchScope in runReservedCommand).
|
|
5
6
|
export function dispatchRowLevelSecurityScope(registry, types, user) {
|
|
6
|
-
return types.length > 0 && types.every((type) => registry
|
|
7
|
-
?
|
|
7
|
+
return types.length > 0 && types.every((type) => isEffectivelySystemScoped(registry, type))
|
|
8
|
+
? systemRowLevelSecurityScope("dispatch of system-scoped handlers")
|
|
8
9
|
: tenantRowLevelSecurityScope(user.tenantId);
|
|
9
10
|
}
|
|
10
11
|
export function runInDispatchScope(registry, types, user, fn) {
|
|
@@ -3,7 +3,6 @@ import type { JobRunnerRef, PayloadRateLimitOption, RateLimitDeclaration, WriteR
|
|
|
3
3
|
import type { SseBroker } from "../api/sse-broker.ts";
|
|
4
4
|
import type { DbConnection, DbTx } from "../db/connection.ts";
|
|
5
5
|
import type { buildEntityTable } from "../db/table-builder.ts";
|
|
6
|
-
import { type TenantDb } from "../db/tenant-db.ts";
|
|
7
6
|
import type { defineTransitions } from "../engine/state-machine.ts";
|
|
8
7
|
import type { EffectiveFeaturesResolver } from "../engine/tier-resolver-extension.ts";
|
|
9
8
|
import type { TenantId } from "../engine/types/identifiers.ts";
|
|
@@ -11,6 +10,7 @@ import type { AppContext, BeforeTransactionContext, HandlerContext, Registry, Re
|
|
|
11
10
|
import { type WriteErrorInfo } from "../errors/index.ts";
|
|
12
11
|
import type { EscapeHatchReportWindow } from "../observability/escape-hatch-report.ts";
|
|
13
12
|
import type { getFallbackMeter, getFallbackTracer } from "../observability/fallback.ts";
|
|
13
|
+
import { createSystemScopedDbGuard, isMemberResolutionPrincipal, resolveAppPoolDb, resolveDbSource } from "./dispatch-context-helpers.ts";
|
|
14
14
|
import { type AfterCommitHook } from "./dispatcher-utils.ts";
|
|
15
15
|
import type { IdempotencyGuard } from "./idempotency.ts";
|
|
16
16
|
import type { LifecycleHooks } from "./lifecycle-pipeline.ts";
|
|
@@ -18,7 +18,7 @@ import type { TenantTimezoneCache } from "./tenant-timezone-cache.ts";
|
|
|
18
18
|
import { TENANT_TIMEZONE_CONFIG_KEY } from "./tenant-timezone-config-key.ts";
|
|
19
19
|
import { type WriteOrigin } from "./write-origin.ts";
|
|
20
20
|
export type { WriteOrigin } from "./write-origin.ts";
|
|
21
|
-
export { TENANT_TIMEZONE_CONFIG_KEY };
|
|
21
|
+
export { createSystemScopedDbGuard, isMemberResolutionPrincipal, resolveAppPoolDb, resolveDbSource, TENANT_TIMEZONE_CONFIG_KEY, };
|
|
22
22
|
export declare const CONFIG_WRITE_SET_TYPE = "config:write:set";
|
|
23
23
|
export declare const CONFIG_WRITE_RESET_TYPE = "config:write:reset";
|
|
24
24
|
export type BatchCommand = {
|
|
@@ -54,10 +54,6 @@ export type DispatchContext = {
|
|
|
54
54
|
outsideTransactionDb: DbConnection | undefined;
|
|
55
55
|
};
|
|
56
56
|
export declare const DEFAULT_MEMBER_READ_TIMEOUT_MS = 10000;
|
|
57
|
-
export declare function resolveDbSource(ctx: DispatchContext, tx: DbTx | undefined): DbConnection | DbTx | undefined;
|
|
58
|
-
export declare function resolveAppPoolDb(ctx: DispatchContext): DbConnection | undefined;
|
|
59
|
-
export declare function createSystemScopedDbGuard(handlerType: string, fieldName: "db" | "db.outsideTransaction", hint: string): TenantDb;
|
|
60
|
-
export declare function isMemberResolutionPrincipal(user: SessionUser): boolean;
|
|
61
57
|
export type HandlerTransactionScope = "inTransaction" | "withoutTransaction" | "postCommit";
|
|
62
58
|
export type BuildHandlerContextOptions = {
|
|
63
59
|
tx?: DbTx;
|
|
@@ -15,6 +15,7 @@ import { isPlainObject } from "../utils/is-plain-object.js";
|
|
|
15
15
|
import { resolveAuthClaims as runAuthClaimsResolver } from "./auth-claims-resolver.js";
|
|
16
16
|
import { configAccessorFactoryOf } from "./config-accessor-factory.js";
|
|
17
17
|
import { buildContextServices } from "./context-services.js";
|
|
18
|
+
import { createSystemScopedDbGuard, isMemberResolutionPrincipal, resolveAppPoolDb, resolveDbSource, } from "./dispatch-context-helpers.js";
|
|
18
19
|
import { executeQuery } from "./dispatch-query.js";
|
|
19
20
|
import { dispatcherSpanAttributes, isFailedWriteResult, } from "./dispatcher-utils.js";
|
|
20
21
|
import { buildAuthFacet } from "./handler-context-auth.js";
|
|
@@ -26,11 +27,12 @@ import { applyMemberResolutionReadOnly } from "./handler-context-member-resoluti
|
|
|
26
27
|
import { buildNotifyFacet } from "./handler-context-notify.js";
|
|
27
28
|
import { buildObservabilityFacet } from "./handler-context-observability.js";
|
|
28
29
|
import { applyBeforeTransactionReadOnly, denyEventStoreSurfaces, denyTransactionBoundSurfaces, withoutTransactionDenied, } from "./handler-context-phase-denials.js";
|
|
30
|
+
import { buildHandlerProjectionReader } from "./handler-context-projection.js";
|
|
29
31
|
import { buildLifecycleSignal, buildPreSave, buildRuntimeServices, resolveHandlerContextScope, } from "./handler-context-scope.js";
|
|
30
32
|
import { createGatedIdentitySwitch, isSystemIdentity } from "./system-identity-switch.js";
|
|
31
33
|
import { TENANT_TIMEZONE_CONFIG_KEY } from "./tenant-timezone-config-key.js";
|
|
32
34
|
import { rootWriteOrigin } from "./write-origin.js";
|
|
33
|
-
export { TENANT_TIMEZONE_CONFIG_KEY };
|
|
35
|
+
export { createSystemScopedDbGuard, isMemberResolutionPrincipal, resolveAppPoolDb, resolveDbSource, TENANT_TIMEZONE_CONFIG_KEY, };
|
|
34
36
|
// Same bundled-features-free constraint as above — these name the config
|
|
35
37
|
// feature's write handlers so dispatch-write.ts can invalidate
|
|
36
38
|
// TENANT_TIMEZONE_CONFIG_KEY's cache entry on a successful write without
|
|
@@ -39,40 +41,6 @@ export { TENANT_TIMEZONE_CONFIG_KEY };
|
|
|
39
41
|
export const CONFIG_WRITE_SET_TYPE = "config:write:set";
|
|
40
42
|
export const CONFIG_WRITE_RESET_TYPE = "config:write:reset";
|
|
41
43
|
export const DEFAULT_MEMBER_READ_TIMEOUT_MS = 10_000;
|
|
42
|
-
// Narrowing helper: AppContext.db is DbConnection|TenantDb|undefined. The
|
|
43
|
-
// dispatch paths need DbConnection (or DbTx from the caller scope) for
|
|
44
|
-
// appendEvent/projection writes; the TenantDb branch is excluded here.
|
|
45
|
-
export function resolveDbSource(ctx, tx) {
|
|
46
|
-
return tx ?? resolveAppPoolDb(ctx);
|
|
47
|
-
}
|
|
48
|
-
export function resolveAppPoolDb(ctx) {
|
|
49
|
-
return ctx.appContext.db; // @cast-boundary db-operator
|
|
50
|
-
}
|
|
51
|
-
// r.systemScope() handlers must go through ctx.systemDb's guarded methods
|
|
52
|
-
// (assertTenantMatch / acknowledgeCrossTenant) instead of plain ctx.db —
|
|
53
|
-
// "system" mode has no tenant filter at all, so silent ctx.db or
|
|
54
|
-
// ctx.db.outsideTransaction use there is a cross-tenant leak. HandlerContext
|
|
55
|
-
// has no way to make either field optional per handler (isSystem is a
|
|
56
|
-
// runtime-only registry lookup, not a type-level discriminant), so instead
|
|
57
|
-
// of omitting the key we hand back a Proxy that throws on first touch,
|
|
58
|
-
// naming the handler and pointing at the matching ctx.systemDb escape hatch.
|
|
59
|
-
// Only the db guard answers `outsideTransaction` (the inner guard, set by attachOutsideTransaction).
|
|
60
|
-
export function createSystemScopedDbGuard(handlerType, fieldName, hint) {
|
|
61
|
-
return new Proxy({}, {
|
|
62
|
-
get(target, prop) {
|
|
63
|
-
if (fieldName === "db" && prop === "outsideTransaction")
|
|
64
|
-
return Reflect.get(target, prop);
|
|
65
|
-
throw new InternalError({
|
|
66
|
-
message: `Handler "${handlerType}" is r.systemScope()'d — ctx.${fieldName} is unavailable ` +
|
|
67
|
-
`(it would be unfiltered across every tenant). Use ${hint} ` +
|
|
68
|
-
`instead (attempted to read "${String(prop)}").`,
|
|
69
|
-
});
|
|
70
|
-
},
|
|
71
|
-
});
|
|
72
|
-
}
|
|
73
|
-
export function isMemberResolutionPrincipal(user) {
|
|
74
|
-
return user.origin === "member-resolution";
|
|
75
|
-
}
|
|
76
44
|
export async function buildHandlerContext(ctx, type, user, origin, options = {}) {
|
|
77
45
|
const { tx, afterCommitHooks, includeDeleted, onlyDeleted, outerNotifySink, phase = "handler", transactionScope = tx ? "inTransaction" : "withoutTransaction", } = options;
|
|
78
46
|
const readOnlyForTenant = phase === "beforeTransaction";
|
|
@@ -84,11 +52,11 @@ export async function buildHandlerContext(ctx, type, user, origin, options = {})
|
|
|
84
52
|
const configFacet = buildConfigFacet(scope, dbFacet.db);
|
|
85
53
|
const writeTarget = buildWriteTarget(scope, dbFacet.exposedDb, readOnlyForTenant);
|
|
86
54
|
const fileFragment = buildFileFragment(scope, dbFacet.db);
|
|
87
|
-
const authFacet = buildAuthFacet(scope);
|
|
55
|
+
const authFacet = buildAuthFacet(scope, resolveAuthClaimsFn);
|
|
88
56
|
const eventStoreFacet = buildEventStoreFacet(scope);
|
|
89
57
|
const dispatchFacet = buildDispatchFacet(scope, sinks, {
|
|
90
58
|
queryAsMember: authFacet.queryAsMember,
|
|
91
|
-
queryProjection:
|
|
59
|
+
queryProjection: buildHandlerProjectionReader(scope),
|
|
92
60
|
});
|
|
93
61
|
const tz = await resolveHandlerTz(scope, configFacet.config);
|
|
94
62
|
const locale = resolveHandlerLocale(scope);
|
|
@@ -521,7 +489,7 @@ function buildAuthClaimsContext(ctx, user) {
|
|
|
521
489
|
: undefined;
|
|
522
490
|
const identitySwitch = createGatedIdentitySwitch("r.authClaims hook", user, false, {
|
|
523
491
|
// Login is itself the root operation; the hook context is read-only.
|
|
524
|
-
queryAs: (asUser, qn, payload) => executeQuery(ctx, qn, payload, asUser, rootWriteOrigin(ctx.registry, qn, asUser)),
|
|
492
|
+
queryAs: (asUser, qn, payload) => executeQuery(ctx, qn, payload, asUser, rootWriteOrigin(ctx.registry, qn, asUser)),
|
|
525
493
|
writeAs: async () => {
|
|
526
494
|
throw new InternalError({
|
|
527
495
|
message: "r.authClaims hook context has no writeAs — auth-claims hooks are read-only.",
|
|
@@ -4,4 +4,3 @@ import type { SessionUser } from "../engine/types/index.ts";
|
|
|
4
4
|
import type { DispatchContext, WriteOrigin } from "./dispatch-shared.ts";
|
|
5
5
|
import { type AfterCommitHook } from "./dispatcher-utils.ts";
|
|
6
6
|
export declare function executeWrite(ctx: DispatchContext, type: string, payload: unknown, user: SessionUser, origin: WriteOrigin, tx: DbTx | undefined, afterCommitHooks: AfterCommitHook[]): Promise<WriteResult>;
|
|
7
|
-
export declare function executeNestedWrite(ctx: DispatchContext, type: string, payload: unknown, user: SessionUser, origin: WriteOrigin, tx: DbTx | undefined, afterCommitHooks: AfterCommitHook[]): Promise<WriteResult>;
|