@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
package/dist/db/table-builder.js
CHANGED
|
@@ -2,7 +2,7 @@ import { KUMIKO_META_SYMBOL } from "@cosmicdrift/kumiko-types/schema-table-types
|
|
|
2
2
|
import { toSnakeCase } from "../utils/case.js";
|
|
3
3
|
import { buildEntityIndexes } from "./entity-table-indexes.js";
|
|
4
4
|
import { markExecutorManagedTable } from "./executor-managed-tables.js";
|
|
5
|
-
import { columnHandleName } from "./table-introspection.js";
|
|
5
|
+
import { asEntityTableMeta, columnHandleName } from "./table-introspection.js";
|
|
6
6
|
export { toSnakeCase } from "../utils/case.js";
|
|
7
7
|
import { bigint, boolean, decimalColumn, doublePrecision, instant, integer, jsonb, moneyAmount, table as pgTable, plainDate, serial, sql, text, uuid, } from "./dialect.js";
|
|
8
8
|
export { SOFT_DELETE_LIVE_ROW_PREDICATE } from "./entity-table-indexes.js";
|
|
@@ -117,7 +117,7 @@ const COLUMN_EMITTERS = {
|
|
|
117
117
|
function emitFieldColumns(type, name, field, entity) {
|
|
118
118
|
// A type from untyped input must not reach an Object.prototype member.
|
|
119
119
|
if (!Object.hasOwn(COLUMN_EMITTERS, type)) {
|
|
120
|
-
throw new Error(`[Kumiko] unhandled field type: ${String(
|
|
120
|
+
throw new Error(`[Kumiko] unhandled field type: ${String(type)}`);
|
|
121
121
|
}
|
|
122
122
|
const emit = COLUMN_EMITTERS[type];
|
|
123
123
|
return emit(name, toSnakeCase(name), field, entity);
|
|
@@ -198,6 +198,10 @@ const ROW_META_WITH_SOFT_DELETE = new Set(Object.keys(buildBaseColumns(true)));
|
|
|
198
198
|
export function rowMetaFieldNames(softDelete) {
|
|
199
199
|
return softDelete ? ROW_META_WITH_SOFT_DELETE : ROW_META_BASE;
|
|
200
200
|
}
|
|
201
|
+
function writeTableMeta(table, meta) {
|
|
202
|
+
// The meta slot is symbol-keyed and set by table(); it is absent from the static table type.
|
|
203
|
+
table[KUMIKO_META_SYMBOL] = meta;
|
|
204
|
+
}
|
|
201
205
|
// pgTable's own meta stamp sees neither entity.tenancy nor that this table is an executor-managed projection;
|
|
202
206
|
// patch both so db.global()'s runtime guards match the type brands.
|
|
203
207
|
function stampEntityTableMeta(table, entity) {
|
|
@@ -205,11 +209,12 @@ function stampEntityTableMeta(table, entity) {
|
|
|
205
209
|
// skip: no meta stamp present — nothing to patch
|
|
206
210
|
if (!meta)
|
|
207
211
|
return;
|
|
208
|
-
table
|
|
212
|
+
writeTableMeta(table, {
|
|
209
213
|
...meta,
|
|
210
214
|
source: "managed",
|
|
211
215
|
...(entity.tenancy === "global" && { tenancy: "global" }),
|
|
212
|
-
|
|
216
|
+
...(entity.systemRowsReadable === true && { systemRowsReadable: true }),
|
|
217
|
+
});
|
|
213
218
|
}
|
|
214
219
|
/**
|
|
215
220
|
* Stamps `tenancy: "global"` onto a `table()`/SchemaTable's meta in place.
|
|
@@ -225,13 +230,18 @@ export function declareGlobalTenancy(table) {
|
|
|
225
230
|
'declared tenancy: "global" — a global table\'s rows carry the system tenant, not a ' +
|
|
226
231
|
"per-row tenant identity.");
|
|
227
232
|
}
|
|
228
|
-
table
|
|
229
|
-
...meta,
|
|
230
|
-
tenancy: "global",
|
|
231
|
-
};
|
|
233
|
+
writeTableMeta(table, { ...meta, tenancy: "global" });
|
|
232
234
|
// @cast-boundary phantom-brand — TenancyBrand<"global"> is a phantom marker with no runtime representation.
|
|
233
235
|
return table;
|
|
234
236
|
}
|
|
237
|
+
/** Stamps `systemRowsReadable` onto an entity table's meta in place (no-op if already set). */
|
|
238
|
+
export function declareSystemRowsReadable(table) {
|
|
239
|
+
const meta = KUMIKO_META_SYMBOL in table ? asEntityTableMeta(table) : undefined;
|
|
240
|
+
// skip: no meta stamp, or already readable — nothing to patch
|
|
241
|
+
if (!meta || meta.systemRowsReadable === true)
|
|
242
|
+
return;
|
|
243
|
+
writeTableMeta(table, { ...meta, systemRowsReadable: true });
|
|
244
|
+
}
|
|
235
245
|
// The featureName prefix is inserted between read_ and the base name so all
|
|
236
246
|
// read models consistently start with `read_`, whether or not featureName is set:
|
|
237
247
|
// featureName="shop", base="read_orders" → "read_shop_orders"
|
package/dist/db/table-info.d.ts
CHANGED
|
@@ -1,4 +1,3 @@
|
|
|
1
|
-
import type { TableLike } from "./query.ts";
|
|
2
1
|
export type TableInfo = {
|
|
3
2
|
readonly name: string;
|
|
4
3
|
readonly columnOf: (field: string) => string;
|
|
@@ -7,4 +6,4 @@ export type TableInfo = {
|
|
|
7
6
|
readonly fieldOf: (column: string) => string;
|
|
8
7
|
readonly hasColumn: (fieldOrColumn: string) => boolean;
|
|
9
8
|
};
|
|
10
|
-
export declare function extractTableInfo(table:
|
|
9
|
+
export declare function extractTableInfo(table: unknown): TableInfo;
|
|
@@ -1,6 +1,9 @@
|
|
|
1
1
|
import type { EntityTableMeta } from "@cosmicdrift/kumiko-types/entity-table-meta-types";
|
|
2
2
|
import type { Writable } from "@cosmicdrift/kumiko-types/executor-brand";
|
|
3
|
+
import { type SchemaTable } from "@cosmicdrift/kumiko-types/schema-table-types";
|
|
3
4
|
export declare function isEntityTableMeta(value: unknown): value is EntityTableMeta;
|
|
5
|
+
/** True for tables built by table(): all three identity slots are present and well-formed. */
|
|
6
|
+
export declare function isSchemaTable(value: unknown): value is SchemaTable;
|
|
4
7
|
export declare function asEntityTableMeta(table: unknown): EntityTableMeta | undefined;
|
|
5
8
|
export declare function requireEntityTableMeta(table: unknown, tableName: string): EntityTableMeta;
|
|
6
9
|
/** Physical table name from the unshadowable name symbol; undefined when absent. */
|
|
@@ -17,6 +17,12 @@ export function isEntityTableMeta(value) {
|
|
|
17
17
|
"source" in value &&
|
|
18
18
|
(value.source === "managed" || value.source === "unmanaged"));
|
|
19
19
|
}
|
|
20
|
+
/** True for tables built by table(): all three identity slots are present and well-formed. */
|
|
21
|
+
export function isSchemaTable(value) {
|
|
22
|
+
return (schemaTableName(value) !== undefined &&
|
|
23
|
+
tableColumnsOf(value) !== undefined &&
|
|
24
|
+
asEntityTableMeta(value) !== undefined);
|
|
25
|
+
}
|
|
20
26
|
export function asEntityTableMeta(table) {
|
|
21
27
|
if (typeof table !== "object" || table === null)
|
|
22
28
|
return undefined;
|
package/dist/db/table-push.d.ts
CHANGED
|
@@ -31,3 +31,4 @@ export declare function ensureTableRowLevelSecurity(db: DbConnection, table: unk
|
|
|
31
31
|
export declare function unsafePushTables(db: DbConnection, tables: Record<string, unknown>, prevTables?: Record<string, unknown>, options?: {
|
|
32
32
|
readonly rowLevelSecurity?: RowLevelSecurityMode;
|
|
33
33
|
}): Promise<void>;
|
|
34
|
+
export declare function pushTableIfMissing(db: DbConnection, fullyQualifiedName: string, tables: Record<string, unknown>): Promise<void>;
|
package/dist/db/table-push.js
CHANGED
|
@@ -93,7 +93,13 @@ export async function unsafePushTables(db, tables, prevTables, options = {}) {
|
|
|
93
93
|
await applyTableRowLevelSecurity(db, meta);
|
|
94
94
|
}
|
|
95
95
|
}
|
|
96
|
-
//
|
|
96
|
+
// Idempotent bootstrap for a framework meta-table that several boot paths create.
|
|
97
|
+
export async function pushTableIfMissing(db, fullyQualifiedName, tables) {
|
|
98
|
+
// skip: table already exists — bootstrap runs from multiple paths
|
|
99
|
+
if (await tableExists(db, fullyQualifiedName))
|
|
100
|
+
return;
|
|
101
|
+
await unsafePushTables(db, tables);
|
|
102
|
+
}
|
|
97
103
|
function renderColumnType(col) {
|
|
98
104
|
return pgTypeToSqlType(col.pgType);
|
|
99
105
|
}
|
|
@@ -7,7 +7,10 @@ export declare function isBoundTenantDb(value: unknown): value is TenantDb;
|
|
|
7
7
|
export declare function isDbRunner(value: unknown): value is DbRunner;
|
|
8
8
|
export declare function bindTenantDbRunner(tenantDb: TenantDb, runner: DbRunner, modeOptions: TenantDbModeOptions, tenantId: TenantId): void;
|
|
9
9
|
export declare function tenantDbRunner(tenantDb: TenantDb): DbRunner;
|
|
10
|
+
export declare function isGlobalTenancyTable(table: unknown): boolean;
|
|
11
|
+
export declare function tenantDbRunnerForTable(tenantDb: TenantDb, table: unknown): DbRunner;
|
|
10
12
|
export declare function denyTenantDbWrites(tenantDb: TenantDb, reason: string): void;
|
|
11
13
|
export declare function tenantDbWritesDeniedReason(tenantDb: TenantDb): string | undefined;
|
|
12
14
|
export declare function tenantDbWritesDeniedError(operation: string, reason: string): InternalError;
|
|
13
15
|
export declare function tenantDbWriteRunner(tenantDb: TenantDb, operation: string): DbRunner;
|
|
16
|
+
export declare function tenantDbWriteRunnerForTable(tenantDb: TenantDb, operation: string, table: unknown): DbRunner;
|
|
@@ -1,6 +1,7 @@
|
|
|
1
1
|
import { propertyOf } from "@cosmicdrift/kumiko-types/type-guards";
|
|
2
2
|
import { InternalError } from "../errors/index.js";
|
|
3
|
-
import { tenantDbRowLevelSecurityScope, withRowLevelSecurityScope, } from "./row-level-security-scope.js";
|
|
3
|
+
import { systemScopedRunner, tenantDbRowLevelSecurityScope, withRowLevelSecurityScope, } from "./row-level-security-scope.js";
|
|
4
|
+
import { asEntityTableMeta } from "./table-introspection.js";
|
|
4
5
|
const tenantDbRunners = new WeakMap();
|
|
5
6
|
export function isBoundTenantDb(value) {
|
|
6
7
|
return typeof value === "object" && value !== null && tenantDbRunners.has(value);
|
|
@@ -23,6 +24,17 @@ export function tenantDbRunner(tenantDb) {
|
|
|
23
24
|
}
|
|
24
25
|
return runner;
|
|
25
26
|
}
|
|
27
|
+
export function isGlobalTenancyTable(table) {
|
|
28
|
+
return asEntityTableMeta(table)?.tenancy === "global";
|
|
29
|
+
}
|
|
30
|
+
// Raw statements against one entity table: a global table holds system tenant rows, so its reads run
|
|
31
|
+
// in the system scope like the TenantDb's own statements on it (tenantDbRowLevelSecurityScope).
|
|
32
|
+
export function tenantDbRunnerForTable(tenantDb, table) {
|
|
33
|
+
const runner = tenantDbRunner(tenantDb);
|
|
34
|
+
return isGlobalTenancyTable(table)
|
|
35
|
+
? systemScopedRunner(runner, "global table rows carry the system tenant")
|
|
36
|
+
: runner;
|
|
37
|
+
}
|
|
26
38
|
const writesDeniedReasons = new WeakMap();
|
|
27
39
|
export function denyTenantDbWrites(tenantDb, reason) {
|
|
28
40
|
writesDeniedReasons.set(tenantDb, reason);
|
|
@@ -43,3 +55,9 @@ export function tenantDbWriteRunner(tenantDb, operation) {
|
|
|
43
55
|
throw tenantDbWritesDeniedError(operation, reason);
|
|
44
56
|
return tenantDbRunner(tenantDb);
|
|
45
57
|
}
|
|
58
|
+
export function tenantDbWriteRunnerForTable(tenantDb, operation, table) {
|
|
59
|
+
const reason = writesDeniedReasons.get(tenantDb);
|
|
60
|
+
if (reason !== undefined)
|
|
61
|
+
throw tenantDbWritesDeniedError(operation, reason);
|
|
62
|
+
return tenantDbRunnerForTable(tenantDb, table);
|
|
63
|
+
}
|
|
@@ -3,4 +3,5 @@ export declare function registerRunnerProxyTarget(proxy: HandleKey, target: Hand
|
|
|
3
3
|
export declare function openSerializedSavepoint<T>(transactionHandle: HandleKey & {
|
|
4
4
|
savepoint: <R>(fn: (sp: unknown) => Promise<R>) => Promise<R>;
|
|
5
5
|
}, fn: (sp: unknown) => Promise<T>): Promise<T>;
|
|
6
|
+
export declare function runStatementBehindPendingUnits<T>(handle: HandleKey, statement: () => T): Promise<Awaited<T>>;
|
|
6
7
|
export {};
|
|
@@ -24,29 +24,35 @@ function transactionKeyOf(handle) {
|
|
|
24
24
|
}
|
|
25
25
|
function chainFor(transactionKey) {
|
|
26
26
|
const nested = nestedChainsInScope.getStore()?.get(transactionKey);
|
|
27
|
-
|
|
27
|
+
// Background tasks started inside a unit outlive it and inherit its scope; once the unit has
|
|
28
|
+
// finished their work must queue on the root chain again.
|
|
29
|
+
if (nested?.active)
|
|
28
30
|
return nested;
|
|
29
31
|
const root = rootChains.get(transactionKey);
|
|
30
32
|
if (root)
|
|
31
33
|
return root;
|
|
32
|
-
const created = { tail: Promise.resolve() };
|
|
34
|
+
const created = { tail: Promise.resolve(), active: true, pending: 0 };
|
|
33
35
|
rootChains.set(transactionKey, created);
|
|
34
36
|
return created;
|
|
35
37
|
}
|
|
36
38
|
async function runOnChain(transactionKey, work) {
|
|
37
39
|
const chain = chainFor(transactionKey);
|
|
38
40
|
const previous = chain.tail;
|
|
41
|
+
chain.pending++;
|
|
39
42
|
let release = () => { };
|
|
40
43
|
chain.tail = new Promise((resolve) => {
|
|
41
44
|
release = resolve;
|
|
42
45
|
});
|
|
43
46
|
await previous;
|
|
47
|
+
const nestedChain = { tail: Promise.resolve(), active: true, pending: 0 };
|
|
44
48
|
try {
|
|
45
49
|
const scope = new Map(nestedChainsInScope.getStore());
|
|
46
|
-
scope.set(transactionKey,
|
|
50
|
+
scope.set(transactionKey, nestedChain);
|
|
47
51
|
return await nestedChainsInScope.run(scope, work);
|
|
48
52
|
}
|
|
49
53
|
finally {
|
|
54
|
+
nestedChain.active = false;
|
|
55
|
+
chain.pending--;
|
|
50
56
|
release();
|
|
51
57
|
}
|
|
52
58
|
}
|
|
@@ -58,3 +64,14 @@ export function openSerializedSavepoint(transactionHandle, fn) {
|
|
|
58
64
|
return fn(sp);
|
|
59
65
|
}));
|
|
60
66
|
}
|
|
67
|
+
// Runs a statement on a transaction handle. With no unit queued on the current chain (the nested
|
|
68
|
+
// chain inside a running unit, else the root) it goes straight to the driver; otherwise it queues
|
|
69
|
+
// behind the pending units of that chain.
|
|
70
|
+
export async function runStatementBehindPendingUnits(handle, statement) {
|
|
71
|
+
const transactionKey = transactionKeyOf(handle);
|
|
72
|
+
const nested = nestedChainsInScope.getStore()?.get(transactionKey);
|
|
73
|
+
const chain = nested?.active ? nested : rootChains.get(transactionKey);
|
|
74
|
+
if ((chain?.pending ?? 0) === 0)
|
|
75
|
+
return await statement();
|
|
76
|
+
return runOnChain(transactionKey, async () => await statement());
|
|
77
|
+
}
|
package/dist/db/where-clause.js
CHANGED
|
@@ -138,8 +138,10 @@ function emitNotEqual(target, operator) {
|
|
|
138
138
|
}
|
|
139
139
|
function emitIn(target, operator) {
|
|
140
140
|
const operand = operator.in;
|
|
141
|
-
if (
|
|
141
|
+
if (operand === undefined)
|
|
142
142
|
return undefined;
|
|
143
|
+
if (!Array.isArray(operand))
|
|
144
|
+
throw new Error(`where: in on column "${target.column}" needs an array`);
|
|
143
145
|
if (target.pgType === "jsonb")
|
|
144
146
|
return jsonbContainsAny(target, operand);
|
|
145
147
|
if (operand.length === 0)
|
|
@@ -148,8 +150,11 @@ function emitIn(target, operator) {
|
|
|
148
150
|
}
|
|
149
151
|
function emitNotIn(target, operator) {
|
|
150
152
|
const operand = operator.notIn;
|
|
151
|
-
if (
|
|
153
|
+
if (operand === undefined)
|
|
152
154
|
return undefined;
|
|
155
|
+
if (!Array.isArray(operand)) {
|
|
156
|
+
throw new Error(`where: notIn on column "${target.column}" needs an array`);
|
|
157
|
+
}
|
|
153
158
|
if (target.pgType === "jsonb") {
|
|
154
159
|
throw new Error(`where: notIn is not supported on jsonb column "${target.column}"`);
|
|
155
160
|
}
|
|
@@ -177,6 +182,10 @@ function operatorConditions(target, operator) {
|
|
|
177
182
|
if (condition !== undefined)
|
|
178
183
|
conditions.push(condition);
|
|
179
184
|
}
|
|
185
|
+
// An empty result would drop the WHERE and turn deleteMany/selectMany into whole-table operations.
|
|
186
|
+
if (conditions.length === 0) {
|
|
187
|
+
throw new Error(`where: operator on column "${target.column}" has no defined operand`);
|
|
188
|
+
}
|
|
180
189
|
return conditions;
|
|
181
190
|
}
|
|
182
191
|
// Blind-index OR rewrite: if the column has a bidx
|
|
@@ -0,0 +1,25 @@
|
|
|
1
|
+
import type { EntityDefinition } from "@cosmicdrift/kumiko-types/fields";
|
|
2
|
+
import type { EntityId } from "@cosmicdrift/kumiko-types/identifiers";
|
|
3
|
+
import type { SessionUser, TenantId } from "../engine/types/index.ts";
|
|
4
|
+
import type { WriteFailure } from "../errors/index.ts";
|
|
5
|
+
import type { DbRow } from "./connection.ts";
|
|
6
|
+
export declare function createOwnershipFailure(options: {
|
|
7
|
+
readonly entity: EntityDefinition;
|
|
8
|
+
readonly entityName: string;
|
|
9
|
+
readonly user: SessionUser;
|
|
10
|
+
readonly streamTenantId: TenantId | undefined;
|
|
11
|
+
readonly payloadWithoutId: Record<string, unknown>;
|
|
12
|
+
readonly data: DbRow;
|
|
13
|
+
readonly applyDefaults: (payload: Record<string, unknown>) => Record<string, unknown>;
|
|
14
|
+
}): WriteFailure | undefined;
|
|
15
|
+
export declare function updateOwnershipFailure(options: {
|
|
16
|
+
readonly entity: EntityDefinition;
|
|
17
|
+
readonly entityName: string;
|
|
18
|
+
readonly user: SessionUser;
|
|
19
|
+
readonly streamTenantId: TenantId | undefined;
|
|
20
|
+
readonly id: EntityId;
|
|
21
|
+
readonly submittedChanges: Record<string, unknown>;
|
|
22
|
+
readonly previous: DbRow;
|
|
23
|
+
readonly changes: DbRow;
|
|
24
|
+
readonly mergedNew: Record<string, unknown>;
|
|
25
|
+
}): WriteFailure | undefined;
|
|
@@ -0,0 +1,82 @@
|
|
|
1
|
+
import { checkWriteFieldOwnership } from "../engine/field-access.js";
|
|
2
|
+
import { userCanCreateFieldRow, userCanWriteFieldRow } from "../engine/ownership.js";
|
|
3
|
+
import { ownershipSubject } from "./event-store-executor-context.js";
|
|
4
|
+
import { ownershipDeniedFailure } from "./event-store-executor-write-steps.js";
|
|
5
|
+
export function createOwnershipFailure(options) {
|
|
6
|
+
const { entity, entityName, user, streamTenantId, payloadWithoutId, data, applyDefaults } = options;
|
|
7
|
+
// H.2 — entity-level write-ownership on create. No oldRow exists, so
|
|
8
|
+
// only the new row is checked. No Straddle concern for creates.
|
|
9
|
+
if (!userCanCreateFieldRow(ownershipSubject(user, streamTenantId), entity.access?.write, data)) {
|
|
10
|
+
return ownershipDeniedFailure({
|
|
11
|
+
scope: "entity",
|
|
12
|
+
entityName,
|
|
13
|
+
action: "create",
|
|
14
|
+
userId: user.id,
|
|
15
|
+
});
|
|
16
|
+
}
|
|
17
|
+
// Field-level write-ownership on create — mirror of entity-level but
|
|
18
|
+
// per declared field. Role-level was already checked by the
|
|
19
|
+
// dispatcher; here we enforce ownership-rules against the new row.
|
|
20
|
+
//
|
|
21
|
+
// Which fields get checked is scoped to the pre-hook payload
|
|
22
|
+
// — a hook-derived field the user never submitted must not be
|
|
23
|
+
// field-ownership-checked against the user. The rule for a checked
|
|
24
|
+
// field is still evaluated against the full post-hook row (`data`) —
|
|
25
|
+
// an ownership rule can reference a column only a hook populates.
|
|
26
|
+
const fieldDeniedCreate = checkWriteFieldOwnership(entity, applyDefaults(payloadWithoutId), ownershipSubject(user, streamTenantId), undefined, data);
|
|
27
|
+
if (fieldDeniedCreate) {
|
|
28
|
+
return ownershipDeniedFailure({
|
|
29
|
+
scope: "field",
|
|
30
|
+
entityName,
|
|
31
|
+
action: "create",
|
|
32
|
+
field: fieldDeniedCreate,
|
|
33
|
+
userId: user.id,
|
|
34
|
+
});
|
|
35
|
+
}
|
|
36
|
+
return undefined;
|
|
37
|
+
}
|
|
38
|
+
export function updateOwnershipFailure(options) {
|
|
39
|
+
const { entity, entityName, user, streamTenantId, id, submittedChanges, previous, changes, mergedNew, } = options;
|
|
40
|
+
// H.2 — entity-level write-ownership on update. Load old row (already
|
|
41
|
+
// done above), build post-change row via shallow merge. Straddle-safe
|
|
42
|
+
// multi-role check: at least one role must accept BOTH old and new —
|
|
43
|
+
// prevents the attack where role A passes old, role B passes new and
|
|
44
|
+
// aggregation would wrongly allow a row-grab.
|
|
45
|
+
if (!userCanWriteFieldRow(ownershipSubject(user, streamTenantId), entity.access?.write, previous, mergedNew)) {
|
|
46
|
+
return ownershipDeniedFailure({
|
|
47
|
+
scope: "entity",
|
|
48
|
+
entityName,
|
|
49
|
+
action: "update",
|
|
50
|
+
userId: user.id,
|
|
51
|
+
entityId: id,
|
|
52
|
+
});
|
|
53
|
+
}
|
|
54
|
+
// Field-level write-ownership on update — this is the path the
|
|
55
|
+
// dispatcher could not evaluate (no oldRow). Now that we have
|
|
56
|
+
// `previous`, we can run the ownership rules per field against both
|
|
57
|
+
// sides and reject individual fields the user isn't entitled to
|
|
58
|
+
// touch on this specific row.
|
|
59
|
+
//
|
|
60
|
+
// Which fields get checked is scoped to `payload.changes` (the user's
|
|
61
|
+
// actual submission), NOT `changes` (post-preSave-hook data)
|
|
62
|
+
// — a hook-derived field the user never submitted (e.g. a system hook
|
|
63
|
+
// setting `assignedTo`) has no business being field-ownership-checked
|
|
64
|
+
// against the *user*, and doing so rejects writes the user is fully
|
|
65
|
+
// entitled to make. The dispatcher's role-gate (checkWriteFieldAccess)
|
|
66
|
+
// already runs on this same pre-hook payload for consistency. The rule
|
|
67
|
+
// for a checked field is still evaluated against the full post-hook
|
|
68
|
+
// row (`changes` merged onto `previous`) — an ownership rule can
|
|
69
|
+
// reference a column only a hook populates.
|
|
70
|
+
const fieldDeniedUpdate = checkWriteFieldOwnership(entity, submittedChanges, ownershipSubject(user, streamTenantId), previous, changes);
|
|
71
|
+
if (fieldDeniedUpdate) {
|
|
72
|
+
return ownershipDeniedFailure({
|
|
73
|
+
scope: "field",
|
|
74
|
+
entityName,
|
|
75
|
+
action: "update",
|
|
76
|
+
field: fieldDeniedUpdate,
|
|
77
|
+
userId: user.id,
|
|
78
|
+
entityId: id,
|
|
79
|
+
});
|
|
80
|
+
}
|
|
81
|
+
return undefined;
|
|
82
|
+
}
|
|
@@ -1,5 +1,6 @@
|
|
|
1
1
|
import { BOOT_CHECK_RULES } from "./boot-check-rules.js";
|
|
2
|
-
import {
|
|
2
|
+
import { isRuntimeCrash } from "./boot-report.js";
|
|
3
|
+
import { BootRuleFailures, BootRuleViolation, BootValidationError, bootRuleError, } from "./boot-rule.js";
|
|
3
4
|
// r.bootCheck(fn) lets a feature declare its own mount-invariant instead of
|
|
4
5
|
// relying on framework-internal knowledge (the gdpr-storage.ts guards are
|
|
5
6
|
// the framework-owned version of this same idea). Each registered fn gets
|
|
@@ -7,6 +8,9 @@ import { BootRuleFailures, BootRuleViolation, bootRuleError } from "./boot-rule.
|
|
|
7
8
|
// message with the owning feature's name so the error text points back at
|
|
8
9
|
// the feature that declared the check.
|
|
9
10
|
function prefixFailure(failure, prefix) {
|
|
11
|
+
// Already-structured violations of a nested report keep their own rule ids.
|
|
12
|
+
if (failure instanceof BootValidationError)
|
|
13
|
+
return failure;
|
|
10
14
|
const rule = failure instanceof BootRuleViolation ? failure.rule : BOOT_CHECK_RULES.failed;
|
|
11
15
|
return new BootRuleViolation(rule, prefix + failure.message);
|
|
12
16
|
}
|
|
@@ -17,6 +21,8 @@ export function runFeatureBootCheck(feature, check, features) {
|
|
|
17
21
|
check(ctx);
|
|
18
22
|
}
|
|
19
23
|
catch (err) {
|
|
24
|
+
if (isRuntimeCrash(err) || err instanceof BootValidationError)
|
|
25
|
+
throw err;
|
|
20
26
|
if (err instanceof BootRuleViolation)
|
|
21
27
|
throw prefixFailure(err, prefix);
|
|
22
28
|
if (err instanceof BootRuleFailures) {
|
|
@@ -8,11 +8,11 @@ import { bootRuleError } from "./boot-rule.js";
|
|
|
8
8
|
import { validateCardMetaOverflow } from "./card-meta-overflow.js";
|
|
9
9
|
import { validateConfigReads } from "./config-deps.js";
|
|
10
10
|
import { validateDashboardStatNavigate } from "./dashboard-stat-navigate.js";
|
|
11
|
-
import { validateExtensionPreSaveWiring } from "./entity-handler.js";
|
|
12
11
|
import { validateEntityListScreens } from "./entity-list-screens.js";
|
|
13
12
|
import { validateGdprStoragePersistence } from "./gdpr-storage.js";
|
|
14
13
|
import { validateGlobalTenancyEntities } from "./global-tenancy.js";
|
|
15
14
|
import { validateFieldValueTranslations, validateI18nSurfaceKeys, validateRequiredLocales, validateTranslationLocaleConsistency, } from "./i18n-keys.js";
|
|
15
|
+
import { validateListSortAndSummary } from "./list-sort-summary.js";
|
|
16
16
|
import { validateNavCycles } from "./nav.js";
|
|
17
17
|
import { validateProjectionListScreens, validateRelatedListSectionQueries, } from "./projection-list-screens.js";
|
|
18
18
|
import { validateQueryOutputColumns } from "./query-output-columns.js";
|
|
@@ -48,6 +48,10 @@ const APP_CHECKS_AFTER_I18N = [
|
|
|
48
48
|
check: "validateProjectionListScreens",
|
|
49
49
|
run: (c) => validateProjectionListScreens(c.features),
|
|
50
50
|
},
|
|
51
|
+
{
|
|
52
|
+
check: "validateListSortAndSummary",
|
|
53
|
+
run: (c) => validateListSortAndSummary(c.features),
|
|
54
|
+
},
|
|
51
55
|
{
|
|
52
56
|
check: "validateDashboardStatNavigate",
|
|
53
57
|
run: (c) => validateDashboardStatNavigate(c.features),
|
|
@@ -56,10 +60,6 @@ const APP_CHECKS_AFTER_I18N = [
|
|
|
56
60
|
check: "validateRelatedListSectionQueries",
|
|
57
61
|
run: (c) => validateRelatedListSectionQueries(c.features),
|
|
58
62
|
},
|
|
59
|
-
{
|
|
60
|
-
check: "validateExtensionPreSaveWiring",
|
|
61
|
-
run: (c) => validateExtensionPreSaveWiring(c.features),
|
|
62
|
-
},
|
|
63
63
|
{
|
|
64
64
|
check: "validateGdprStoragePersistence",
|
|
65
65
|
run: (c) => validateGdprStoragePersistence(c.features),
|
|
@@ -2,7 +2,7 @@ import { validateAccessDeclarations } from "./access-declarations.js";
|
|
|
2
2
|
import { validateActionWiring, validateFieldWiring } from "./action-wiring.js";
|
|
3
3
|
import { validateApiExposureMatching, validateExtensionUsages } from "./api-ext.js";
|
|
4
4
|
import { collectExposedApis } from "./boot-context.js";
|
|
5
|
-
import { validateCircularDeps,
|
|
5
|
+
import { validateCircularDeps, validateConfigKeyBacking, validateConfigKeyBounds, validateConfigKeyComputed, validateConfigKeyOptionsQuery, validateConfigKeyPiiEncrypted, validateConfigKeyRequired, } from "./config-deps.js";
|
|
6
6
|
import { validateSqlDerivedFields } from "./derived-sql-fields.js";
|
|
7
7
|
import { collectDetailForScreens } from "./detail-screens.js";
|
|
8
8
|
import { validateDerivedFieldCollisions, validateEmbeddedFields, validateEncryptedFields, validateEntityIndexes, validateExtendSchemaCollisions, validateFileFields, validateHandlerAccess, validateLocatedTimestamps, validateLockedWhen, validateMultiStreamProjections, validateReferenceFields, validateSearchableFieldReadAccess, validateTransitions, } from "./entity-handler.js";
|
|
@@ -18,6 +18,7 @@ import { validateQueryRefs } from "./query-refs.js";
|
|
|
18
18
|
import { validateReadGates } from "./read-gate.js";
|
|
19
19
|
import { validateRecordOwnedSubjects } from "./record-owned.js";
|
|
20
20
|
import { validateScreenShortIdCollisions, validateScreens } from "./screens.js";
|
|
21
|
+
import { validateSortNulls } from "./sort-nulls.js";
|
|
21
22
|
import { validateTransferGraph } from "./transfer-graph.js";
|
|
22
23
|
import { validateWorkspaces } from "./workspaces.js";
|
|
23
24
|
function runFeatureChecks(report, checks, feature, ctx) {
|
|
@@ -85,6 +86,7 @@ const FEATURE_CHECKS = [
|
|
|
85
86
|
check: "validateHandlerFieldReferences",
|
|
86
87
|
run: (f, c) => validateHandlerFieldReferences(f, c.featureMap),
|
|
87
88
|
},
|
|
89
|
+
{ check: "validateSortNulls", run: (f) => validateSortNulls(f) },
|
|
88
90
|
{ check: "validateTransitions", run: (f) => validateTransitions(f) },
|
|
89
91
|
{ check: "validateLockedWhen", run: (f) => validateLockedWhen(f) },
|
|
90
92
|
{ check: "validateFieldConditions", run: (f) => validateFieldConditions(f) },
|
|
@@ -97,7 +99,6 @@ const FEATURE_CHECKS = [
|
|
|
97
99
|
{ check: "validateConfigKeyBounds", run: (f) => validateConfigKeyBounds(f) },
|
|
98
100
|
{ check: "validateConfigKeyRequired", run: (f) => validateConfigKeyRequired(f) },
|
|
99
101
|
{ check: "validateConfigKeyComputed", run: (f) => validateConfigKeyComputed(f) },
|
|
100
|
-
{ check: "validateConfigKeyAllowPerRequest", run: (f) => validateConfigKeyAllowPerRequest(f) },
|
|
101
102
|
{ check: "validateConfigKeyBacking", run: (f) => validateConfigKeyBacking(f) },
|
|
102
103
|
{ check: "validateConfigKeyOptionsQuery", run: (f) => validateConfigKeyOptionsQuery(f) },
|
|
103
104
|
{ check: "validateConfigKeyPiiEncrypted", run: (f) => validateConfigKeyPiiEncrypted(f) },
|