@cosmicdrift/kumiko-framework 0.413.0 → 0.414.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 +64 -13
- package/agents/api/framework-event-store.md +14 -0
- package/agents/api/framework-ui-types.md +149 -21
- package/agents/api/renderer-web.md +93 -9
- package/agents/api/testing-helpers.md +3 -2
- package/agents/api/testing-stack.md +3 -0
- package/agents/api/types.md +205 -14
- package/agents/api.md +7 -7
- package/agents/boot-rules.md +63 -9
- 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/currencies-global.md +1 -0
- package/agents/examples/env-composition.md +7 -11
- package/agents/examples/helpdesk.md +15 -8
- 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 +1537 -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 +19 -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/routes.d.ts +2 -0
- package/dist/api/routes.js +9 -1
- 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 +76 -23
- package/dist/db/parent-ref-global-hosts.d.ts +20 -0
- package/dist/db/parent-ref-global-hosts.js +47 -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 -8
- package/dist/db/queries/rls-shape.d.ts +2 -1
- package/dist/db/queries/rls-shape.js +10 -0
- 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 +293 -26
- 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.js +1 -0
- 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 +33 -6
- 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 +129 -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 +149 -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 +31 -0
- package/dist/engine/boot-validator/named-filter-rules.d.ts +32 -2
- package/dist/engine/boot-validator/named-filter-rules.js +32 -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 +31 -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 +39 -0
- package/dist/engine/boot-validator/query-refs.js +24 -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-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 +23 -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.d.ts +1 -0
- package/dist/engine/registry-validate.js +9 -1
- package/dist/engine/registry.js +2 -1
- package/dist/engine/resolve-named-list-filters.js +5 -2
- package/dist/engine/schema-builder.js +6 -10
- package/dist/engine/screen-helpers.d.ts +12 -0
- package/dist/engine/screen-helpers.js +17 -1
- package/dist/engine/soft-delete-cleanup.js +5 -8
- 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/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/feature.js +1 -0
- 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 +19 -4
- 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 +2 -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 +24 -12
- 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.js +31 -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 +17 -9
- package/dist/pipeline/event-dispatcher.d.ts +4 -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/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.js +14 -9
- 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 +4 -0
- package/dist/ui-types/card-column-roles.js +6 -3
- package/dist/ui-types/index.d.ts +2 -2
- package/dist/ui-types/index.js +1 -1
- 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 +9 -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 +6 -0
- package/presets/biome-rules.json +465 -0
- package/src/changes.json +309 -0
- package/dist/engine/minor-units.d.ts +0 -2
- package/dist/engine/minor-units.js +0 -8
|
@@ -16,10 +16,35 @@ const DEFAULT_BATCH_SIZE = 500;
|
|
|
16
16
|
function hasValue(value) {
|
|
17
17
|
return value !== undefined && value !== null && value !== PII_ERASED_SENTINEL;
|
|
18
18
|
}
|
|
19
|
+
const TEXT_FIELD_TYPES = new Set(["text", "longText"]);
|
|
20
|
+
// The sentinel is text; written into a typed projection column (integer, date, uuid, jsonb) it
|
|
21
|
+
// would fail every later rebuild of the table, and the event can no longer be repaired. So only
|
|
22
|
+
// text fields take it, other declared fields go null, and a required non-text field has no
|
|
23
|
+
// valid replacement. Fields the registry does not declare fall back to the value's own type.
|
|
24
|
+
function replacementFor(registry, aggregateType, field, value) {
|
|
25
|
+
const def = registry.getEntity(aggregateType)?.fields[field];
|
|
26
|
+
if (def === undefined)
|
|
27
|
+
return typeof value === "string" ? PII_ERASED_SENTINEL : null;
|
|
28
|
+
if (TEXT_FIELD_TYPES.has(def.type))
|
|
29
|
+
return typeof value === "string" ? PII_ERASED_SENTINEL : null;
|
|
30
|
+
if ("required" in def && def.required === true) {
|
|
31
|
+
throw new Error(`scrubEventPayloadFields: "${aggregateType}.${field}" is a required ${def.type} field; ` +
|
|
32
|
+
"it can neither hold the erase placeholder nor null, so its events cannot be scrubbed.");
|
|
33
|
+
}
|
|
34
|
+
return null;
|
|
35
|
+
}
|
|
36
|
+
function assertLifecycleFieldsScrubbable(registry, eventType, fields) {
|
|
37
|
+
for (const [entityName] of registry.getAllEntities()) {
|
|
38
|
+
if (!isLifecycleEventOf(eventType, entityName))
|
|
39
|
+
continue;
|
|
40
|
+
for (const field of fields)
|
|
41
|
+
replacementFor(registry, entityName, field, "");
|
|
42
|
+
}
|
|
43
|
+
}
|
|
19
44
|
function payloadSections(row, payload) {
|
|
20
45
|
return isLifecycleEventOf(row.type, row.aggregate_type) ? lifecycleSections(payload) : [payload];
|
|
21
46
|
}
|
|
22
|
-
async function scrubPayload(row, options) {
|
|
47
|
+
async function scrubPayload(registry, row, options) {
|
|
23
48
|
const payload = structuredClone(row.payload);
|
|
24
49
|
let scrubbed = 0;
|
|
25
50
|
for (const section of payloadSections(row, payload)) {
|
|
@@ -38,7 +63,7 @@ async function scrubPayload(row, options) {
|
|
|
38
63
|
};
|
|
39
64
|
if (options.shouldScrub && !(await options.shouldScrub(value, candidate)))
|
|
40
65
|
continue;
|
|
41
|
-
section[field] =
|
|
66
|
+
section[field] = replacementFor(registry, row.aggregate_type, field, value);
|
|
42
67
|
scrubbed++;
|
|
43
68
|
}
|
|
44
69
|
}
|
|
@@ -57,7 +82,7 @@ async function scrubOneBatch(db, registry, args) {
|
|
|
57
82
|
const touchedAggregateTypes = new Set();
|
|
58
83
|
for (const row of rows) {
|
|
59
84
|
totals.scannedEvents++;
|
|
60
|
-
const { payload, scrubbed } = await scrubPayload(row, options);
|
|
85
|
+
const { payload, scrubbed } = await scrubPayload(registry, row, options);
|
|
61
86
|
if (scrubbed === 0)
|
|
62
87
|
continue;
|
|
63
88
|
totals.scrubbedEvents++;
|
|
@@ -115,7 +140,10 @@ async function scrubAllBatches(db, registry, options) {
|
|
|
115
140
|
log,
|
|
116
141
|
failureMessage: "Projection rebuild after an event payload scrub failed; the tables stay queued in kumiko_pending_rebuilds",
|
|
117
142
|
});
|
|
118
|
-
|
|
143
|
+
// A real run is an audit trail of a destructive cross-tenant rewrite, so it must survive prod log levels.
|
|
144
|
+
(options.dryRun ? log.debug : log.info)?.("Event payload scrub finished", {
|
|
145
|
+
migrationId,
|
|
146
|
+
dryRun: options.dryRun === true,
|
|
119
147
|
eventType: options.eventType,
|
|
120
148
|
fields: options.fields,
|
|
121
149
|
reason: options.reason,
|
|
@@ -123,10 +151,14 @@ async function scrubAllBatches(db, registry, options) {
|
|
|
123
151
|
});
|
|
124
152
|
return { ...totals, queuedTables: [...queuedTables], rebuild };
|
|
125
153
|
}
|
|
154
|
+
// Run it in a maintenance window without running writes on the affected event types: batches
|
|
155
|
+
// page by id (`"id" > afterEventId`) over committed rows, and bigserial ids are handed out before
|
|
156
|
+
// commit, so a parallel append whose id is below the cursor commits unseen and is skipped.
|
|
126
157
|
export function scrubEventPayloadFields(db, registry, options) {
|
|
127
158
|
assertReason("scrubEventPayloadFields", options.reason);
|
|
128
159
|
if (options.fields.length === 0) {
|
|
129
160
|
throw new Error("scrubEventPayloadFields: name at least one payload field to scrub");
|
|
130
161
|
}
|
|
162
|
+
assertLifecycleFieldsScrubbable(registry, options.eventType, options.fields);
|
|
131
163
|
return runInSystemRowLevelSecurityScope("event payload scrub rewrites one event type across all tenants", () => withoutStatementTimeout(db, (unboundedDb) => scrubAllBatches(unboundedDb, registry, options)));
|
|
132
164
|
}
|
|
@@ -1,3 +1,4 @@
|
|
|
1
|
+
export { type ScrubEventHeaderOptions, type ScrubEventHeaderResult, scrubEventHeaderKeys, } from "./event-header-scrub.ts";
|
|
1
2
|
export { type EventScrubCandidate, type ScrubEventPayloadOptions, type ScrubEventPayloadResult, scrubEventPayloadFields, } from "./event-payload-scrub.ts";
|
|
2
3
|
export { assertKumikoSchemaCurrent, SchemaDriftError, } from "./kumiko-drift.ts";
|
|
3
4
|
export { enqueueProjectionRebuild, listPendingRebuilds, PROJECTION_REBUILD_JOB, queueRebuildsFromMarkers, rebuildProjectionOrMultiStream, reportPendingRebuildRun, runPendingRebuilds, } from "./pending-rebuilds.ts";
|
package/dist/migrations/index.js
CHANGED
|
@@ -1,4 +1,6 @@
|
|
|
1
1
|
// Drizzle-free gate (kumiko/migrations system) — the canonical boot-gate.
|
|
2
|
+
// Removes chosen keys from the headers of stored events.
|
|
3
|
+
export { scrubEventHeaderKeys, } from "./event-header-scrub.js";
|
|
2
4
|
// Erases chosen payload fields of stored events and rebuilds the projections fed by them.
|
|
3
5
|
export { scrubEventPayloadFields, } from "./event-payload-scrub.js";
|
|
4
6
|
export { assertKumikoSchemaCurrent, SchemaDriftError, } from "./kumiko-drift.js";
|
|
@@ -1,4 +1,5 @@
|
|
|
1
1
|
import type { DbConnection } from "../db/connection.ts";
|
|
2
|
+
import type { FeatureDefinition } from "../engine/types/index.ts";
|
|
2
3
|
export type ChecksumMismatch = {
|
|
3
4
|
readonly id: string;
|
|
4
5
|
readonly expected: string;
|
|
@@ -14,13 +15,15 @@ export type KumikoDriftReport = {
|
|
|
14
15
|
readonly checksumMismatches: readonly ChecksumMismatch[];
|
|
15
16
|
readonly missingTables: readonly string[];
|
|
16
17
|
readonly missingColumns: readonly MissingColumns[];
|
|
18
|
+
/** Tables the booted features declare that the snapshot lacks. */
|
|
19
|
+
readonly tablesMissingFromSnapshot: readonly string[];
|
|
17
20
|
};
|
|
18
21
|
export declare class SchemaDriftError extends Error {
|
|
19
22
|
readonly report: KumikoDriftReport;
|
|
20
23
|
constructor(message: string, report: KumikoDriftReport);
|
|
21
24
|
}
|
|
22
|
-
export declare function detectKumikoDrift(db: DbConnection, migrationsDir: string): Promise<KumikoDriftReport>;
|
|
25
|
+
export declare function detectKumikoDrift(db: DbConnection, migrationsDir: string, bootedFeatures?: readonly FeatureDefinition[]): Promise<KumikoDriftReport>;
|
|
23
26
|
export declare function formatKumikoDriftReport(report: KumikoDriftReport): string;
|
|
24
27
|
/** Throws SchemaDriftError with a human-readable message when the DB is not
|
|
25
28
|
* current with the checked-in kumiko/migrations. */
|
|
26
|
-
export declare function assertKumikoSchemaCurrent(db: DbConnection, migrationsDir: string): Promise<void>;
|
|
29
|
+
export declare function assertKumikoSchemaCurrent(db: DbConnection, migrationsDir: string, bootedFeatures?: readonly FeatureDefinition[]): Promise<void>;
|
|
@@ -10,13 +10,19 @@
|
|
|
10
10
|
// is present in the live schema. A migrated-but-incomplete table (snapshot
|
|
11
11
|
// richer than the DB — e.g. a ride-along column the generator once missed)
|
|
12
12
|
// would otherwise surface only as a runtime-500 on the first write.
|
|
13
|
+
// 4. Booted tables covered: with a snapshot, every table the booted features declare
|
|
14
|
+
// (collectTableMetas, the generator's source) is in it. A tooling feature list that
|
|
15
|
+
// differs from the boot (includeBundled) would otherwise leave tables out of the
|
|
16
|
+
// generated schema unnoticed.
|
|
13
17
|
//
|
|
14
18
|
// Contract (unchanged from the legacy gate): boot VALIDATES only, never
|
|
15
|
-
// applies. Apply is the deploy-step `kumiko schema apply` (runMigrationsFromDir).
|
|
19
|
+
// applies. Apply is the deploy-step `bun /app/kumiko.js schema apply` (runMigrationsFromDir).
|
|
16
20
|
import { existsSync } from "node:fs";
|
|
17
21
|
import { join } from "node:path";
|
|
22
|
+
import { collectTableMetas } from "../db/collect-table-metas.js";
|
|
18
23
|
import { loadSnapshotJson } from "../db/migrate-generator.js";
|
|
19
24
|
import { fetchAppliedMigrations, loadMigrationsFromDir } from "../db/migrate-runner.js";
|
|
25
|
+
import { PRODUCTION_SCHEMA_COMMAND_HINT } from "../db/production-schema-command-hint.js";
|
|
20
26
|
import { columnNamesOf, tableExists } from "../db/schema-inspection.js";
|
|
21
27
|
const SNAPSHOT_FILENAME = ".snapshot.json";
|
|
22
28
|
export class SchemaDriftError extends Error {
|
|
@@ -27,7 +33,7 @@ export class SchemaDriftError extends Error {
|
|
|
27
33
|
this.report = report;
|
|
28
34
|
}
|
|
29
35
|
}
|
|
30
|
-
export async function detectKumikoDrift(db, migrationsDir) {
|
|
36
|
+
export async function detectKumikoDrift(db, migrationsDir, bootedFeatures) {
|
|
31
37
|
// A newer framework version may not have generated `./kumiko/migrations` yet
|
|
32
38
|
// (for example, a first upgrade or custom schema setup without `kumiko schema
|
|
33
39
|
// generate`). Treat this as no local migrations and therefore no drift, matching
|
|
@@ -35,10 +41,17 @@ export async function detectKumikoDrift(db, migrationsDir) {
|
|
|
35
41
|
// calls `readdirSync`, which throws synchronous ENOENT as a plain Error instead
|
|
36
42
|
// of SchemaDriftError and causes an unhandled boot failure.
|
|
37
43
|
if (!existsSync(migrationsDir)) {
|
|
38
|
-
return {
|
|
44
|
+
return {
|
|
45
|
+
ok: true,
|
|
46
|
+
pending: [],
|
|
47
|
+
checksumMismatches: [],
|
|
48
|
+
missingTables: [],
|
|
49
|
+
missingColumns: [],
|
|
50
|
+
tablesMissingFromSnapshot: [],
|
|
51
|
+
};
|
|
39
52
|
}
|
|
40
53
|
const local = loadMigrationsFromDir(migrationsDir);
|
|
41
|
-
// A fresh database may not have the tracking table because `kumiko schema apply`
|
|
54
|
+
// A fresh database may not have the tracking table because `bun /app/kumiko.js schema apply`
|
|
42
55
|
// has never run. Treat that as no applied migrations, so all local migrations are
|
|
43
56
|
// pending rather than reporting an error.
|
|
44
57
|
const trackingExists = await tableExists(db, "_kumiko_migrations");
|
|
@@ -62,7 +75,14 @@ export async function detectKumikoDrift(db, migrationsDir) {
|
|
|
62
75
|
const snapshot = loadSnapshotJson(join(migrationsDir, SNAPSHOT_FILENAME));
|
|
63
76
|
const missingTables = [];
|
|
64
77
|
const missingColumns = [];
|
|
78
|
+
let tablesMissingFromSnapshot = [];
|
|
65
79
|
if (snapshot) {
|
|
80
|
+
if (bootedFeatures !== undefined) {
|
|
81
|
+
const inSnapshot = new Set(snapshot.tables.map((t) => t.tableName));
|
|
82
|
+
tablesMissingFromSnapshot = collectTableMetas(bootedFeatures)
|
|
83
|
+
.map((meta) => meta.tableName)
|
|
84
|
+
.filter((name) => !inSnapshot.has(name));
|
|
85
|
+
}
|
|
66
86
|
const existence = await Promise.all(snapshot.tables.map((t) => tableExists(db, t.tableName).then((exists) => ({ t, exists }))));
|
|
67
87
|
const present = [];
|
|
68
88
|
for (const { t, exists } of existence) {
|
|
@@ -84,11 +104,13 @@ export async function detectKumikoDrift(db, migrationsDir) {
|
|
|
84
104
|
ok: pending.length === 0 &&
|
|
85
105
|
checksumMismatches.length === 0 &&
|
|
86
106
|
missingTables.length === 0 &&
|
|
87
|
-
missingColumns.length === 0
|
|
107
|
+
missingColumns.length === 0 &&
|
|
108
|
+
tablesMissingFromSnapshot.length === 0,
|
|
88
109
|
pending,
|
|
89
110
|
checksumMismatches,
|
|
90
111
|
missingTables,
|
|
91
112
|
missingColumns,
|
|
113
|
+
tablesMissingFromSnapshot,
|
|
92
114
|
};
|
|
93
115
|
}
|
|
94
116
|
export function formatKumikoDriftReport(report) {
|
|
@@ -118,12 +140,20 @@ export function formatKumikoDriftReport(report) {
|
|
|
118
140
|
lines.push(` - ${m.table}: ${m.columns.join(", ")}`);
|
|
119
141
|
}
|
|
120
142
|
}
|
|
121
|
-
|
|
122
|
-
|
|
123
|
-
|
|
124
|
-
|
|
125
|
-
|
|
126
|
-
lines.
|
|
143
|
+
if (report.tablesMissingFromSnapshot.length > 0) {
|
|
144
|
+
lines.push(` ${report.tablesMissingFromSnapshot.length} booted table(s) missing from the snapshot:`);
|
|
145
|
+
for (const t of report.tablesMissingFromSnapshot)
|
|
146
|
+
lines.push(` - ${t}`);
|
|
147
|
+
}
|
|
148
|
+
return [...lines, "", ...driftRemediationLines(report)].join("\n");
|
|
149
|
+
}
|
|
150
|
+
// Remediation depends on the cause: `bun kumiko-schema apply` handles only pending
|
|
151
|
+
// migrations. A checksum mismatch causes MigrationChecksumMismatchError during
|
|
152
|
+
// apply, and baseline's ON CONFLICT DO NOTHING leaves it in alreadyTracked.
|
|
153
|
+
// A missing table with no pending migration was deleted after apply and cannot be
|
|
154
|
+
// restored by apply.
|
|
155
|
+
function driftRemediationLines(report) {
|
|
156
|
+
const lines = [];
|
|
127
157
|
if (report.pending.length > 0) {
|
|
128
158
|
lines.push("Run 'bun kumiko-schema apply' to apply the pending migration(s).");
|
|
129
159
|
}
|
|
@@ -141,12 +171,19 @@ export function formatKumikoDriftReport(report) {
|
|
|
141
171
|
lines.push("ride-along column the generator now emits). Run 'bun kumiko-schema generate' to");
|
|
142
172
|
lines.push("produce an ALTER-TABLE migration for the new column(s), then 'bun kumiko-schema apply'.");
|
|
143
173
|
}
|
|
144
|
-
|
|
174
|
+
if (report.tablesMissingFromSnapshot.length > 0) {
|
|
175
|
+
lines.push("Booted features declare tables the generated schema lacks — kumiko.config.ts");
|
|
176
|
+
lines.push("includeBundled/feature list differs from the boot; run 'kumiko schema generate'.");
|
|
177
|
+
}
|
|
178
|
+
if (report.pending.length > 0 || report.missingColumns.length > 0) {
|
|
179
|
+
lines.push(PRODUCTION_SCHEMA_COMMAND_HINT);
|
|
180
|
+
}
|
|
181
|
+
return lines;
|
|
145
182
|
}
|
|
146
183
|
/** Throws SchemaDriftError with a human-readable message when the DB is not
|
|
147
184
|
* current with the checked-in kumiko/migrations. */
|
|
148
|
-
export async function assertKumikoSchemaCurrent(db, migrationsDir) {
|
|
149
|
-
const report = await detectKumikoDrift(db, migrationsDir);
|
|
185
|
+
export async function assertKumikoSchemaCurrent(db, migrationsDir, bootedFeatures) {
|
|
186
|
+
const report = await detectKumikoDrift(db, migrationsDir, bootedFeatures);
|
|
150
187
|
if (!report.ok)
|
|
151
188
|
throw new SchemaDriftError(formatKumikoDriftReport(report), report);
|
|
152
189
|
}
|
|
@@ -14,7 +14,7 @@ import { instant, table as pgTable, sql, text } from "../db/dialect.js";
|
|
|
14
14
|
import { deleteMany, selectMany, upsertOnConflict } from "../db/query.js";
|
|
15
15
|
import { readRebuildMarker } from "../db/rebuild-marker.js";
|
|
16
16
|
import { tableExists } from "../db/schema-inspection.js";
|
|
17
|
-
import {
|
|
17
|
+
import { pushTableIfMissing } from "../db/table-push.js";
|
|
18
18
|
import { createFallbackLogger } from "../logging/utils.js";
|
|
19
19
|
import { rebuildMultiStreamProjection, rebuildProjection } from "../pipeline/index.js";
|
|
20
20
|
import { buildProjectionTableIndex } from "./projection-table-index.js";
|
|
@@ -24,10 +24,9 @@ export const pendingRebuildsTable = pgTable("kumiko_pending_rebuilds", {
|
|
|
24
24
|
queuedAt: instant("queued_at", { precision: 3 }).notNull().default(sql `now()`),
|
|
25
25
|
});
|
|
26
26
|
export async function createPendingRebuildsTable(db) {
|
|
27
|
-
|
|
28
|
-
|
|
29
|
-
|
|
30
|
-
await unsafePushTables(db, { kumikoPendingRebuilds: pendingRebuildsTable });
|
|
27
|
+
await pushTableIfMissing(db, "public.kumiko_pending_rebuilds", {
|
|
28
|
+
kumikoPendingRebuilds: pendingRebuildsTable,
|
|
29
|
+
});
|
|
31
30
|
}
|
|
32
31
|
/** Reads rebuild markers from freshly applied migrations and queues the
|
|
33
32
|
* affected tables. Upsert: an already-pending table keeps its queue slot
|
|
@@ -2,16 +2,6 @@ export const REDACTED = "[REDACTED]";
|
|
|
2
2
|
// Defaults are intentionally conservative — easier to add a header to the
|
|
3
3
|
// list than to explain a PII leak. All matching is case-insensitive.
|
|
4
4
|
export const DEFAULT_SENSITIVE_CONFIG = {
|
|
5
|
-
redactedHeaders: ["authorization", "cookie", "set-cookie", "x-api-key", "proxy-authorization"],
|
|
6
|
-
redactedQueryParams: [
|
|
7
|
-
"token",
|
|
8
|
-
"access_token",
|
|
9
|
-
"refresh_token",
|
|
10
|
-
"password",
|
|
11
|
-
"secret",
|
|
12
|
-
"api_key",
|
|
13
|
-
"apikey",
|
|
14
|
-
],
|
|
15
5
|
redactedAttributeKeyPatterns: [
|
|
16
6
|
/password/i,
|
|
17
7
|
/secret/i,
|
|
@@ -26,8 +16,6 @@ export function mergeSensitiveConfig(override) {
|
|
|
26
16
|
if (!override)
|
|
27
17
|
return DEFAULT_SENSITIVE_CONFIG;
|
|
28
18
|
return {
|
|
29
|
-
redactedHeaders: override.redactedHeaders ?? DEFAULT_SENSITIVE_CONFIG.redactedHeaders,
|
|
30
|
-
redactedQueryParams: override.redactedQueryParams ?? DEFAULT_SENSITIVE_CONFIG.redactedQueryParams,
|
|
31
19
|
redactedAttributeKeyPatterns: override.redactedAttributeKeyPatterns ??
|
|
32
20
|
DEFAULT_SENSITIVE_CONFIG.redactedAttributeKeyPatterns,
|
|
33
21
|
};
|
|
@@ -1,3 +1,4 @@
|
|
|
1
|
+
import { toKebab } from "@cosmicdrift/kumiko-types/kebab-case";
|
|
1
2
|
import { lockEventConsumersShareMode } from "../db/queries/event-consumer.js";
|
|
2
3
|
import { aggregateWhere, deleteMany, transaction } from "../db/query.js";
|
|
3
4
|
import { runInSystemRowLevelSecurityScope } from "../db/row-level-security-scope.js";
|
|
@@ -45,11 +46,15 @@ function aggregateTypeOfEventType(eventType) {
|
|
|
45
46
|
// that also reads other types would keep rows from the removed ones until a rebuild; guessing
|
|
46
47
|
// which rows belong to which type is not possible (row ids are projection-specific), so the
|
|
47
48
|
// whole run refuses instead of leaving ghost rows that the next rebuild aborts on.
|
|
49
|
+
// Executors write events under the kebab-case form of a camelCase entity name, so both sides are
|
|
50
|
+
// compared kebab-normalised.
|
|
48
51
|
function classifyFeed(involved, removed) {
|
|
49
|
-
const
|
|
52
|
+
const normalizedInvolved = new Set([...involved].map(toKebab));
|
|
53
|
+
const normalizedRemoved = new Set([...removed].map(toKebab));
|
|
54
|
+
const touched = [...normalizedInvolved].filter((type) => normalizedRemoved.has(type));
|
|
50
55
|
if (touched.length === 0)
|
|
51
56
|
return "untouched";
|
|
52
|
-
return touched.length ===
|
|
57
|
+
return touched.length === normalizedInvolved.size ? "wipe" : "mixed";
|
|
53
58
|
}
|
|
54
59
|
function tableMetaOrThrow(table, owner) {
|
|
55
60
|
const meta = asEntityTableMeta(table);
|
|
@@ -92,9 +97,17 @@ function planProjections(registry, removed) {
|
|
|
92
97
|
}
|
|
93
98
|
return wiped;
|
|
94
99
|
}
|
|
100
|
+
function isRegisteredAggregateType(registry, aggregateType) {
|
|
101
|
+
const wanted = toKebab(aggregateType);
|
|
102
|
+
for (const entityName of registry.getAllEntities().keys()) {
|
|
103
|
+
if (entityName === aggregateType || toKebab(entityName) === wanted)
|
|
104
|
+
return true;
|
|
105
|
+
}
|
|
106
|
+
return false;
|
|
107
|
+
}
|
|
95
108
|
async function assertTypesKnown(registry, stats) {
|
|
96
109
|
const unknown = stats
|
|
97
|
-
.filter((s) => s.events === 0 && !registry
|
|
110
|
+
.filter((s) => s.events === 0 && !isRegisteredAggregateType(registry, s.aggregateType))
|
|
98
111
|
.map((s) => s.aggregateType);
|
|
99
112
|
if (unknown.length > 0) {
|
|
100
113
|
throw new AggregateTypeRemovalError(`Unknown aggregate type(s): ${unknown.join(", ")} (no registered entity and no events). Nothing was deleted.`);
|
|
@@ -109,7 +122,7 @@ async function planRemoval(db, registry, types) {
|
|
|
109
122
|
}
|
|
110
123
|
async function deleteIfPresent(tx, table, tableName, types) {
|
|
111
124
|
// Dead-letter and archive tables are created lazily, so a fresh database may not have them.
|
|
112
|
-
if (!(await tableExists(tx,
|
|
125
|
+
if (!(await tableExists(tx, tableName)))
|
|
113
126
|
return 0;
|
|
114
127
|
return deleteMany(tx, table, { aggregateType: [...types] });
|
|
115
128
|
}
|
|
@@ -20,6 +20,8 @@ export declare const APP_CONTEXT_KEY_ROLES: {
|
|
|
20
20
|
readonly _notifyFactory: "service";
|
|
21
21
|
readonly _notifyInTransactionFactory: "service";
|
|
22
22
|
readonly _notifyAfterCommitFactory: "service";
|
|
23
|
+
readonly _deliveryAttemptLogFactory: "service";
|
|
24
|
+
readonly _logOwnDeliveryAttempt: "service";
|
|
23
25
|
readonly _escapeHatchAuditSink: "service";
|
|
24
26
|
readonly db: "wiring";
|
|
25
27
|
readonly systemDb: "wiring";
|
|
@@ -20,6 +20,8 @@ export const APP_CONTEXT_KEY_ROLES = {
|
|
|
20
20
|
_notifyFactory: "service",
|
|
21
21
|
_notifyInTransactionFactory: "service",
|
|
22
22
|
_notifyAfterCommitFactory: "service",
|
|
23
|
+
_deliveryAttemptLogFactory: "service",
|
|
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
|