@cosmicdrift/kumiko-framework 0.413.1 → 0.415.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/AGENTS.md +5 -2
- package/agents/api/framework-db.md +14 -3
- package/agents/api/framework-engine.md +69 -13
- package/agents/api/framework-errors.md +1 -1
- package/agents/api/framework-event-store.md +14 -0
- package/agents/api/framework-ui-types.md +158 -21
- package/agents/api/renderer-web.md +112 -11
- package/agents/api/testing-helpers.md +3 -2
- package/agents/api/testing-stack.md +3 -0
- package/agents/api/types.md +248 -24
- package/agents/api.md +7 -7
- package/agents/boot-rules.md +66 -10
- package/agents/examples/api-docs.md +2 -6
- package/agents/examples/auth-mfa.md +57 -10
- package/agents/examples/chat-channels.md +2 -0
- package/agents/examples/crypto-shredding-hr.md +63 -1
- package/agents/examples/currencies-global.md +1 -0
- package/agents/examples/env-composition.md +7 -11
- package/agents/examples/managed-pages.md +90 -1
- package/agents/examples/pwa-shell.md +210 -0
- package/agents/examples/rate-limiting.md +3 -3
- package/agents/examples/record-detail-layout.md +1643 -67
- package/agents/examples/workflow-engine.md +16 -12
- package/agents/examples.md +1 -0
- package/agents/features-index.md +4 -2
- package/agents/features.md +22 -7
- package/agents/widgets.md +26 -1
- package/dist/api/api-constants.d.ts +1 -0
- package/dist/api/api-constants.js +4 -0
- package/dist/api/auth-middleware.js +4 -3
- package/dist/api/auth-routes-shared.js +2 -1
- package/dist/api/entity-read-access.d.ts +1 -0
- package/dist/api/entity-read-access.js +18 -0
- package/dist/api/export/export-route.d.ts +6 -1
- package/dist/api/export/export-route.js +27 -1
- package/dist/api/export/export-rows.js +19 -3
- package/dist/api/request-context-internals.d.ts +2 -0
- package/dist/api/request-context-scopes.js +9 -2
- package/dist/api/request-context.js +1 -1
- package/dist/api/routes.d.ts +2 -0
- package/dist/api/routes.js +9 -1
- package/dist/api/server-event-dispatcher.js +3 -0
- package/dist/api/server-extra-routes.js +2 -1
- package/dist/api/server-feature-http-routes.d.ts +9 -0
- package/dist/api/server-feature-http-routes.js +109 -0
- package/dist/api/server-middleware.js +2 -19
- package/dist/api/server-pat-rate-limit-guard.d.ts +3 -0
- package/dist/api/server-pat-rate-limit-guard.js +19 -0
- package/dist/api/server-rate-limit-wiring.d.ts +10 -0
- package/dist/api/server-rate-limit-wiring.js +37 -0
- package/dist/api/server-routes.d.ts +4 -12
- package/dist/api/server-routes.js +12 -171
- package/dist/api/server-schema-route.d.ts +3 -0
- package/dist/api/server-schema-route.js +58 -0
- package/dist/api/server-wiring.js +2 -37
- package/dist/api/server.js +3 -1
- package/dist/compliance/override-schema.js +5 -5
- package/dist/compliance/sub-processors.js +10 -1
- package/dist/crypto/index.d.ts +1 -1
- package/dist/crypto/index.js +1 -1
- package/dist/crypto/pii-field-encryption.d.ts +2 -0
- package/dist/crypto/pii-field-encryption.js +16 -1
- package/dist/db/apply-entity-event.js +4 -0
- package/dist/db/bun-sql-connection-codes.d.ts +1 -0
- package/dist/db/bun-sql-connection-codes.js +7 -0
- package/dist/db/collect-table-metas.js +4 -1
- package/dist/db/config-seed.js +1 -1
- package/dist/db/derived-field-sql.js +15 -13
- package/dist/db/derived-related-sql.d.ts +2 -2
- package/dist/db/derived-related-sql.js +4 -2
- package/dist/db/dialect.d.ts +3 -0
- package/dist/db/dialect.js +1 -3
- package/dist/db/driver-row-coercion.js +2 -2
- package/dist/db/driver-value-preparation.js +1 -1
- package/dist/db/eagerload.js +15 -12
- package/dist/db/entity-table-meta.d.ts +2 -0
- package/dist/db/entity-table-meta.js +7 -0
- package/dist/db/event-store-executor-context.js +13 -8
- package/dist/db/event-store-executor-read-aggregate-currencies.js +2 -2
- package/dist/db/event-store-executor-read-aggregate.js +2 -2
- package/dist/db/event-store-executor-read-filter.d.ts +4 -0
- package/dist/db/event-store-executor-read-filter.js +28 -11
- package/dist/db/event-store-executor-read-search.d.ts +1 -0
- package/dist/db/event-store-executor-read-search.js +6 -6
- package/dist/db/event-store-executor-read-sort.js +3 -3
- package/dist/db/event-store-executor-read-where.js +14 -5
- package/dist/db/event-store-executor-read.js +7 -7
- package/dist/db/event-store-executor-write.js +50 -95
- package/dist/db/executor-managed-tables.js +4 -1
- package/dist/db/index.d.ts +4 -2
- package/dist/db/index.js +4 -2
- package/dist/db/known-table-names.d.ts +1 -0
- package/dist/db/known-table-names.js +7 -5
- package/dist/db/list-aggregate-labels.d.ts +1 -0
- package/dist/db/list-aggregate-labels.js +9 -1
- package/dist/db/migrate-generator.js +23 -4
- package/dist/db/migrate-rls-diff.d.ts +1 -0
- package/dist/db/migrate-rls-diff.js +15 -1
- package/dist/db/migrate-runner.js +2 -2
- package/dist/db/money.d.ts +1 -1
- package/dist/db/money.js +1 -4
- package/dist/db/parent-ref-clause.d.ts +6 -2
- package/dist/db/parent-ref-clause.js +105 -24
- package/dist/db/parent-ref-global-hosts.d.ts +23 -0
- package/dist/db/parent-ref-global-hosts.js +85 -0
- package/dist/db/production-schema-command-hint.d.ts +1 -0
- package/dist/db/production-schema-command-hint.js +3 -0
- package/dist/db/queries/backfill-pii.js +55 -29
- package/dist/db/queries/ddl.js +13 -2
- package/dist/db/queries/event-store-open-streams.d.ts +15 -0
- package/dist/db/queries/event-store-open-streams.js +33 -0
- package/dist/db/queries/event-store-payload-scrub.d.ts +5 -0
- package/dist/db/queries/event-store-payload-scrub.js +11 -0
- package/dist/db/queries/event-store.js +0 -1
- package/dist/db/queries/raw-sql.js +0 -1
- package/dist/db/queries/rebuild-rls-guard.d.ts +2 -1
- package/dist/db/queries/rebuild-rls-guard.js +24 -11
- package/dist/db/queries/rls-boot-catalog.d.ts +1 -0
- package/dist/db/queries/rls-boot-catalog.js +13 -9
- package/dist/db/queries/rls-shape.d.ts +3 -1
- package/dist/db/queries/rls-shape.js +31 -6
- package/dist/db/queries/session-advisory-lock.js +2 -1
- package/dist/db/queries/test-stack.js +7 -7
- package/dist/db/query.js +16 -11
- package/dist/db/rebuild-marker.js +11 -2
- package/dist/db/render-rls-ddl.d.ts +2 -0
- package/dist/db/render-rls-ddl.js +16 -11
- package/dist/db/replay-migration-sql.js +1 -1
- package/dist/db/row-level-security-boot-check.js +18 -5
- package/dist/db/row-level-security-connection.js +25 -12
- package/dist/db/row-level-security-scope.d.ts +2 -1
- package/dist/db/row-level-security-scope.js +9 -5
- package/dist/db/sql-identifier.d.ts +1 -0
- package/dist/db/sql-identifier.js +3 -0
- package/dist/db/system-tenant-read-db.d.ts +5 -0
- package/dist/db/system-tenant-read-db.js +28 -0
- package/dist/db/table-builder.d.ts +3 -1
- package/dist/db/table-builder.js +18 -8
- package/dist/db/table-info.d.ts +1 -2
- package/dist/db/table-introspection.d.ts +3 -0
- package/dist/db/table-introspection.js +6 -0
- package/dist/db/table-push.d.ts +1 -0
- package/dist/db/table-push.js +7 -1
- package/dist/db/tenant-db-runner.d.ts +3 -0
- package/dist/db/tenant-db-runner.js +19 -1
- package/dist/db/transaction-serialization.d.ts +1 -0
- package/dist/db/transaction-serialization.js +20 -3
- package/dist/db/where-clause.js +11 -2
- package/dist/db/write-ownership-failures.d.ts +25 -0
- package/dist/db/write-ownership-failures.js +82 -0
- package/dist/engine/boot-validator/boot-check.js +7 -1
- package/dist/engine/boot-validator/boot-phases-app.js +5 -5
- package/dist/engine/boot-validator/boot-phases.js +3 -2
- package/dist/engine/boot-validator/boot-rules.d.ts +305 -28
- package/dist/engine/boot-validator/boot-rules.js +4 -0
- package/dist/engine/boot-validator/bundled-lists-table.js +2 -2
- package/dist/engine/boot-validator/card-meta-overflow-rules.d.ts +2 -2
- package/dist/engine/boot-validator/card-meta-overflow-rules.js +2 -2
- package/dist/engine/boot-validator/card-meta-overflow.js +8 -5
- package/dist/engine/boot-validator/config-deps.d.ts +0 -1
- package/dist/engine/boot-validator/config-deps.js +0 -28
- package/dist/engine/boot-validator/config-key-rules.d.ts +0 -15
- package/dist/engine/boot-validator/config-key-rules.js +0 -15
- package/dist/engine/boot-validator/dashboard-screen-target.d.ts +22 -0
- package/dist/engine/boot-validator/dashboard-screen-target.js +20 -0
- package/dist/engine/boot-validator/dashboard-stat-navigate.d.ts +1 -0
- package/dist/engine/boot-validator/dashboard-stat-navigate.js +25 -17
- package/dist/engine/boot-validator/definition-webhook-events-rules.d.ts +5 -0
- package/dist/engine/boot-validator/definition-webhook-events-rules.js +5 -0
- package/dist/engine/boot-validator/derived-sql-fields.js +1 -2
- package/dist/engine/boot-validator/entity-declaration-rules.d.ts +5 -0
- package/dist/engine/boot-validator/entity-declaration-rules.js +5 -0
- package/dist/engine/boot-validator/entity-list-screens.d.ts +1 -0
- package/dist/engine/boot-validator/entity-list-screens.js +35 -13
- package/dist/engine/boot-validator/entity-structure-rules.d.ts +5 -0
- package/dist/engine/boot-validator/entity-structure-rules.js +5 -0
- package/dist/engine/boot-validator/list-column-layout.js +10 -6
- package/dist/engine/boot-validator/list-row-guidance-rules.d.ts +67 -0
- package/dist/engine/boot-validator/list-row-guidance-rules.js +67 -0
- package/dist/engine/boot-validator/list-row-guidance.d.ts +20 -0
- package/dist/engine/boot-validator/list-row-guidance.js +143 -0
- package/dist/engine/boot-validator/list-sort-summary-rules.d.ts +42 -0
- package/dist/engine/boot-validator/list-sort-summary-rules.js +42 -0
- package/dist/engine/boot-validator/list-sort-summary.d.ts +5 -0
- package/dist/engine/boot-validator/list-sort-summary.js +160 -0
- package/dist/engine/boot-validator/list-table-options.js +15 -1
- package/dist/engine/boot-validator/list-table-rules.d.ts +10 -5
- package/dist/engine/boot-validator/list-table-rules.js +10 -5
- package/dist/engine/boot-validator/list-toolbar-options.d.ts +10 -0
- package/dist/engine/boot-validator/list-toolbar-options.js +30 -0
- package/dist/engine/boot-validator/named-filter-rules.d.ts +42 -2
- package/dist/engine/boot-validator/named-filter-rules.js +42 -2
- package/dist/engine/boot-validator/ownership.js +10 -1
- package/dist/engine/boot-validator/parent-ref.js +87 -50
- package/dist/engine/boot-validator/projection-list-screens.d.ts +1 -0
- package/dist/engine/boot-validator/projection-list-screens.js +32 -1
- package/dist/engine/boot-validator/query-output-columns.js +62 -9
- package/dist/engine/boot-validator/query-output-guidance.d.ts +7 -0
- package/dist/engine/boot-validator/query-output-guidance.js +40 -0
- package/dist/engine/boot-validator/query-refs.js +34 -1
- package/dist/engine/boot-validator/row-decoration.d.ts +11 -0
- package/dist/engine/boot-validator/row-decoration.js +16 -0
- package/dist/engine/boot-validator/screens-actions.js +1 -1
- package/dist/engine/boot-validator/screens-dashboard-links.d.ts +10 -0
- package/dist/engine/boot-validator/screens-dashboard-links.js +36 -0
- package/dist/engine/boot-validator/screens-dashboard-narrow.d.ts +4 -0
- package/dist/engine/boot-validator/screens-dashboard-narrow.js +211 -0
- package/dist/engine/boot-validator/screens-dashboard-rules.d.ts +84 -4
- package/dist/engine/boot-validator/screens-dashboard-rules.js +84 -4
- package/dist/engine/boot-validator/screens-dashboard.js +29 -7
- package/dist/engine/boot-validator/screens-kind-entity-list.js +32 -27
- package/dist/engine/boot-validator/screens-kind-projection-detail-guidance.d.ts +3 -0
- package/dist/engine/boot-validator/screens-kind-projection-detail-guidance.js +46 -0
- package/dist/engine/boot-validator/screens-kind-projection-detail-rules.d.ts +20 -0
- package/dist/engine/boot-validator/screens-kind-projection-detail-rules.js +20 -0
- package/dist/engine/boot-validator/screens-kind-projection-detail.js +2 -0
- package/dist/engine/boot-validator/screens-kind-projection-list.js +4 -0
- package/dist/engine/boot-validator/screens-kind-rules.d.ts +25 -0
- package/dist/engine/boot-validator/screens-kind-rules.js +25 -0
- package/dist/engine/boot-validator/screens-lists.d.ts +8 -2
- package/dist/engine/boot-validator/screens-lists.js +19 -3
- package/dist/engine/boot-validator/screens.js +1 -1
- package/dist/engine/boot-validator/sort-nulls.d.ts +2 -0
- package/dist/engine/boot-validator/sort-nulls.js +15 -0
- package/dist/engine/boot-validator/zod-shape.d.ts +2 -1
- package/dist/engine/boot-validator/zod-shape.js +19 -1
- package/dist/engine/build-app-schema.js +4 -0
- package/dist/engine/config-helpers.d.ts +1 -2
- package/dist/engine/config-helpers.js +6 -7
- package/dist/engine/define-feature.js +1 -0
- package/dist/engine/define-handler.d.ts +1 -0
- package/dist/engine/define-handler.js +4 -2
- package/dist/engine/definition-violations.js +2 -2
- package/dist/engine/entity-handlers.js +3 -8
- package/dist/engine/entity-list-runtime-options.js +9 -8
- package/dist/engine/factories.d.ts +2 -0
- package/dist/engine/feature-config-events-jobs.js +1 -0
- package/dist/engine/feature-entity-handlers.js +5 -2
- package/dist/engine/field-access.d.ts +1 -1
- package/dist/engine/field-access.js +7 -10
- package/dist/engine/find-entity.js +3 -3
- package/dist/engine/form-derivations.js +3 -3
- package/dist/engine/index.d.ts +3 -3
- package/dist/engine/index.js +2 -2
- package/dist/engine/named-filter-roles.d.ts +3 -0
- package/dist/engine/named-filter-roles.js +15 -0
- package/dist/engine/pipeline.js +0 -1
- package/dist/engine/project-app-schema-for-roles.js +17 -2
- package/dist/engine/qualified-name.js +0 -1
- package/dist/engine/registry-facade.js +1 -2
- package/dist/engine/registry-state.d.ts +1 -1
- package/dist/engine/registry-state.js +5 -2
- package/dist/engine/registry-validate.js +2 -1
- package/dist/engine/resolve-named-list-filters.js +5 -2
- package/dist/engine/schema-builder.js +9 -11
- package/dist/engine/screen-helpers.d.ts +12 -0
- package/dist/engine/screen-helpers.js +17 -1
- package/dist/engine/soft-delete-cleanup.js +3 -5
- package/dist/engine/state-machine.js +0 -1
- package/dist/engine/steps/_database-clock.d.ts +2 -0
- package/dist/engine/steps/_database-clock.js +6 -0
- package/dist/engine/steps/compute.js +1 -1
- package/dist/engine/steps/retry.js +5 -1
- package/dist/engine/steps/return.js +0 -1
- package/dist/engine/steps/wait-for-event.js +2 -1
- package/dist/engine/steps/wait.js +2 -1
- package/dist/engine/system-user.d.ts +2 -2
- package/dist/engine/system-user.js +2 -2
- package/dist/engine/types/handlers.d.ts +1 -1
- package/dist/engine/types/handlers.js +1 -1
- package/dist/engine/types/screen.d.ts +1 -1
- package/dist/engine/types/screen.js +1 -1
- package/dist/engine/webhook-contracts.d.ts +2 -3
- package/dist/engine/webhook-contracts.js +2 -25
- package/dist/engine/webhook-events.js +48 -29
- package/dist/engine/webhook-payload-strictness.d.ts +7 -0
- package/dist/engine/webhook-payload-strictness.js +53 -0
- package/dist/env/_zod-introspect.d.ts +1 -0
- package/dist/env/dry-run.d.ts +1 -1
- package/dist/env/dry-run.js +1 -1
- package/dist/env/field-meta.d.ts +4 -0
- package/dist/env/field-meta.js +67 -0
- package/dist/env/field-rules.d.ts +9 -0
- package/dist/env/field-rules.js +46 -0
- package/dist/env/index.d.ts +3 -3
- package/dist/env/index.js +16 -71
- package/dist/env/internals.d.ts +3 -0
- package/dist/env/internals.js +1 -2
- package/dist/env/required-env.d.ts +3 -1
- package/dist/env/required-env.js +5 -2
- package/dist/errors/reasons.d.ts +1 -0
- package/dist/errors/reasons.js +4 -0
- package/dist/errors/serialize.js +2 -2
- package/dist/errors/write-error-info.js +0 -2
- package/dist/es-ops/operations-schema.js +18 -7
- package/dist/event-store/admin-api.js +3 -3
- package/dist/event-store/event-store.js +0 -3
- package/dist/event-store/index.d.ts +1 -0
- package/dist/event-store/index.js +1 -0
- package/dist/event-store/transfer.js +1 -1
- package/dist/files/assert-file-refs-belong-to-tenant.d.ts +2 -1
- package/dist/files/assert-file-refs-belong-to-tenant.js +15 -13
- package/dist/files/bind-pending-file-refs.d.ts +3 -1
- package/dist/files/bind-pending-file-refs.js +54 -27
- package/dist/files/copy-pending-file-refs-to-tenant.js +7 -3
- package/dist/files/create-file-ref.d.ts +4 -1
- package/dist/files/create-file-ref.js +14 -3
- package/dist/files/default-file-guard.js +4 -1
- package/dist/files/file-claim.d.ts +6 -0
- package/dist/files/file-claim.js +17 -0
- package/dist/files/file-field-slots.d.ts +2 -0
- package/dist/files/file-field-slots.js +28 -0
- package/dist/files/file-ref-entity.d.ts +3 -0
- package/dist/files/file-ref-entity.js +2 -0
- package/dist/files/file-ref-table.d.ts +3 -0
- package/dist/files/file-routes.d.ts +4 -1
- package/dist/files/file-routes.js +80 -16
- package/dist/files/in-memory-provider.d.ts +1 -1
- package/dist/files/in-memory-provider.js +2 -1
- package/dist/files/index.d.ts +1 -1
- package/dist/files/index.js +1 -1
- package/dist/files/invalid-file-ref-error.d.ts +2 -0
- package/dist/files/invalid-file-ref-error.js +15 -0
- package/dist/files/local-provider.js +9 -2
- package/dist/files/provider-resolver.js +1 -1
- package/dist/files/rebind-file-ref.d.ts +3 -2
- package/dist/files/rebind-file-ref.js +24 -18
- package/dist/files/resolve-file-handles.d.ts +13 -0
- package/dist/files/resolve-file-handles.js +57 -0
- package/dist/files/storage-tracking.d.ts +1 -1
- package/dist/files/storage-tracking.js +5 -2
- package/dist/files/sweep-stale-pending-file-refs.js +10 -4
- package/dist/files/types.d.ts +4 -0
- package/dist/files/types.js +10 -0
- package/dist/files/upload-field-resolution.d.ts +1 -0
- package/dist/files/upload-field-resolution.js +16 -2
- package/dist/files/upload-ledger.js +1 -1
- package/dist/i18n/required-surface-guidance-keys.d.ts +3 -0
- package/dist/i18n/required-surface-guidance-keys.js +9 -0
- package/dist/i18n/required-surface-keys.js +21 -5
- package/dist/internal/boot-rule-table-expectations.d.ts +2 -0
- package/dist/internal/boot-rule-table-expectations.js +29 -0
- package/dist/internal/row-level-security.d.ts +1 -0
- package/dist/internal/row-level-security.js +1 -0
- package/dist/internal/testing.d.ts +1 -0
- package/dist/internal/testing.js +1 -0
- package/dist/jobs/index.d.ts +1 -0
- package/dist/jobs/index.js +1 -0
- package/dist/jobs/job-load-events.d.ts +10 -0
- package/dist/jobs/job-load-events.js +12 -0
- package/dist/jobs/job-runner-context.js +6 -158
- package/dist/jobs/job-runner-dispatch.d.ts +7 -0
- package/dist/jobs/job-runner-dispatch.js +57 -0
- package/dist/jobs/job-runner-event-triggers.js +18 -9
- package/dist/jobs/job-runner-execution.js +5 -2
- package/dist/jobs/job-runner-facets.d.ts +48 -0
- package/dist/jobs/job-runner-facets.js +156 -0
- package/dist/jobs/job-runner-gates.js +19 -11
- package/dist/jobs/job-runner-helpers.d.ts +5 -1
- package/dist/jobs/job-runner-helpers.js +18 -3
- package/dist/jobs/job-runner-scope.d.ts +1 -0
- package/dist/jobs/job-runner-scope.js +2 -0
- package/dist/jobs/job-runner-tenant-cap-lock.d.ts +2 -0
- package/dist/jobs/job-runner-tenant-cap-lock.js +30 -0
- package/dist/jobs/job-runner-types.d.ts +1 -0
- package/dist/jobs/job-runner.js +39 -70
- package/dist/jobs/obliterate-job-queues.d.ts +6 -0
- package/dist/jobs/obliterate-job-queues.js +23 -0
- package/dist/lifecycle/lifecycle.js +1 -1
- package/dist/migrations/event-header-scrub.d.ts +11 -0
- package/dist/migrations/event-header-scrub.js +33 -0
- package/dist/migrations/event-payload-scrub.d.ts +1 -1
- package/dist/migrations/event-payload-scrub.js +36 -4
- package/dist/migrations/index.d.ts +1 -0
- package/dist/migrations/index.js +2 -0
- package/dist/migrations/kumiko-drift.d.ts +5 -2
- package/dist/migrations/kumiko-drift.js +51 -14
- package/dist/migrations/pending-rebuilds.js +4 -5
- package/dist/observability/sensitive-filter.js +0 -12
- package/dist/pipeline/aggregate-type-removal.js +17 -4
- package/dist/pipeline/context-services.d.ts +2 -0
- package/dist/pipeline/context-services.js +5 -2
- package/dist/pipeline/dispatch-batch.js +4 -3
- package/dist/pipeline/dispatch-context-helpers.d.ts +11 -0
- package/dist/pipeline/dispatch-context-helpers.js +58 -0
- package/dist/pipeline/dispatch-nested-write.d.ts +7 -0
- package/dist/pipeline/dispatch-nested-write.js +119 -0
- package/dist/pipeline/dispatch-query.js +10 -3
- package/dist/pipeline/dispatch-scope.js +4 -3
- package/dist/pipeline/dispatch-shared.d.ts +2 -6
- package/dist/pipeline/dispatch-shared.js +6 -38
- package/dist/pipeline/dispatch-write.d.ts +0 -1
- package/dist/pipeline/dispatch-write.js +3 -302
- package/dist/pipeline/dispatcher-utils.js +6 -0
- package/dist/pipeline/effective-system-scope.d.ts +3 -0
- package/dist/pipeline/effective-system-scope.js +22 -0
- package/dist/pipeline/event-dispatcher-delivery.d.ts +1 -0
- package/dist/pipeline/event-dispatcher-delivery.js +20 -9
- package/dist/pipeline/event-dispatcher.d.ts +6 -1
- package/dist/pipeline/event-dispatcher.js +6 -7
- package/dist/pipeline/handler-context-auth.d.ts +3 -2
- package/dist/pipeline/handler-context-auth.js +3 -4
- package/dist/pipeline/handler-context-db.js +11 -4
- package/dist/pipeline/handler-context-dispatch.js +2 -2
- package/dist/pipeline/handler-context-events.d.ts +8 -3
- package/dist/pipeline/handler-context-events.js +20 -65
- package/dist/pipeline/handler-context-member-resolution.js +16 -8
- package/dist/pipeline/handler-context-notify.d.ts +1 -0
- package/dist/pipeline/handler-context-notify.js +2 -0
- package/dist/pipeline/handler-context-phase-denials.js +3 -2
- package/dist/pipeline/handler-context-projection.d.ts +3 -0
- package/dist/pipeline/handler-context-projection.js +39 -0
- package/dist/pipeline/handler-context-scope.d.ts +1 -1
- package/dist/pipeline/handler-context-scope.js +14 -2
- package/dist/pipeline/index.d.ts +1 -1
- package/dist/pipeline/index.js +1 -1
- package/dist/pipeline/irreversible-operation-gate.js +36 -10
- package/dist/pipeline/lifecycle-pipeline.d.ts +1 -0
- package/dist/pipeline/lifecycle-pipeline.js +7 -4
- package/dist/pipeline/member-reader.js +4 -2
- package/dist/pipeline/msp-rebuild.js +1 -1
- package/dist/pipeline/nested-write-parent-guard.d.ts +5 -0
- package/dist/pipeline/nested-write-parent-guard.js +81 -0
- package/dist/pipeline/projection-rebuild.d.ts +2 -0
- package/dist/pipeline/projection-rebuild.js +16 -7
- package/dist/pipeline/projection-state.js +4 -6
- package/dist/pipeline/system-hooks.js +36 -6
- package/dist/pipeline/write-result-masking.js +31 -3
- package/dist/pipeline/write-transition-guard.d.ts +7 -0
- package/dist/pipeline/write-transition-guard.js +95 -0
- package/dist/schema-cli/shared.d.ts +2 -0
- package/dist/schema-cli/shared.js +4 -2
- package/dist/schema-cli/validate-command.js +43 -28
- package/dist/search/meilisearch-adapter-internals.d.ts +2 -0
- package/dist/search/meilisearch-adapter-internals.js +5 -0
- package/dist/search/meilisearch-adapter.d.ts +1 -0
- package/dist/search/meilisearch-adapter.js +17 -11
- package/dist/search/reindex-entity.d.ts +2 -0
- package/dist/search/reindex-entity.js +32 -4
- package/dist/search/reindex-tenants-search.js +20 -4
- package/dist/time/tz-context.js +1 -1
- package/dist/ui-types/card-column-roles.d.ts +6 -0
- package/dist/ui-types/card-column-roles.js +21 -3
- package/dist/ui-types/index.d.ts +3 -3
- package/dist/ui-types/index.js +2 -2
- package/dist/utils/ids.js +0 -1
- package/dist/utils/index.d.ts +1 -0
- package/dist/utils/index.js +1 -0
- package/dist/utils/return-path-limit.d.ts +1 -0
- package/dist/utils/return-path-limit.js +1 -0
- package/package.json +5 -3
- package/presets/biome-app.json +39 -21
- package/presets/biome-plugins/admin-api.grit +10 -0
- package/presets/biome-plugins/error-reasons.grit +53 -0
- package/presets/biome-plugins/es-literal-writes-tests.grit +18 -0
- package/presets/biome-plugins/es-literal-writes.grit +22 -0
- package/presets/biome-plugins/i18n-locale-terminology-de.grit +15 -0
- package/presets/biome-plugins/i18n-locale-terminology-romance.grit +10 -0
- package/presets/biome-plugins/no-create-test-dispatcher.grit +5 -0
- package/presets/biome-plugins/no-css-properties-type.grit +7 -0
- package/presets/biome-plugins/no-date-api.grit +11 -0
- package/presets/biome-plugins/no-direct-fetch.grit +16 -0
- package/presets/biome-plugins/no-direct-fs.grit +16 -0
- package/presets/biome-plugins/no-external-font-cdn-css.grit +9 -0
- package/presets/biome-plugins/no-external-font-cdn.grit +12 -0
- package/presets/biome-plugins/no-raw-hooks.grit +10 -0
- package/presets/biome-plugins/no-same-folder-barrel-import.grit +11 -0
- package/presets/biome-plugins/no-screen-container-classes.grit +7 -0
- package/presets/biome-plugins/no-skipped-or-retried-tests.grit +34 -0
- package/presets/biome-plugins/no-temporal-polyfill-require.grit +10 -0
- package/presets/biome-plugins/raw-html-in-web.grit +40 -0
- package/presets/biome-plugins/raw-ui-in-app.grit +142 -0
- package/presets/biome-plugins/restricted-event-store-symbols.grit +18 -0
- package/presets/biome-plugins/test-title.grit +20 -0
- package/presets/biome-plugins/unsafe-json-parse.grit +12 -0
- package/presets/biome-rules.json +467 -0
- package/src/changes.json +366 -0
- package/dist/engine/minor-units.d.ts +0 -2
- package/dist/engine/minor-units.js +0 -8
|
@@ -8,13 +8,16 @@ import { validateEntityListAggregateOptions } from "./entity-list-aggregate-opti
|
|
|
8
8
|
import { LIST_ROW_META_COLUMN_NAMES } from "./entity-list-screens.js";
|
|
9
9
|
import { ENTITY_LIST_RULES } from "./entity-list-screens-rules.js";
|
|
10
10
|
import { validateListBulkActions } from "./list-bulk-actions.js";
|
|
11
|
+
import { validateListRowGuidance } from "./list-row-guidance.js";
|
|
11
12
|
import { validateListTableOptions } from "./list-table-options.js";
|
|
12
|
-
import {
|
|
13
|
+
import { validateListToolbarOptions } from "./list-toolbar-options.js";
|
|
14
|
+
import { acceptsRowDecorationField, resolveRowDecorationFields, } from "./row-decoration.js";
|
|
15
|
+
import { assertWriteHandlerRegistered, resolveRowActionNavigateTarget, resolveScreenTargetQn, validateActionFieldRefs, validateAtMostOneRowClick, validateDrawerTargetAction, } from "./screens-actions.js";
|
|
13
16
|
import { SCREEN_ACTION_RULES } from "./screens-actions-rules.js";
|
|
14
17
|
import { validateDashboardPanelVisibleWhen } from "./screens-dashboard.js";
|
|
15
18
|
import { SCREEN_KIND_RULES } from "./screens-kind-rules.js";
|
|
16
19
|
import { buildUnknownFieldMessage, listActionContext, rejectEmptyColumns, rejectNonArrayInFilter, resolveScreenEntity, validateListColumnRendering, } from "./screens-kind-shared.js";
|
|
17
|
-
import {
|
|
20
|
+
import { validateListActionTargets, validateRelatedListSection } from "./screens-lists.js";
|
|
18
21
|
function resolveEntityListFields(ctx, screenId, entityName) {
|
|
19
22
|
const entityDef = resolveScreenEntity(ctx, screenId, entityName);
|
|
20
23
|
const fieldNames = new Set(Object.keys(entityDef.fields));
|
|
@@ -27,7 +30,7 @@ function resolveEntityListFields(ctx, screenId, entityName) {
|
|
|
27
30
|
const rowMeta = rowMetaFieldNames(entityDef.softDelete ?? false);
|
|
28
31
|
return { entityDef, fieldNames, columnFieldNames, rowMeta };
|
|
29
32
|
}
|
|
30
|
-
function validateEntityListColumns(ctx, screenId, screen, fields) {
|
|
33
|
+
function validateEntityListColumns(ctx, screenId, screen, fields, decoration) {
|
|
31
34
|
const featureName = ctx.feature.name;
|
|
32
35
|
rejectEmptyColumns(featureName, screenId, "entityList", screen.columns.length);
|
|
33
36
|
for (const col of screen.columns) {
|
|
@@ -47,6 +50,7 @@ function validateEntityListColumns(ctx, screenId, screen, fields) {
|
|
|
47
50
|
// a typo worth failing the boot.
|
|
48
51
|
if (!fields.columnFieldNames.has(normalized.field) &&
|
|
49
52
|
!LIST_ROW_META_COLUMN_NAMES.has(normalized.field) &&
|
|
53
|
+
!acceptsRowDecorationField(decoration, normalized.field) &&
|
|
50
54
|
!(normalized.label !== undefined && normalized.renderer !== undefined)) {
|
|
51
55
|
throw bootRuleError(SCREEN_KIND_RULES.unknownFieldReference, {
|
|
52
56
|
message: buildUnknownFieldMessage(featureName, screenId, normalized.field, screen.entity, fields.columnFieldNames),
|
|
@@ -150,29 +154,15 @@ function rejectCrossFeatureEditTargetWithoutEntityId(featureName, screenId, acti
|
|
|
150
154
|
// Pin rowActions at boot: a navigate target must exist and a writeHandler QN
|
|
151
155
|
// must be registered. Typos would otherwise only surface on the first click as
|
|
152
156
|
// "Screen not found" or a 404.
|
|
153
|
-
function validateEntityListRowAction(ctx, screenId, screen, fields, action) {
|
|
157
|
+
function validateEntityListRowAction(ctx, screenId, screen, fields, decoration, action) {
|
|
154
158
|
const featureName = ctx.feature.name;
|
|
155
|
-
|
|
156
|
-
|
|
157
|
-
|
|
158
|
-
|
|
159
|
-
|
|
160
|
-
|
|
161
|
-
|
|
162
|
-
// an app-registered component the framework has no visibility into, so
|
|
163
|
-
// flagging it would be a false positive on working code.
|
|
164
|
-
//
|
|
165
|
-
// Whether an entityEdit target lands in create or update mode is decided
|
|
166
|
-
// by the same rule the renderer's runNavigate() uses: an explicit
|
|
167
|
-
// entityId always forces update mode, and (absent an explicit entityId) a
|
|
168
|
-
// same-entity target gets row["id"] auto-injected — only a cross-entity
|
|
169
|
-
// target with no explicit entityId reaches create.
|
|
170
|
-
validateRowActionNavigateParams(featureName, screenId, "entityList", screen.entity, action, target);
|
|
171
|
-
}
|
|
172
|
-
else {
|
|
173
|
-
validateRowActionTarget(listActionContext(ctx, screenId, "entityList", screen.entity, `Screen "${screenId}" (entityList)`), "rowAction", "rowAction", action);
|
|
174
|
-
}
|
|
175
|
-
validateActionFieldRefs(featureName, screenId, "rowAction", action.id, action, fields.fieldNames, fields.rowMeta);
|
|
159
|
+
validateListActionTargets(listActionContext(ctx, screenId, "entityList", screen.entity, `Screen "${screenId}" (entityList)`), "rowAction", action, (navigateAction, target) => rejectCrossFeatureEditTargetWithoutEntityId(featureName, screenId, navigateAction, target));
|
|
160
|
+
// skip: an undeclared decoration outputSchema leaves the action's field names unpinnable
|
|
161
|
+
if (decoration?.kind === "opaque")
|
|
162
|
+
return;
|
|
163
|
+
validateActionFieldRefs(featureName, screenId, "rowAction", action.id, action, decoration === undefined
|
|
164
|
+
? fields.fieldNames
|
|
165
|
+
: new Set([...fields.fieldNames, ...decoration.names]), fields.rowMeta);
|
|
176
166
|
}
|
|
177
167
|
// toolbarActions, analogous to rowActions: misspelled navigate targets and
|
|
178
168
|
// unregistered writeHandler QNs fail at boot instead of on the first click.
|
|
@@ -219,10 +209,24 @@ function validateEntityListExpandableRow(ctx, screenId, expandableRow, fields) {
|
|
|
219
209
|
validateActionFieldRefs(ctx.feature.name, screenId, "toolbarAction", action.id, action, fields.fieldNames, fields.rowMeta);
|
|
220
210
|
}
|
|
221
211
|
}
|
|
212
|
+
function validateToolbarOptions(where, screen) {
|
|
213
|
+
if (screen.createPlacement === "toolbar" && screen.allowCreate === false) {
|
|
214
|
+
throw bootRuleError(SCREEN_KIND_RULES.createPlacementWithoutCreate, {
|
|
215
|
+
message: `${where} sets createPlacement "toolbar" with allowCreate: false — there is no create button to place. Remove createPlacement or allowCreate: false.`,
|
|
216
|
+
});
|
|
217
|
+
}
|
|
218
|
+
validateListToolbarOptions(where, screen);
|
|
219
|
+
}
|
|
222
220
|
export function validateEntityListScreen(ctx, screenId, screen) {
|
|
223
221
|
const featureName = ctx.feature.name;
|
|
224
222
|
const fields = resolveEntityListFields(ctx, screenId, screen.entity);
|
|
225
|
-
|
|
223
|
+
const decoration = resolveRowDecorationFields(ctx.featureMap.values(), screen.rowDecoration);
|
|
224
|
+
validateEntityListColumns(ctx, screenId, screen, fields, decoration);
|
|
225
|
+
validateListRowGuidance(featureName, screenId, "entityList", screen, {
|
|
226
|
+
entityName: screen.entity,
|
|
227
|
+
fieldNames: new Set([...fields.columnFieldNames, ...LIST_ROW_META_COLUMN_NAMES]),
|
|
228
|
+
rowDecorationFields: decoration,
|
|
229
|
+
});
|
|
226
230
|
// Validate pagination, sorting, and search at boot so authoring errors
|
|
227
231
|
// fail before runtime debugging of empty or incorrectly sorted lists.
|
|
228
232
|
if (screen.pageSize !== undefined && screen.pageSize <= 0) {
|
|
@@ -245,12 +249,13 @@ export function validateEntityListScreen(ctx, screenId, screen) {
|
|
|
245
249
|
`Known screens in this feature: ${Object.keys(ctx.feature.screens).sort().join(", ") || "(none)"}.`,
|
|
246
250
|
});
|
|
247
251
|
}
|
|
252
|
+
validateToolbarOptions(where, screen);
|
|
248
253
|
if (screen.filter !== undefined) {
|
|
249
254
|
validateEntityListFilter(featureName, screenId, screen.filter, fields);
|
|
250
255
|
}
|
|
251
256
|
if (screen.rowActions !== undefined) {
|
|
252
257
|
for (const action of screen.rowActions) {
|
|
253
|
-
validateEntityListRowAction(ctx, screenId, screen, fields, action);
|
|
258
|
+
validateEntityListRowAction(ctx, screenId, screen, fields, decoration, action);
|
|
254
259
|
}
|
|
255
260
|
validateAtMostOneRowClick(featureName, screenId, "entityList", screen.rowActions);
|
|
256
261
|
}
|
|
@@ -0,0 +1,3 @@
|
|
|
1
|
+
import type { ProjectionDetailScreenDefinition } from "../types/screen.ts";
|
|
2
|
+
import { type ScreenValidationContext } from "./screens-kind-shared.ts";
|
|
3
|
+
export declare function validateProjectionDetailGuidance(ctx: ScreenValidationContext, screenId: string, screen: ProjectionDetailScreenDefinition): void;
|
|
@@ -0,0 +1,46 @@
|
|
|
1
|
+
import { bootRuleError } from "./boot-rule.js";
|
|
2
|
+
import { detailGuidanceFieldRefs } from "./query-output-guidance.js";
|
|
3
|
+
import { validateActionHasIcon } from "./screens-actions.js";
|
|
4
|
+
import { PROJECTION_DETAIL_RULES } from "./screens-kind-projection-detail-rules.js";
|
|
5
|
+
import { validateRecordHeaderAction } from "./screens-kind-shared.js";
|
|
6
|
+
function validateGuidanceAction(ctx, screenId, screen, block, action) {
|
|
7
|
+
const featureName = ctx.feature.name;
|
|
8
|
+
validateActionHasIcon(featureName, screenId, "projectionDetail", `${block} action`, action);
|
|
9
|
+
validateRecordHeaderAction(ctx, screenId, "projectionDetail", screen.detailFor, action);
|
|
10
|
+
if (action.showOnTabs !== undefined) {
|
|
11
|
+
throw bootRuleError(PROJECTION_DETAIL_RULES.guidanceActionShowOnTabs, {
|
|
12
|
+
message: `[Feature ${featureName}] Screen "${screenId}" (projectionDetail) ${block} action ` +
|
|
13
|
+
`"${action.id}" sets showOnTabs — ${block} actions sit outside the tabs. Remove showOnTabs.`,
|
|
14
|
+
});
|
|
15
|
+
}
|
|
16
|
+
}
|
|
17
|
+
// Field existence is pinned against the query's outputSchema in query-output-columns.ts.
|
|
18
|
+
export function validateProjectionDetailGuidance(ctx, screenId, screen) {
|
|
19
|
+
for (const { option, field } of detailGuidanceFieldRefs(screen)) {
|
|
20
|
+
if (field.trim().length === 0) {
|
|
21
|
+
throw bootRuleError(PROJECTION_DETAIL_RULES.guidanceFieldEmpty, {
|
|
22
|
+
message: `[Feature ${ctx.feature.name}] Screen "${screenId}" (projectionDetail) sets ${option} to ` +
|
|
23
|
+
`an empty string. Name a query output field or remove the block.`,
|
|
24
|
+
});
|
|
25
|
+
}
|
|
26
|
+
}
|
|
27
|
+
if (screen.progress?.placement === "beside-steps" && screen.steps === undefined) {
|
|
28
|
+
throw bootRuleError(PROJECTION_DETAIL_RULES.progressBesideStepsWithoutSteps, {
|
|
29
|
+
message: `[Feature ${ctx.feature.name}] Screen "${screenId}" (projectionDetail) sets progress.placement ` +
|
|
30
|
+
`"beside-steps" without steps. Add steps or remove the placement.`,
|
|
31
|
+
});
|
|
32
|
+
}
|
|
33
|
+
const narrowLimit = screen.steps?.narrowLimit;
|
|
34
|
+
if (narrowLimit !== undefined && (!Number.isInteger(narrowLimit) || narrowLimit < 1)) {
|
|
35
|
+
throw bootRuleError(PROJECTION_DETAIL_RULES.stepsNarrowLimitInvalid, {
|
|
36
|
+
message: `[Feature ${ctx.feature.name}] Screen "${screenId}" (projectionDetail) sets steps.narrowLimit ` +
|
|
37
|
+
`"${String(narrowLimit)}", which is not a positive integer. Set a whole number of at least 1.`,
|
|
38
|
+
});
|
|
39
|
+
}
|
|
40
|
+
for (const action of screen.banner?.actions ?? []) {
|
|
41
|
+
validateGuidanceAction(ctx, screenId, screen, "banner", action);
|
|
42
|
+
}
|
|
43
|
+
for (const action of screen.steps?.actions ?? []) {
|
|
44
|
+
validateGuidanceAction(ctx, screenId, screen, "steps", action);
|
|
45
|
+
}
|
|
46
|
+
}
|
|
@@ -59,6 +59,26 @@ export declare const PROJECTION_DETAIL_RULES: {
|
|
|
59
59
|
readonly summary: "A header.subtitle part navigate names a screen or an entity.";
|
|
60
60
|
readonly fix: "Set screen or entity on the part's navigate.";
|
|
61
61
|
};
|
|
62
|
+
readonly guidanceFieldEmpty: {
|
|
63
|
+
readonly id: "projection-detail/guidance-field-empty";
|
|
64
|
+
readonly summary: "The field names of breadcrumb, summary, banner, steps and progress are non-empty strings.";
|
|
65
|
+
readonly fix: "Name a query output field or remove the block.";
|
|
66
|
+
};
|
|
67
|
+
readonly progressBesideStepsWithoutSteps: {
|
|
68
|
+
readonly id: "projection-detail/progress-beside-steps-without-steps";
|
|
69
|
+
readonly summary: 'progress.placement "beside-steps" needs a steps block to sit next to.';
|
|
70
|
+
readonly fix: "Add steps to the projectionDetail or remove progress.placement.";
|
|
71
|
+
};
|
|
72
|
+
readonly stepsNarrowLimitInvalid: {
|
|
73
|
+
readonly id: "projection-detail/steps-narrow-limit-invalid";
|
|
74
|
+
readonly summary: "steps.narrowLimit is a positive integer.";
|
|
75
|
+
readonly fix: "Set narrowLimit to a whole number of at least 1 or remove it.";
|
|
76
|
+
};
|
|
77
|
+
readonly guidanceActionShowOnTabs: {
|
|
78
|
+
readonly id: "projection-detail/guidance-action-show-on-tabs";
|
|
79
|
+
readonly summary: "Banner and steps actions set no showOnTabs.";
|
|
80
|
+
readonly fix: "Remove showOnTabs.";
|
|
81
|
+
};
|
|
62
82
|
readonly extensionContributesToFormSubmit: {
|
|
63
83
|
readonly id: "projection-detail/extension-contributes-to-form-submit";
|
|
64
84
|
readonly summary: "A projectionDetail extension section does not set contributesToFormSubmit.";
|
|
@@ -59,6 +59,26 @@ export const PROJECTION_DETAIL_RULES = {
|
|
|
59
59
|
summary: "A header.subtitle part navigate names a screen or an entity.",
|
|
60
60
|
fix: "Set screen or entity on the part's navigate.",
|
|
61
61
|
},
|
|
62
|
+
guidanceFieldEmpty: {
|
|
63
|
+
id: "projection-detail/guidance-field-empty",
|
|
64
|
+
summary: "The field names of breadcrumb, summary, banner, steps and progress are non-empty strings.",
|
|
65
|
+
fix: "Name a query output field or remove the block.",
|
|
66
|
+
},
|
|
67
|
+
progressBesideStepsWithoutSteps: {
|
|
68
|
+
id: "projection-detail/progress-beside-steps-without-steps",
|
|
69
|
+
summary: 'progress.placement "beside-steps" needs a steps block to sit next to.',
|
|
70
|
+
fix: "Add steps to the projectionDetail or remove progress.placement.",
|
|
71
|
+
},
|
|
72
|
+
stepsNarrowLimitInvalid: {
|
|
73
|
+
id: "projection-detail/steps-narrow-limit-invalid",
|
|
74
|
+
summary: "steps.narrowLimit is a positive integer.",
|
|
75
|
+
fix: "Set narrowLimit to a whole number of at least 1 or remove it.",
|
|
76
|
+
},
|
|
77
|
+
guidanceActionShowOnTabs: {
|
|
78
|
+
id: "projection-detail/guidance-action-show-on-tabs",
|
|
79
|
+
summary: "Banner and steps actions set no showOnTabs.",
|
|
80
|
+
fix: "Remove showOnTabs.",
|
|
81
|
+
},
|
|
62
82
|
extensionContributesToFormSubmit: {
|
|
63
83
|
id: "projection-detail/extension-contributes-to-form-submit",
|
|
64
84
|
summary: "A projectionDetail extension section does not set contributesToFormSubmit.",
|
|
@@ -3,6 +3,7 @@ import { isExtensionEditSection, isFieldsEditSection, isWriteFormEditSection, no
|
|
|
3
3
|
import { bootRuleError } from "./boot-rule.js";
|
|
4
4
|
import { assertWriteHandlerRegistered, resolveRowActionNavigateTarget, validateActionHasIcon, validatePrimaryActionTarget, } from "./screens-actions.js";
|
|
5
5
|
import { rejectWriteOnlyFormField, validateFieldsXorGroups, validateFormSelectOptions, validateTabSections, } from "./screens-forms.js";
|
|
6
|
+
import { validateProjectionDetailGuidance } from "./screens-kind-projection-detail-guidance.js";
|
|
6
7
|
import { PROJECTION_DETAIL_RULES } from "./screens-kind-projection-detail-rules.js";
|
|
7
8
|
import { assertExtensionSectionHasComponent, editSectionLabel, listActionContext, navigateActionFromLink, rejectEmptySections, rejectMissingQuery, validateRecordHeaderAction, validateRecordSectionActions, } from "./screens-kind-shared.js";
|
|
8
9
|
import { assertRefTargetRegistered, validateListActionTargets, validateRelatedListSection, } from "./screens-lists.js";
|
|
@@ -297,4 +298,5 @@ export function validateProjectionDetailScreen(ctx, screenId, screen) {
|
|
|
297
298
|
validateRecordHeaderAction(ctx, screenId, "projectionDetail", screen.detailFor, action);
|
|
298
299
|
validateHeaderActionShowOnTabs(featureName, screenId, screen, action);
|
|
299
300
|
}
|
|
301
|
+
validateProjectionDetailGuidance(ctx, screenId, screen);
|
|
300
302
|
}
|
|
@@ -1,6 +1,8 @@
|
|
|
1
1
|
import { normalizeListColumn } from "../screen-helpers.js";
|
|
2
2
|
import { validateListBulkActions } from "./list-bulk-actions.js";
|
|
3
|
+
import { validateListRowGuidance } from "./list-row-guidance.js";
|
|
3
4
|
import { validateListTableOptions } from "./list-table-options.js";
|
|
5
|
+
import { validateListToolbarOptions } from "./list-toolbar-options.js";
|
|
4
6
|
import { assertWriteHandlerRegistered, resolveRowActionNavigateTarget, validateAtMostOneRowClick, validateDrawerTargetAction, } from "./screens-actions.js";
|
|
5
7
|
import { validateDashboardPanelVisibleWhen } from "./screens-dashboard.js";
|
|
6
8
|
import { listActionContext, rejectEmptyColumns, rejectMissingQuery, rejectNonArrayInFilter, validateListColumnRendering, } from "./screens-kind-shared.js";
|
|
@@ -38,7 +40,9 @@ export function validateProjectionListScreen(ctx, screenId, screen) {
|
|
|
38
40
|
for (const col of screen.columns) {
|
|
39
41
|
validateListColumnRendering(ctx, screenId, "projectionList", normalizeListColumn(col));
|
|
40
42
|
}
|
|
43
|
+
validateListRowGuidance(featureName, screenId, "projectionList", screen);
|
|
41
44
|
validateListTableOptions(`[Feature ${featureName}] Screen "${screenId}" (projectionList)`, screen.table, screen.columns, true);
|
|
45
|
+
validateListToolbarOptions(`[Feature ${featureName}] Screen "${screenId}" (projectionList)`, screen);
|
|
42
46
|
// Screen filter: field existence can't be checked without an entity (columns
|
|
43
47
|
// aren't a complete field inventory of the underlying query), so only the
|
|
44
48
|
// structure is pinned: "in" requires an array.
|
|
@@ -69,6 +69,31 @@ export declare const SCREEN_KIND_RULES: {
|
|
|
69
69
|
readonly summary: "createScreen resolves to a registered screen in the same feature.";
|
|
70
70
|
readonly fix: "Point createScreen at a screen of this feature.";
|
|
71
71
|
};
|
|
72
|
+
readonly createPlacementWithoutCreate: {
|
|
73
|
+
readonly id: "entity-list/create-placement-without-create";
|
|
74
|
+
readonly summary: 'createPlacement "toolbar" moves the create button, so the list has one (no allowCreate: false).';
|
|
75
|
+
readonly fix: "Remove createPlacement or drop allowCreate: false.";
|
|
76
|
+
};
|
|
77
|
+
readonly toolbarSortWithoutSortOptions: {
|
|
78
|
+
readonly id: "entity-list/toolbar-sort-without-sort-options";
|
|
79
|
+
readonly summary: "toolbarSort draws the sortOptions as a select in the filter row, so it needs sortOptions.";
|
|
80
|
+
readonly fix: "Declare sortOptions or remove toolbarSort.";
|
|
81
|
+
};
|
|
82
|
+
readonly narrowFacetsInvalid: {
|
|
83
|
+
readonly id: "list/narrow-facets-invalid";
|
|
84
|
+
readonly summary: 'narrowFacets is "pills".';
|
|
85
|
+
readonly fix: 'Use "pills", or remove narrowFacets.';
|
|
86
|
+
};
|
|
87
|
+
readonly toolbarActionsPlacementInvalid: {
|
|
88
|
+
readonly id: "list/toolbar-actions-placement-invalid";
|
|
89
|
+
readonly summary: 'toolbarActionsPlacement is "header" or "toolbar".';
|
|
90
|
+
readonly fix: 'Use "header" or "toolbar", or remove toolbarActionsPlacement.';
|
|
91
|
+
};
|
|
92
|
+
readonly toolbarActionsPlacementWithoutActions: {
|
|
93
|
+
readonly id: "list/toolbar-actions-placement-without-actions";
|
|
94
|
+
readonly summary: 'toolbarActionsPlacement "toolbar" moves the toolbarActions, so the list declares some.';
|
|
95
|
+
readonly fix: "Declare toolbarActions or remove toolbarActionsPlacement.";
|
|
96
|
+
};
|
|
72
97
|
readonly configEditFieldsEmpty: {
|
|
73
98
|
readonly id: "config-edit/fields-empty";
|
|
74
99
|
readonly summary: "A configEdit screen declares at least one field.";
|
|
@@ -69,6 +69,31 @@ export const SCREEN_KIND_RULES = {
|
|
|
69
69
|
summary: "createScreen resolves to a registered screen in the same feature.",
|
|
70
70
|
fix: "Point createScreen at a screen of this feature.",
|
|
71
71
|
},
|
|
72
|
+
createPlacementWithoutCreate: {
|
|
73
|
+
id: "entity-list/create-placement-without-create",
|
|
74
|
+
summary: 'createPlacement "toolbar" moves the create button, so the list has one (no allowCreate: false).',
|
|
75
|
+
fix: "Remove createPlacement or drop allowCreate: false.",
|
|
76
|
+
},
|
|
77
|
+
toolbarSortWithoutSortOptions: {
|
|
78
|
+
id: "entity-list/toolbar-sort-without-sort-options",
|
|
79
|
+
summary: "toolbarSort draws the sortOptions as a select in the filter row, so it needs sortOptions.",
|
|
80
|
+
fix: "Declare sortOptions or remove toolbarSort.",
|
|
81
|
+
},
|
|
82
|
+
narrowFacetsInvalid: {
|
|
83
|
+
id: "list/narrow-facets-invalid",
|
|
84
|
+
summary: 'narrowFacets is "pills".',
|
|
85
|
+
fix: 'Use "pills", or remove narrowFacets.',
|
|
86
|
+
},
|
|
87
|
+
toolbarActionsPlacementInvalid: {
|
|
88
|
+
id: "list/toolbar-actions-placement-invalid",
|
|
89
|
+
summary: 'toolbarActionsPlacement is "header" or "toolbar".',
|
|
90
|
+
fix: 'Use "header" or "toolbar", or remove toolbarActionsPlacement.',
|
|
91
|
+
},
|
|
92
|
+
toolbarActionsPlacementWithoutActions: {
|
|
93
|
+
id: "list/toolbar-actions-placement-without-actions",
|
|
94
|
+
summary: 'toolbarActionsPlacement "toolbar" moves the toolbarActions, so the list declares some.',
|
|
95
|
+
fix: "Declare toolbarActions or remove toolbarActionsPlacement.",
|
|
96
|
+
},
|
|
72
97
|
configEditFieldsEmpty: {
|
|
73
98
|
id: "config-edit/fields-empty",
|
|
74
99
|
summary: "A configEdit screen declares at least one field.",
|
|
@@ -1,6 +1,7 @@
|
|
|
1
1
|
import type { FeatureDefinition } from "../types/index.ts";
|
|
2
2
|
import type { EditRelatedListSection, ListColumnSpec, ListFacetSpec, RowAction, ScreenDefinition } from "../types/screen.ts";
|
|
3
3
|
import type { NavigateSourceScreenType, NavigateTargetLookups } from "./screens-actions.ts";
|
|
4
|
+
import { resolveRowActionNavigateTarget } from "./screens-actions.ts";
|
|
4
5
|
export declare function validateExplicitListScreenExists(featureName: string, screenId: string, screen: ScreenDefinition, screensByShortId: ReadonlyMap<string, unknown>): void;
|
|
5
6
|
export declare function validateScreenHasNavArea(feature: FeatureDefinition, screenId: string, screen: ScreenDefinition, featureMap: ReadonlyMap<string, FeatureDefinition>): void;
|
|
6
7
|
type RelatedListSectionValidation = {
|
|
@@ -33,8 +34,11 @@ export type ListActionTargetContext = NavigateTargetLookups & {
|
|
|
33
34
|
readonly screens: FeatureDefinition["screens"];
|
|
34
35
|
readonly allWriteHandlerQns: ReadonlySet<string>;
|
|
35
36
|
};
|
|
36
|
-
|
|
37
|
-
|
|
37
|
+
type NavigateTargetCheck = (action: Extract<RowAction, {
|
|
38
|
+
readonly kind: "navigate";
|
|
39
|
+
}>, target: ReturnType<typeof resolveRowActionNavigateTarget>) => void;
|
|
40
|
+
export declare function validateListActionTargets(ctx: ListActionTargetContext, actionLabel: "rowAction" | "emptyState action", action: RowAction, onNavigateTarget?: NavigateTargetCheck): void;
|
|
41
|
+
export declare function validateRowActionTarget(ctx: ListActionTargetContext, actionLabel: "rowAction" | "emptyState action" | "action", paramsLabel: "rowAction" | "emptyState action", action: RowAction, onNavigateTarget?: NavigateTargetCheck): void;
|
|
38
42
|
export declare function rejectInertColumnSortable(featureName: string, screenId: string, screenType: "entityList" | "projectionList", column: {
|
|
39
43
|
readonly field: string;
|
|
40
44
|
readonly sortable?: boolean;
|
|
@@ -42,6 +46,8 @@ export declare function rejectInertColumnSortable(featureName: string, screenId:
|
|
|
42
46
|
export declare function validateColumnRendererForm(featureName: string, screenId: string, column: {
|
|
43
47
|
readonly field: string;
|
|
44
48
|
readonly renderer?: unknown;
|
|
49
|
+
readonly linkScreenField?: string;
|
|
50
|
+
readonly linkParamsField?: string;
|
|
45
51
|
}): void;
|
|
46
52
|
export declare function validateEnumOptionTones(prefix: string, column: {
|
|
47
53
|
readonly field: string;
|
|
@@ -7,6 +7,9 @@ import { explicitListScreenId, normalizeListColumn, resolveNavParentScreen, scre
|
|
|
7
7
|
import { bootRuleError } from "./boot-rule.js";
|
|
8
8
|
import { ENTITY_LIST_RULES } from "./entity-list-screens-rules.js";
|
|
9
9
|
import { validateListBulkActions } from "./list-bulk-actions.js";
|
|
10
|
+
import { validateListRowGuidance } from "./list-row-guidance.js";
|
|
11
|
+
import { LIST_ROW_GUIDANCE_RULES } from "./list-row-guidance-rules.js";
|
|
12
|
+
import { rejectSummaryRowOnRelatedList } from "./list-sort-summary.js";
|
|
10
13
|
import { validateListTableOptions } from "./list-table-options.js";
|
|
11
14
|
import { validateRelatedListGroupingRules } from "./related-list-table-rules.js";
|
|
12
15
|
import { assertWriteHandlerRegistered, isRowClickAction, rejectRedirectOnListRowAction, resolveRowActionNavigateTarget, validateClientActionName, validateDrawerTargetAction, validateRowActionNavigateParams, } from "./screens-actions.js";
|
|
@@ -87,6 +90,9 @@ export function validateScreenHasNavArea(feature, screenId, screen, featureMap)
|
|
|
87
90
|
// both render a relatedList whose rows come from an arbitrary query.
|
|
88
91
|
function validateRelatedListTableAndBulk(args) {
|
|
89
92
|
const { featureName, where, section } = args;
|
|
93
|
+
// Before the grouping rules: an expandableRow's "only table.grouping" rule would otherwise
|
|
94
|
+
// swallow a summaryRow with a less specific message.
|
|
95
|
+
rejectSummaryRowOnRelatedList(`[Feature ${featureName}] ${where}`, section.table);
|
|
90
96
|
validateRelatedListGroupingRules(`[Feature ${featureName}] ${where}`, section, args.screenType === "entityList expandableRow");
|
|
91
97
|
validateListTableOptions(`[Feature ${featureName}] ${where}`, section.table, section.columns);
|
|
92
98
|
if (section.rowActions !== undefined)
|
|
@@ -113,8 +119,10 @@ export function validateRelatedListSection(args) {
|
|
|
113
119
|
if (section.entity !== undefined) {
|
|
114
120
|
assertRefTargetRegistered(`[Feature ${featureName}] ${where}`, "entity", section.entity, featureName, featureMap);
|
|
115
121
|
}
|
|
122
|
+
validateListRowGuidance(featureName, args.screenId, "relatedList", section, undefined, where);
|
|
116
123
|
for (const col of section.columns) {
|
|
117
124
|
const normalizedCol = normalizeListColumn(col);
|
|
125
|
+
validateColumnRendererForm(featureName, args.screenId, normalizedCol);
|
|
118
126
|
validateEnumOptionTones(`[Feature ${featureName}] ${where}`, normalizedCol);
|
|
119
127
|
if (normalizedCol.refEntity !== undefined) {
|
|
120
128
|
assertRefTargetRegistered(`[Feature ${featureName}] ${where}`, `column "${normalizedCol.field}" (refEntity)`, normalizedCol.refEntity, featureName, featureMap);
|
|
@@ -153,19 +161,20 @@ function rejectEmptyStateActionParams(ctx, actionLabel, action) {
|
|
|
153
161
|
}
|
|
154
162
|
// Target checks shared by list/related-list rowActions and emptyState.action:
|
|
155
163
|
// navigate target + params, drawer target, write-handler registration.
|
|
156
|
-
export function validateListActionTargets(ctx, actionLabel, action) {
|
|
164
|
+
export function validateListActionTargets(ctx, actionLabel, action, onNavigateTarget) {
|
|
157
165
|
rejectRedirectOnListRowAction(ctx.featureName, ctx.screenId, ctx.screenType, action);
|
|
158
166
|
if (actionLabel === "emptyState action")
|
|
159
167
|
rejectEmptyStateActionParams(ctx, actionLabel, action);
|
|
160
|
-
validateRowActionTarget(ctx, actionLabel, actionLabel, action);
|
|
168
|
+
validateRowActionTarget(ctx, actionLabel, actionLabel, action, onNavigateTarget);
|
|
161
169
|
}
|
|
162
170
|
// Header actions have always reported navigate-params errors under the
|
|
163
171
|
// "rowAction" label, which validateRowActionNavigateParams only knows in list
|
|
164
172
|
// labels — hence paramsLabel apart from actionLabel.
|
|
165
|
-
export function validateRowActionTarget(ctx, actionLabel, paramsLabel, action) {
|
|
173
|
+
export function validateRowActionTarget(ctx, actionLabel, paramsLabel, action, onNavigateTarget) {
|
|
166
174
|
const { featureName, screenId, screenType } = ctx;
|
|
167
175
|
if (action.kind === "navigate") {
|
|
168
176
|
const target = resolveRowActionNavigateTarget(featureName, screenId, screenType, actionLabel, action, ctx.allScreenQns, ctx.navTargetShortIds, ctx.screensByShortId, ctx.detailForScreens);
|
|
177
|
+
onNavigateTarget?.(action, target);
|
|
169
178
|
validateRowActionNavigateParams(featureName, screenId, screenType, ctx.screenEntity, action, target, paramsLabel);
|
|
170
179
|
}
|
|
171
180
|
else if (action.kind === "drawer") {
|
|
@@ -269,6 +278,13 @@ export function rejectInertColumnSortable(featureName, screenId, screenType, col
|
|
|
269
278
|
// failure.
|
|
270
279
|
export function validateColumnRendererForm(featureName, screenId, column) {
|
|
271
280
|
validateEnumOptionTones(`[Feature ${featureName}] Screen "${screenId}"`, column);
|
|
281
|
+
if (column.linkParamsField !== undefined && column.linkScreenField === undefined) {
|
|
282
|
+
throw bootRuleError(LIST_ROW_GUIDANCE_RULES.linkParamsWithoutScreenField, {
|
|
283
|
+
message: `[Feature ${featureName}] Screen "${screenId}" column "${column.field}" sets linkParamsField ` +
|
|
284
|
+
`without linkScreenField — the params belong to the linkScreenField target. ` +
|
|
285
|
+
`Set linkScreenField or remove linkParamsField.`,
|
|
286
|
+
});
|
|
287
|
+
}
|
|
272
288
|
const renderer = column.renderer;
|
|
273
289
|
// skip: only the PlatformComponent form ({ react: { __component: "..." } })
|
|
274
290
|
// is validated structurally. Function, string-QN and null/undefined
|
|
@@ -119,8 +119,8 @@ function validateScreenPrelude(ctx, screenId, screen) {
|
|
|
119
119
|
export function validateScreens(feature, featureMap, allWriteHandlerQns, allScreenQns, configKeyDefsByQn, screensByShortId, detailForScreens) {
|
|
120
120
|
const ctx = buildScreenValidationContext(feature, featureMap, allWriteHandlerQns, allScreenQns, configKeyDefsByQn, screensByShortId, detailForScreens);
|
|
121
121
|
for (const [screenId, screen] of Object.entries(feature.screens)) {
|
|
122
|
-
validateScreenPrelude(ctx, screenId, screen);
|
|
123
122
|
rejectUnknownScreenKind(feature.name, screenId, screen);
|
|
123
|
+
validateScreenPrelude(ctx, screenId, screen);
|
|
124
124
|
validateScreenOfKind(ctx, screenId, screen.type, screen);
|
|
125
125
|
}
|
|
126
126
|
}
|
|
@@ -0,0 +1,15 @@
|
|
|
1
|
+
import { bootRuleError } from "./boot-rule.js";
|
|
2
|
+
import { ENTITY_STRUCTURE_RULES } from "./entity-structure-rules.js";
|
|
3
|
+
export function validateSortNulls(feature) {
|
|
4
|
+
for (const [entityName, entity] of Object.entries(feature.entities ?? {})) {
|
|
5
|
+
for (const [fieldName, field] of Object.entries(entity.fields)) {
|
|
6
|
+
if (!("sortNulls" in field) || field.sortNulls === undefined)
|
|
7
|
+
continue;
|
|
8
|
+
if (field.sortable === true)
|
|
9
|
+
continue;
|
|
10
|
+
throw bootRuleError(ENTITY_STRUCTURE_RULES.sortNullsNeedsSortable, {
|
|
11
|
+
message: `Field "${fieldName}" on entity "${entityName}" sets sortNulls without sortable: true; the null order only applies to a sortable field. Add sortable: true or drop sortNulls.`,
|
|
12
|
+
});
|
|
13
|
+
}
|
|
14
|
+
}
|
|
15
|
+
}
|
|
@@ -1,5 +1,6 @@
|
|
|
1
|
-
import {
|
|
1
|
+
import { ZodType } from "zod";
|
|
2
2
|
import type { $ZodType } from "zod/v4/core";
|
|
3
|
+
export declare function getZodStringLiterals(schema: ZodType | undefined): readonly string[] | undefined;
|
|
3
4
|
export declare function getZodObjectShape(schema: ZodType | undefined): Record<string, ZodType> | undefined;
|
|
4
5
|
export declare function getZodRowShape(schema: ZodType | undefined): Record<string, ZodType> | undefined;
|
|
5
6
|
export declare function collectZodObjectKeys(schema: $ZodType | undefined): ReadonlySet<string>;
|
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
import { ZodArray, ZodCatch, ZodDefault, ZodIntersection, ZodLazy, ZodMap, ZodNever, ZodNonOptional, ZodNullable, ZodObject, ZodOptional, ZodPipe, ZodPrefault, ZodPromise, ZodReadonly, ZodRecord, ZodSet, ZodTuple, ZodUnion, ZodXor, } from "zod";
|
|
1
|
+
import { ZodArray, ZodCatch, ZodDefault, ZodEnum, ZodIntersection, ZodLazy, ZodLiteral, ZodMap, ZodNever, ZodNonOptional, ZodNullable, ZodObject, ZodOptional, ZodPipe, ZodPrefault, ZodPromise, ZodReadonly, ZodRecord, ZodSet, ZodTuple, ZodType, ZodUnion, ZodXor, } from "zod";
|
|
2
2
|
import { bootRuleError } from "./boot-rule.js";
|
|
3
3
|
import { HANDLER_FIELD_REFERENCE_RULES } from "./handler-field-references-rules.js";
|
|
4
4
|
// Drills through wrapper types (.nullable(), .optional(), .default()) a
|
|
@@ -21,6 +21,24 @@ function unwrapZodType(schema) {
|
|
|
21
21
|
}
|
|
22
22
|
return current;
|
|
23
23
|
}
|
|
24
|
+
// The closed set of string values a schema accepts (enum, literal, union of those), or undefined
|
|
25
|
+
// when it accepts anything else (plain z.string(), refinements, ...) and cannot be enumerated.
|
|
26
|
+
export function getZodStringLiterals(schema) {
|
|
27
|
+
if (schema === undefined)
|
|
28
|
+
return undefined;
|
|
29
|
+
const unwrapped = unwrapZodType(schema);
|
|
30
|
+
if (unwrapped instanceof ZodEnum)
|
|
31
|
+
return Object.values(unwrapped.enum).map(String);
|
|
32
|
+
if (unwrapped instanceof ZodLiteral) {
|
|
33
|
+
const values = [...unwrapped.values];
|
|
34
|
+
return values.every((value) => typeof value === "string") ? values.map(String) : undefined;
|
|
35
|
+
}
|
|
36
|
+
if (unwrapped instanceof ZodUnion) {
|
|
37
|
+
const parts = unwrapped.options.map((option) => option instanceof ZodType ? getZodStringLiterals(option) : undefined);
|
|
38
|
+
return parts.every((part) => part !== undefined) ? parts.flat() : undefined;
|
|
39
|
+
}
|
|
40
|
+
return undefined;
|
|
41
|
+
}
|
|
24
42
|
// Non-ZodObject schemas (e.g. a z.union across payload shapes) and an
|
|
25
43
|
// absent schema both fall through to "shape unknown" — callers treat that
|
|
26
44
|
// as "capability absent" and skip the check rather than throwing, the same
|
|
@@ -32,6 +32,7 @@ import { collectUrlPrefillFieldsByScreenQn } from "./boot-validator/url-prefill-
|
|
|
32
32
|
import { buildConfigFeatureSchema, SETTINGS_HUB_FEATURE, } from "./build-config-feature-schema.js";
|
|
33
33
|
import { isEncryptedAtRest } from "./config-helpers.js";
|
|
34
34
|
import { isListQueryWithoutSearchableFields } from "./entity-list-searchability.js";
|
|
35
|
+
import { projectNamedFilterRoles } from "./named-filter-roles.js";
|
|
35
36
|
import { projectQueryLiveEntities } from "./project-query-live-entities.js";
|
|
36
37
|
import { QnTypes, qualifyEntityName } from "./qualified-name.js";
|
|
37
38
|
const log = createFallbackLogger("kumiko");
|
|
@@ -285,6 +286,9 @@ function projectScreens(featureName, screens, registry, urlPrefillFieldsByScreen
|
|
|
285
286
|
return projectConfigEditScreen(screen, encryptedConfigKeyQns);
|
|
286
287
|
if (screen.type === "projectionList")
|
|
287
288
|
return projectProjectionListScreen(screen, registry);
|
|
289
|
+
if (screen.type === "entityList") {
|
|
290
|
+
return projectNamedFilterRoles(screen, registry.features.get(featureName)?.entities?.[screen.entity]?.namedFilters);
|
|
291
|
+
}
|
|
288
292
|
if (screen.type === "entityEdit") {
|
|
289
293
|
const { writeExcludedFields: _authoredExclusions, ...authoredScreen } = screen;
|
|
290
294
|
return {
|
|
@@ -7,7 +7,7 @@ export declare const access: {
|
|
|
7
7
|
readonly systemAdmin: readonly string[];
|
|
8
8
|
readonly system: readonly string[];
|
|
9
9
|
readonly privileged: readonly string[];
|
|
10
|
-
readonly
|
|
10
|
+
readonly builtinUserRoles: readonly string[];
|
|
11
11
|
readonly anonymous: readonly string[];
|
|
12
12
|
readonly roles: (...roles: string[]) => readonly string[];
|
|
13
13
|
readonly withSystem: (roles: readonly string[]) => readonly string[];
|
|
@@ -28,7 +28,6 @@ type ConfigKeyOptions<T extends ConfigKeyType> = {
|
|
|
28
28
|
} : never;
|
|
29
29
|
computed?: ConfigComputedFn<T>;
|
|
30
30
|
validate?: ConfigValidateFn<T>;
|
|
31
|
-
allowPerRequest?: T extends "text" ? never : boolean;
|
|
32
31
|
required?: boolean;
|
|
33
32
|
env?: string;
|
|
34
33
|
inheritedToTenant?: boolean;
|
|
@@ -17,7 +17,10 @@ export const access = {
|
|
|
17
17
|
systemAdmin: ["SystemAdmin"], // @cast-boundary schema-walk
|
|
18
18
|
system: ["system"], // @cast-boundary schema-walk
|
|
19
19
|
privileged: ["system", "SystemAdmin"], // @cast-boundary schema-walk
|
|
20
|
-
|
|
20
|
+
// Only the built-in user roles, not every signed-in caller: a member holding just an app role
|
|
21
|
+
// is not covered. For "any signed-in user" declare `anySignedIn: true` (next to the anonymous
|
|
22
|
+
// role) or `openToAll` instead.
|
|
23
|
+
builtinUserRoles: ["User", "Admin", "SystemAdmin"], // @cast-boundary schema-walk
|
|
21
24
|
anonymous: ["anonymous"], // @cast-boundary schema-walk
|
|
22
25
|
roles: (...roles) => roles,
|
|
23
26
|
// Tenant self-service roles PLUS the system actor — for tenant-scope keys a
|
|
@@ -61,7 +64,6 @@ function createConfigKey(scope, type, opts = {}) {
|
|
|
61
64
|
...(opts.pattern ? { pattern: opts.pattern } : {}),
|
|
62
65
|
computed: opts.computed,
|
|
63
66
|
validate: opts.validate,
|
|
64
|
-
...(opts.allowPerRequest === true ? { allowPerRequest: true } : {}),
|
|
65
67
|
...(opts.required === true ? { required: true } : {}),
|
|
66
68
|
...(opts.env ? { env: opts.env } : {}),
|
|
67
69
|
...(opts.inheritedToTenant === false ? { inheritedToTenant: false } : {}),
|
|
@@ -73,15 +75,12 @@ function createConfigKey(scope, type, opts = {}) {
|
|
|
73
75
|
// --- Public API ---
|
|
74
76
|
// Generic on the type-tag so `r.config({keys})` can propagate it into the
|
|
75
77
|
// returned `ConfigKeyHandle<T>` — that's what narrows `ctx.config(handle)`.
|
|
76
|
-
// @wrapper-known semantic-alias
|
|
77
78
|
export function createTenantConfig(type, opts) {
|
|
78
79
|
return createConfigKey("tenant", type, opts);
|
|
79
80
|
}
|
|
80
|
-
// @wrapper-known semantic-alias
|
|
81
81
|
export function createSystemConfig(type, opts) {
|
|
82
82
|
return createConfigKey("system", type, opts);
|
|
83
83
|
}
|
|
84
|
-
// @wrapper-known semantic-alias
|
|
85
84
|
export function createUserConfig(type, opts) {
|
|
86
85
|
return createConfigKey("user", type, opts);
|
|
87
86
|
}
|
|
@@ -91,8 +90,8 @@ export function createUserConfig(type, opts) {
|
|
|
91
90
|
// from the seeds-record-key during r.config() processing.
|
|
92
91
|
// Scope-agnostic seed. The scope is derived from the matching keyDef in
|
|
93
92
|
// define-feature.ts (via `seed.scope ?? keyDef.scope`). NOT usable for
|
|
94
|
-
// user-scope keys — those need an explicit tenantId+userId,
|
|
95
|
-
// `
|
|
93
|
+
// user-scope keys — those need an explicit tenantId+userId, so write the
|
|
94
|
+
// literal `{ value, scope: "user", tenantId, userId }`.
|
|
96
95
|
export function createSeed(opts) {
|
|
97
96
|
return { value: opts.value, key: "" };
|
|
98
97
|
}
|
|
@@ -95,6 +95,7 @@ export function defineFeature(name, setup, settings) {
|
|
|
95
95
|
adoptsBundledLists() {
|
|
96
96
|
state.adoptsBundledLists = true;
|
|
97
97
|
},
|
|
98
|
+
// guard:dup-ok builder setter shape, sharing would add a parameter per line
|
|
98
99
|
uiHints(hints) {
|
|
99
100
|
if (state.uiHints !== undefined) {
|
|
100
101
|
throw bootRuleError(FEATURE_DEFINITION_RULES.uiHintsTwice, {
|
|
@@ -14,6 +14,7 @@ export declare function defineQueryHandler<const TName extends string, TSchema e
|
|
|
14
14
|
export declare const PAGED_QUERY_HANDLER_BRAND = "__kumikoPagedQueryHandler";
|
|
15
15
|
export declare function isPagedQueryHandler(def: object): boolean;
|
|
16
16
|
export declare function isEntityConventionQueryHandler(def: object): boolean;
|
|
17
|
+
export declare function isEntityConventionWriteHandler(def: object): boolean;
|
|
17
18
|
export type PagedQueryHandlerDefinition<TName extends string = string, TSchema extends ZodType = ZodType, TRow = unknown, TMap extends object = KumikoEventTypeMap> = QueryHandlerDefinition<TName, TSchema, CursorResult<TRow>, TMap> & {
|
|
18
19
|
readonly [PAGED_QUERY_HANDLER_BRAND]: true;
|
|
19
20
|
};
|
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
import { ENTITY_CONVENTION_QUERY_BRAND } from "@cosmicdrift/kumiko-types/handlers";
|
|
1
|
+
import { ENTITY_CONVENTION_QUERY_BRAND, ENTITY_CONVENTION_WRITE_BRAND, } from "@cosmicdrift/kumiko-types/handlers";
|
|
2
2
|
import { propertyOf } from "@cosmicdrift/kumiko-types/type-guards";
|
|
3
3
|
import { bootRuleError } from "./boot-validator/boot-rule.js";
|
|
4
4
|
import { DEFINITION_HANDLER_RULES } from "./boot-validator/definition-handlers-rules.js";
|
|
@@ -72,7 +72,6 @@ export function defineWriteHandler(def,
|
|
|
72
72
|
};
|
|
73
73
|
if ("perform" in def && def.perform !== undefined) {
|
|
74
74
|
const performDef = def.perform;
|
|
75
|
-
// @wrapper-known semantic-alias
|
|
76
75
|
const compiledHandler = async (event, ctx) => {
|
|
77
76
|
return runPipeline(performDef, event, ctx);
|
|
78
77
|
};
|
|
@@ -110,6 +109,9 @@ export function isPagedQueryHandler(def) {
|
|
|
110
109
|
export function isEntityConventionQueryHandler(def) {
|
|
111
110
|
return propertyOf(def, ENTITY_CONVENTION_QUERY_BRAND) === true;
|
|
112
111
|
}
|
|
112
|
+
export function isEntityConventionWriteHandler(def) {
|
|
113
|
+
return propertyOf(def, ENTITY_CONVENTION_WRITE_BRAND) === true;
|
|
114
|
+
}
|
|
113
115
|
// A projectionList screen's query must resolve to { rows, nextCursor, total? }
|
|
114
116
|
// (CursorResult<T>) — the renderer used to read rowsQuery.data?.rows and
|
|
115
117
|
// silently show an empty list otherwise; the renderer now guards against a
|