@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
|
@@ -32,8 +32,8 @@ export function runDefinitionStep(feature, check, step) {
|
|
|
32
32
|
}
|
|
33
33
|
catch (thrown) {
|
|
34
34
|
if (isRuntimeCrash(thrown)) {
|
|
35
|
-
// Follow-up of an earlier violation (a failed step returned undefined); without one it is a real bug.
|
|
36
|
-
if (collector.
|
|
35
|
+
// Follow-up of an earlier violation of this feature (a failed step returned undefined); without one it is a real bug.
|
|
36
|
+
if (!collector.some((violation) => violation.feature === feature))
|
|
37
37
|
throw thrown;
|
|
38
38
|
return undefined;
|
|
39
39
|
}
|
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
import { isSqlDerivedField, } from "@cosmicdrift/kumiko-types/fields";
|
|
2
|
-
import { ENTITY_CONVENTION_QUERY_BRAND } from "@cosmicdrift/kumiko-types/handlers";
|
|
2
|
+
import { ENTITY_CONVENTION_QUERY_BRAND, ENTITY_CONVENTION_WRITE_BRAND, } from "@cosmicdrift/kumiko-types/handlers";
|
|
3
3
|
import { listAggregatePayloadSchema, } from "@cosmicdrift/kumiko-types/list-aggregate-types";
|
|
4
4
|
import * as z from "zod";
|
|
5
5
|
import { collectReferenceFields, enrichRowWithReferences, enrichWithReferences, } from "../db/eagerload.js";
|
|
@@ -357,6 +357,7 @@ export function defineEntityWriteHandler(name, entity, options) {
|
|
|
357
357
|
name,
|
|
358
358
|
schema,
|
|
359
359
|
handler,
|
|
360
|
+
[ENTITY_CONVENTION_WRITE_BRAND]: true,
|
|
360
361
|
access: options.access,
|
|
361
362
|
...(options.description !== undefined && { description: options.description }),
|
|
362
363
|
...(agentHints !== undefined && { agent: agentHints }),
|
|
@@ -502,27 +503,21 @@ export function defineEntityQueryHandler(name, entity, options) {
|
|
|
502
503
|
// runtime that entity.softDelete === true. A compile-time-only check
|
|
503
504
|
// would need a Branded-EntityDefinition with `softDelete: true` literal
|
|
504
505
|
// — feasible but not yet wired; the runtime guard catches misuse.
|
|
505
|
-
// @wrapper-known semantic-alias
|
|
506
506
|
export function defineEntityCreateHandler(entityName, entity, options) {
|
|
507
507
|
return defineEntityWriteHandler(`${entityName}:create`, entity, options);
|
|
508
508
|
}
|
|
509
|
-
// @wrapper-known semantic-alias
|
|
510
509
|
export function defineEntityUpdateHandler(entityName, entity, options) {
|
|
511
510
|
return defineEntityWriteHandler(`${entityName}:update`, entity, options);
|
|
512
511
|
}
|
|
513
|
-
// @wrapper-known semantic-alias
|
|
514
512
|
export function defineEntityDeleteHandler(entityName, entity, options) {
|
|
515
513
|
return defineEntityWriteHandler(`${entityName}:delete`, entity, options);
|
|
516
514
|
}
|
|
517
|
-
// @wrapper-known semantic-alias
|
|
518
515
|
export function defineEntityRestoreHandler(entityName, entity, options) {
|
|
519
516
|
return defineEntityWriteHandler(`${entityName}:restore`, entity, options);
|
|
520
517
|
}
|
|
521
|
-
// @wrapper-known semantic-alias
|
|
522
518
|
export function defineEntityListHandler(entityName, entity, options) {
|
|
523
519
|
return defineEntityQueryHandler(`${entityName}:list`, entity, options);
|
|
524
520
|
}
|
|
525
|
-
// @wrapper-known semantic-alias
|
|
526
521
|
export function defineEntityDetailHandler(entityName, entity, options) {
|
|
527
522
|
return defineEntityQueryHandler(`${entityName}:detail`, entity, options);
|
|
528
523
|
}
|
|
@@ -568,7 +563,7 @@ export function defineProjectionQueryHandler(name, projectionQualifiedName, opti
|
|
|
568
563
|
// helper is a drop-in for the inline `async (_q, ctx) => ctx.dispatch.queryProjection(...)`
|
|
569
564
|
// handler. Wrap the result in the caller's handler when you need
|
|
570
565
|
// pagination envelopes or added metadata.
|
|
571
|
-
handler: async (_query, ctx) => ctx.dispatch.queryProjection(projectionQualifiedName, options.unsafeAllTenants ? { unsafeAllTenants: true } : undefined),
|
|
566
|
+
handler: async (_query, ctx) => ctx.dispatch.queryProjection(projectionQualifiedName, options.unsafeAllTenants ? { unsafeAllTenants: true } : undefined),
|
|
572
567
|
access: options.access,
|
|
573
568
|
...(escapeHatch && { escapeHatch }),
|
|
574
569
|
};
|
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
import { collectEntityDetailAccess,
|
|
1
|
+
import { collectEntityDetailAccess, collectEntityQueryAccess } from "../api/entity-read-access.js";
|
|
2
2
|
import { resolveTableName } from "../db/entity-table-meta.js";
|
|
3
3
|
import { labelListAggregateGroups } from "../db/list-aggregate-labels.js";
|
|
4
4
|
import { buildEntityTable } from "../db/table-builder.js";
|
|
@@ -18,12 +18,15 @@ function memoizePerRegistry(collect) {
|
|
|
18
18
|
};
|
|
19
19
|
}
|
|
20
20
|
const detailAccessOf = memoizePerRegistry(collectEntityDetailAccess);
|
|
21
|
-
const
|
|
21
|
+
const queryAccessOf = memoizePerRegistry(collectEntityQueryAccess);
|
|
22
22
|
// An entity with a backingTable is read from that table; the implicit projection holds it.
|
|
23
|
-
function
|
|
24
|
-
|
|
23
|
+
function implicitProjectionOf(ctx, entityName) {
|
|
24
|
+
return ctx.registry
|
|
25
25
|
.getProjectionsForSource(entityName)
|
|
26
26
|
.find((projection) => projection.name.endsWith(`:projection:${entityName}${IMPLICIT_PROJECTION_SUFFIX}`));
|
|
27
|
+
}
|
|
28
|
+
function readTableOf(ctx, entityName, entity) {
|
|
29
|
+
const implicit = implicitProjectionOf(ctx, entityName);
|
|
27
30
|
return implicit?.table ?? buildEntityTable(entityName, entity);
|
|
28
31
|
}
|
|
29
32
|
const readModelOwnersOf = memoizePerRegistry((registry) => {
|
|
@@ -66,7 +69,7 @@ export function entityListRuntime(ctx, entityName, user) {
|
|
|
66
69
|
const parentVisibility = parentVisibilityFor(ctx, user);
|
|
67
70
|
const resolveEntity = (name) => ctx.registry.getEntity(name);
|
|
68
71
|
const resolveTable = readTableResolver(ctx, "entityListRuntime");
|
|
69
|
-
const readRules =
|
|
72
|
+
const readRules = queryAccessOf(ctx.registry);
|
|
70
73
|
return {
|
|
71
74
|
runtimeOptions: {
|
|
72
75
|
...(ctx.services.searchAdapter !== undefined && {
|
|
@@ -100,9 +103,7 @@ export function entityListRuntime(ctx, entityName, user) {
|
|
|
100
103
|
// An entity with a backingTable reads and writes that table, whose name the entity's own
|
|
101
104
|
// `table` does not say; the implicit projection holds the table the executor really uses.
|
|
102
105
|
function physicalReadTableName(ctx, entityName, entity) {
|
|
103
|
-
const implicit = ctx
|
|
104
|
-
.getProjectionsForSource(entityName)
|
|
105
|
-
.find((projection) => projection.name.endsWith(`:projection:${entityName}${IMPLICIT_PROJECTION_SUFFIX}`));
|
|
106
|
+
const implicit = implicitProjectionOf(ctx, entityName);
|
|
106
107
|
return implicit !== undefined
|
|
107
108
|
? extractTableInfo(implicit.table).name
|
|
108
109
|
: resolveTableName(entityName, entity, undefined);
|
|
@@ -192,6 +192,8 @@ export declare function createEntity<const F, const T extends EntityTenancy = "t
|
|
|
192
192
|
/** Event stream lives on SYSTEM_TENANT_ID (tenant-independent aggregate, e.g.
|
|
193
193
|
* user) instead of the creator's tenant. See EntityDefinition.systemStream. */
|
|
194
194
|
readonly systemStream?: boolean;
|
|
195
|
+
/** See EntityDefinition.systemRowsReadable. */
|
|
196
|
+
readonly systemRowsReadable?: boolean;
|
|
195
197
|
/** See EntityDefinition.webhookEvents. */
|
|
196
198
|
readonly webhookEvents?: boolean;
|
|
197
199
|
readonly eventVersion?: number;
|
|
@@ -214,6 +214,7 @@ export function buildConfigEventsJobsMethods(state, name) {
|
|
|
214
214
|
}
|
|
215
215
|
state.metrics[shortName] = { shortName, ...metricOptions };
|
|
216
216
|
},
|
|
217
|
+
// guard:dup-ok builder setter shape, sharing would add a parameter per line
|
|
217
218
|
envSchema(schema) {
|
|
218
219
|
if (state.envSchema !== undefined) {
|
|
219
220
|
throw bootRuleError(DEFINITION_CONFIG_EVENTS_JOBS_RULES.envSchemaTwice, {
|
|
@@ -1,9 +1,9 @@
|
|
|
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 { toTableName } from "../db/table-builder.js";
|
|
3
3
|
import { bootRuleError } from "./boot-validator/boot-rule.js";
|
|
4
4
|
import { DEFINITION_HANDLER_RULES } from "./boot-validator/definition-handlers-rules.js";
|
|
5
5
|
import { HANDLER_ACCESS_RULES } from "./boot-validator/entity-handler-access-rules.js";
|
|
6
|
-
import { isEntityConventionQueryHandler, isPagedQueryHandler, PAGED_QUERY_HANDLER_BRAND, } from "./define-handler.js";
|
|
6
|
+
import { isEntityConventionQueryHandler, isEntityConventionWriteHandler, isPagedQueryHandler, PAGED_QUERY_HANDLER_BRAND, } from "./define-handler.js";
|
|
7
7
|
import { assertEscapeHatchAccessIsSystemAdminOnly, registerCrudHandlers, } from "./entity-handlers.js";
|
|
8
8
|
import { agentSlots, transactionPhaseSlots } from "./handler-definition-slots.js";
|
|
9
9
|
import { resolveName } from "./handler-helpers.js";
|
|
@@ -119,6 +119,9 @@ export function buildEntityHandlerMethods(state, name) {
|
|
|
119
119
|
handler: def.handler,
|
|
120
120
|
access: def.access,
|
|
121
121
|
...agentSlots(def),
|
|
122
|
+
...(isEntityConventionWriteHandler(def) && {
|
|
123
|
+
[ENTITY_CONVENTION_WRITE_BRAND]: true,
|
|
124
|
+
}),
|
|
122
125
|
...(def.excludedFields && { excludedFields: def.excludedFields }),
|
|
123
126
|
...(def.unsafeSkipTransitionGuard && { unsafeSkipTransitionGuard: true }),
|
|
124
127
|
...(def.rateLimit && { rateLimit: def.rateLimit }),
|
|
@@ -6,5 +6,5 @@ export declare function dropEmptyWriteOnlyValues<T extends Readonly<Record<strin
|
|
|
6
6
|
export declare function userMayReadFieldInBulk(entity: EntityDefinition, fieldName: string, user: Pick<SessionUser, "roles">): boolean;
|
|
7
7
|
export declare function filterReadFields(entity: EntityDefinition, data: Readonly<Record<string, unknown>>, user: SessionUser): Record<string, unknown>;
|
|
8
8
|
export declare function checkWriteFieldRoles(entity: EntityDefinition, changes: Readonly<Record<string, unknown>>, user: SessionUser): string | null;
|
|
9
|
-
export declare function checkWriteFieldOwnership(entity: EntityDefinition, submittedChanges: Readonly<Record<string, unknown>>, user: SessionUser, oldRow?: Readonly<Record<string, unknown>>, rowContext?: Readonly<Record<string, unknown
|
|
9
|
+
export declare function checkWriteFieldOwnership(entity: EntityDefinition, submittedChanges: Readonly<Record<string, unknown>>, user: SessionUser, oldRow?: Readonly<Record<string, unknown>>, rowContext?: Readonly<Record<string, unknown>>, checkEmbeddedSubFields?: boolean): string | null;
|
|
10
10
|
export declare function userHasWriteRole(user: Pick<SessionUser, "roles">, accessMap: OwnershipMap): boolean;
|
|
@@ -1,4 +1,5 @@
|
|
|
1
1
|
import { normalizeAccessEntry, userCanReadFieldRow, userCanWriteFieldRow, } from "./ownership.js";
|
|
2
|
+
import { isUnchangedValue } from "./screen-helpers.js";
|
|
2
3
|
function writeOnlyFieldNames(entity) {
|
|
3
4
|
const names = [];
|
|
4
5
|
for (const [name, field] of Object.entries(entity.fields)) {
|
|
@@ -145,12 +146,15 @@ export function checkWriteFieldRoles(entity, changes, user) {
|
|
|
145
146
|
//
|
|
146
147
|
// Returns the denied field name for the caller to wrap into an
|
|
147
148
|
// `ownership_denied` error with scope: "field", or null if all fields pass.
|
|
148
|
-
export function checkWriteFieldOwnership(entity, submittedChanges, user, oldRow, rowContext = submittedChanges
|
|
149
|
+
export function checkWriteFieldOwnership(entity, submittedChanges, user, oldRow, rowContext = submittedChanges,
|
|
150
|
+
// Off for the nested-write parent check: it asserts ownership of an existing row, nothing is
|
|
151
|
+
// being written to its embedded sub-fields.
|
|
152
|
+
checkEmbeddedSubFields = true) {
|
|
149
153
|
for (const key of Object.keys(submittedChanges)) {
|
|
150
154
|
const field = entity.fields[key];
|
|
151
155
|
if (!field)
|
|
152
156
|
continue;
|
|
153
|
-
if (field.type === "embedded") {
|
|
157
|
+
if (field.type === "embedded" && checkEmbeddedSubFields) {
|
|
154
158
|
const deniedSubField = deniedEmbeddedSubField(field, submittedChanges[key], oldRow?.[key], user);
|
|
155
159
|
if (deniedSubField)
|
|
156
160
|
return `${key}.${deniedSubField}`;
|
|
@@ -185,13 +189,6 @@ function embeddedRows(value) {
|
|
|
185
189
|
return value.map((row) => (isRecord(row) ? row : undefined));
|
|
186
190
|
return isRecord(value) ? [value] : [];
|
|
187
191
|
}
|
|
188
|
-
function stableJson(value) {
|
|
189
|
-
return JSON.stringify(value, (_key, nested) => {
|
|
190
|
-
if (!nested || typeof nested !== "object" || Array.isArray(nested))
|
|
191
|
-
return nested;
|
|
192
|
-
return Object.fromEntries(Object.entries(nested).sort(([a], [b]) => a.localeCompare(b)));
|
|
193
|
-
});
|
|
194
|
-
}
|
|
195
192
|
// Sub-field write rules of an embedded field, enforced on save. Rows are paired by index;
|
|
196
193
|
// a sub-field counts as written when its value differs between old and new row (an added or
|
|
197
194
|
// removed row that carries a value counts too). The rule is evaluated against the embedded
|
|
@@ -206,7 +203,7 @@ function deniedEmbeddedSubField(field, newValue, oldValue, user) {
|
|
|
206
203
|
for (let i = 0; i < Math.max(newRows.length, oldRows.length); i++) {
|
|
207
204
|
const newRow = newRows[i];
|
|
208
205
|
const oldRow = oldRows[i];
|
|
209
|
-
if (
|
|
206
|
+
if (isUnchangedValue(newRow?.[subKey], oldRow?.[subKey]))
|
|
210
207
|
continue;
|
|
211
208
|
const rowAfter = newRow ?? oldRow ?? {};
|
|
212
209
|
if (!userCanWriteFieldRow(user, accessMap, oldRow ?? rowAfter, rowAfter))
|
|
@@ -1,8 +1,8 @@
|
|
|
1
1
|
export function findEntity(features, entityName) {
|
|
2
2
|
for (const feature of features.values()) {
|
|
3
|
-
const
|
|
4
|
-
if (
|
|
5
|
-
return
|
|
3
|
+
const entities = feature.entities;
|
|
4
|
+
if (entities && Object.hasOwn(entities, entityName))
|
|
5
|
+
return entities[entityName];
|
|
6
6
|
}
|
|
7
7
|
return undefined;
|
|
8
8
|
}
|
|
@@ -1,6 +1,6 @@
|
|
|
1
|
+
import { toMajorUnits, toMinorUnits } from "@cosmicdrift/kumiko-types/minor-units";
|
|
1
2
|
import { isPlainObject } from "@cosmicdrift/kumiko-types/type-guards";
|
|
2
3
|
import { computeDerivedCellValue, roundDerivedCellValue, withDerivedCells, } from "./embedded-derived.js";
|
|
3
|
-
import { MINOR_UNIT_SCALE, toMinorUnits } from "./minor-units.js";
|
|
4
4
|
function readMoneyOperand(raw) {
|
|
5
5
|
if (typeof raw === "number")
|
|
6
6
|
return { minor: toMinorUnits(raw), currency: undefined };
|
|
@@ -172,8 +172,8 @@ export function applyFormDerivations(values, screen) {
|
|
|
172
172
|
const currency = targetCurrency(targetField, result[target], sourceCurrency);
|
|
173
173
|
result[target] =
|
|
174
174
|
currency === undefined
|
|
175
|
-
? { amount: minor
|
|
176
|
-
: { amount: minor
|
|
175
|
+
? { amount: toMajorUnits(minor) }
|
|
176
|
+
: { amount: toMajorUnits(minor), currency };
|
|
177
177
|
}
|
|
178
178
|
else if (targetField.type === "decimal") {
|
|
179
179
|
result[target] = roundDerivedCellValue(computed, targetField);
|
package/dist/engine/index.d.ts
CHANGED
|
@@ -6,7 +6,7 @@ export type { ExtensionOptionsArgs, ExtensionOptionsFor, KumikoExtensionOptionsM
|
|
|
6
6
|
export type { BootOptionName, SecretKeyDefinition, SecretKeyHandle, SecretNamespaceDefinition, SecretNamespaceHandle, SecretNamespaceOptions, WebhookEntityVerb, WebhookEventContract, WebhookEventHandle, } from "@cosmicdrift/kumiko-types/feature";
|
|
7
7
|
export type { FeatureRegistrar } from "@cosmicdrift/kumiko-types/feature-registrar";
|
|
8
8
|
export type { DeriveContext, EntityDefinition, FieldDefinition, JsonbFieldDef, ResolvedPiiFlags, RetentionDef, } from "@cosmicdrift/kumiko-types/fields";
|
|
9
|
-
export type { AccessRule, AgentEffect, AgentHandlerHints, AgentRisk, AuthClaimsContext, BeforeTransactionResult, ChatSendFailureCode, ClaimKeyType, DeliveryErrorCode, DeliveryFailureCode, DeliverySkipReason, EscapeHatchAuditSink, EscapeHatchDeclaration, EscapeHatchKind, EscapeHatchUseEvent, EventDef, JobContext, JobDeferral, NotifyDelivery, NotifyDeliveryStatus, NotifyDispatched, NotifyFactory, NotifyFn, NotifyJobDispatcher, NotifyOptions, NotifyPriority, NotifyResult, QueryHandlerDef, RateLimitPer, RoleAccessPersonalData, RoleAccessRule, StreamHandlerDef, TenantWriteTarget, WriteEvent, WriteHandlerDef, WriteHandlerFn, WriteResult, } from "@cosmicdrift/kumiko-types/handlers";
|
|
9
|
+
export type { AccessRule, AgentEffect, AgentHandlerHints, AgentRisk, AuthClaimsContext, BeforeTransactionResult, ChatSendFailureCode, ClaimKeyType, DeliveryAttemptLogEntry, DeliveryAttemptLogFactory, DeliveryAttemptLogFn, DeliveryErrorCode, DeliveryFailureCode, DeliverySkipReason, EscapeHatchAuditSink, EscapeHatchDeclaration, EscapeHatchKind, EscapeHatchUseEvent, EventDef, JobContext, JobDeferral, NotifyDelivery, NotifyDeliveryStatus, NotifyDispatched, NotifyFactory, NotifyFn, NotifyJobDispatcher, NotifyOptions, NotifyPriority, NotifyResult, QueryHandlerDef, RateLimitPer, RoleAccessPersonalData, RoleAccessRule, StreamHandlerDef, TenantWriteTarget, WriteEvent, WriteHandlerDef, WriteHandlerFn, WriteResult, } from "@cosmicdrift/kumiko-types/handlers";
|
|
10
10
|
export { DELIVERY_FAILURE_CODES, DELIVERY_SKIP_REASONS, HTTP_ERROR_CODE_PATTERN, isDeliveryErrorCode, isOpenToAllGranted, } from "@cosmicdrift/kumiko-types/handlers";
|
|
11
11
|
export type { DeleteContext, PostDeleteHookFn, PostSaveHookFn, PreDeleteHookFn, PreSaveHookFn, SaveContext, ValidationError, ValidationHookFn, } from "@cosmicdrift/kumiko-types/hooks";
|
|
12
12
|
export type { EntityId } from "@cosmicdrift/kumiko-types/identifiers";
|
|
@@ -87,7 +87,7 @@ export type { AssignableAppRoles } from "./role-assignment.ts";
|
|
|
87
87
|
export { assignableAppRolesFromUsages, assignableAppRolesOf, BUILT_IN_MEMBERSHIP_ROLES, canActorAssignRole, findForbiddenRoleAssignment, isAssignableByRole, mergeAssignedRoles, } from "./role-assignment.ts";
|
|
88
88
|
export { runPipeline, runStepList } from "./run-pipeline.ts";
|
|
89
89
|
export { buildInsertSchema, buildUpdateSchema, fieldToZod, SYSTEM_ONLY_JSON_SCHEMA_KEY, } from "./schema-builder.ts";
|
|
90
|
-
export { isFieldsEditSection, normalizeEditField, normalizeListColumn, sectionFieldSpecs, } from "./screen-helpers.ts";
|
|
90
|
+
export { isFieldsEditSection, isUnchangedValue, normalizeEditField, normalizeListColumn, screenShortId, sectionFieldSpecs, } from "./screen-helpers.ts";
|
|
91
91
|
export { DEFAULT_GRACE_DAYS as SOFT_DELETE_DEFAULT_GRACE_DAYS, readSoftDeleteGraceDays, SOFT_DELETE_GRACE_DAYS_KEY, } from "./soft-delete-cleanup.ts";
|
|
92
92
|
export type { TransitionGraph } from "./state-machine.ts";
|
|
93
93
|
export { defineTransitions, guardTransition } from "./state-machine.ts";
|
|
@@ -104,6 +104,6 @@ export { isSystemTenant, isUuid, parseTenantId, SYSTEM_TENANT_ID } from "./types
|
|
|
104
104
|
export type { AppContext, BeforeTransactionContext, FeatureDefinition, HandlerAuth, HandlerContext, HandlerDb, HandlerDispatch, HandlerEvents, HandlerObservability, JobDispatch, JobEvents, JobObservability, QueryEvent, Registry, ReservationContext, SessionUser, TenantId, } from "./types/index.ts";
|
|
105
105
|
export type { AwaitedEventType, PipelineCtx, StepInstance, StepResolver, } from "./types/step.ts";
|
|
106
106
|
export { walkStepInstances } from "./walk-step-instances.ts";
|
|
107
|
-
export { createWebhookContractResolver, type WebhookContractResolver, } from "./webhook-contracts.ts";
|
|
107
|
+
export { createWebhookContractResolver, WEBHOOK_ENTITY_VERBS, type WebhookContractResolver, } from "./webhook-contracts.ts";
|
|
108
108
|
export { formatWebhookPayloadIssues, parseWebhookPayload, toEntityWebhookPayload, type WebhookPayloadIssue, type WebhookPayloadResult, } from "./webhook-events.ts";
|
|
109
109
|
export { withFormDerivations } from "./with-form-derivations.ts";
|
package/dist/engine/index.js
CHANGED
|
@@ -70,7 +70,7 @@ export { resolveNamedListFilters } from "./resolve-named-list-filters.js";
|
|
|
70
70
|
export { assignableAppRolesFromUsages, assignableAppRolesOf, BUILT_IN_MEMBERSHIP_ROLES, canActorAssignRole, findForbiddenRoleAssignment, isAssignableByRole, mergeAssignedRoles, } from "./role-assignment.js";
|
|
71
71
|
export { runPipeline, runStepList } from "./run-pipeline.js";
|
|
72
72
|
export { buildInsertSchema, buildUpdateSchema, fieldToZod, SYSTEM_ONLY_JSON_SCHEMA_KEY, } from "./schema-builder.js";
|
|
73
|
-
export { isFieldsEditSection, normalizeEditField, normalizeListColumn, sectionFieldSpecs, } from "./screen-helpers.js";
|
|
73
|
+
export { isFieldsEditSection, isUnchangedValue, normalizeEditField, normalizeListColumn, screenShortId, sectionFieldSpecs, } from "./screen-helpers.js";
|
|
74
74
|
export { DEFAULT_GRACE_DAYS as SOFT_DELETE_DEFAULT_GRACE_DAYS, readSoftDeleteGraceDays, SOFT_DELETE_GRACE_DAYS_KEY, } from "./soft-delete-cleanup.js";
|
|
75
75
|
export { defineTransitions, guardTransition } from "./state-machine.js";
|
|
76
76
|
export { evaluateEventMatch } from "./steps/_event-match.js";
|
|
@@ -84,6 +84,6 @@ export { findTierResolverUsage, isTierResolverPlugin, requireTierResolverPlugin,
|
|
|
84
84
|
export { findOverDeepTransferChain, resolveTransferAdjacency as resolveEntityTransferAdjacency, } from "./transfer-adjacency.js";
|
|
85
85
|
export { isSystemTenant, isUuid, parseTenantId, SYSTEM_TENANT_ID } from "./types/identifiers.js";
|
|
86
86
|
export { walkStepInstances } from "./walk-step-instances.js";
|
|
87
|
-
export { createWebhookContractResolver, } from "./webhook-contracts.js";
|
|
87
|
+
export { createWebhookContractResolver, WEBHOOK_ENTITY_VERBS, } from "./webhook-contracts.js";
|
|
88
88
|
export { formatWebhookPayloadIssues, parseWebhookPayload, toEntityWebhookPayload, } from "./webhook-events.js";
|
|
89
89
|
export { withFormDerivations } from "./with-form-derivations.js";
|
|
@@ -0,0 +1,3 @@
|
|
|
1
|
+
import type { NamedListFilterDef } from "@cosmicdrift/kumiko-types/named-list-filters";
|
|
2
|
+
import type { EntityListScreenDefinition } from "../ui-types/index.ts";
|
|
3
|
+
export declare function projectNamedFilterRoles(screen: EntityListScreenDefinition, defs: Readonly<Record<string, NamedListFilterDef>> | undefined): EntityListScreenDefinition;
|
|
@@ -0,0 +1,15 @@
|
|
|
1
|
+
// `access` on a ref is framework-owned: an authored value is dropped so a screen cannot widen the
|
|
2
|
+
// entity filter's access rule on the client. A rule is plain data (roles, openToAll), safe to serialize.
|
|
3
|
+
function refWithEntityAccess(ref, defs) {
|
|
4
|
+
const { access: _authored, ...plain } = ref;
|
|
5
|
+
const def = Object.hasOwn(defs, ref.id) ? defs[ref.id] : undefined;
|
|
6
|
+
return def?.access === undefined ? plain : { ...plain, access: def.access };
|
|
7
|
+
}
|
|
8
|
+
export function projectNamedFilterRoles(screen, defs) {
|
|
9
|
+
if (screen.namedFilters === undefined)
|
|
10
|
+
return screen;
|
|
11
|
+
return {
|
|
12
|
+
...screen,
|
|
13
|
+
namedFilters: screen.namedFilters.map((ref) => refWithEntityAccess(ref, defs ?? {})),
|
|
14
|
+
};
|
|
15
|
+
}
|
package/dist/engine/pipeline.js
CHANGED
|
@@ -67,7 +67,6 @@ export function stepsPipeline(closure) {
|
|
|
67
67
|
}
|
|
68
68
|
// Internal: invoked by run-pipeline.ts to materialise the step list.
|
|
69
69
|
// Not exported from the engine barrel — pipeline-internal plumbing.
|
|
70
|
-
// @wrapper-known semantic-alias
|
|
71
70
|
//
|
|
72
71
|
// `awaits` comes off pipelineDef itself (set by defineWorkflow), not a
|
|
73
72
|
// function argument — every existing buildPipelineSteps caller (runner.ts,
|
|
@@ -451,18 +451,31 @@ function projectListScreen(original, feature, indices, keptScreenQns) {
|
|
|
451
451
|
...(nextExpandableRow !== undefined && { expandableRow: nextExpandableRow }),
|
|
452
452
|
};
|
|
453
453
|
}
|
|
454
|
+
function projectGuidanceActions(block, feature, indices, keptScreenQns) {
|
|
455
|
+
if (block === undefined)
|
|
456
|
+
return undefined;
|
|
457
|
+
const nextActions = projectActionArray(block.actions, feature, indices, keptScreenQns);
|
|
458
|
+
if (nextActions === block.actions)
|
|
459
|
+
return block;
|
|
460
|
+
const { actions, ...rest } = block;
|
|
461
|
+
return { ...rest, ...(nextActions !== undefined && { actions: nextActions }) };
|
|
462
|
+
}
|
|
454
463
|
function projectProjectionDetailScreen(screen, feature, indices, keptScreenQns) {
|
|
455
|
-
const { metrics, header, actions, layout, listScreenId, ...rest } = screen;
|
|
464
|
+
const { metrics, header, actions, layout, listScreenId, banner, steps, ...rest } = screen;
|
|
456
465
|
const nextMetrics = projectMetrics(metrics, indices, keptScreenQns);
|
|
457
466
|
const nextHeader = projectHeader(header, indices, keptScreenQns);
|
|
458
467
|
const nextActions = projectActionArray(actions, feature, indices, keptScreenQns);
|
|
459
468
|
const nextLayout = projectEditLayout(layout, feature, indices, keptScreenQns);
|
|
460
469
|
const nextListScreenId = projectListScreenId(listScreenId, indices, keptScreenQns);
|
|
470
|
+
const nextBanner = projectGuidanceActions(banner, feature, indices, keptScreenQns);
|
|
471
|
+
const nextSteps = projectGuidanceActions(steps, feature, indices, keptScreenQns);
|
|
461
472
|
const unchanged = nextMetrics === metrics &&
|
|
462
473
|
nextHeader === header &&
|
|
463
474
|
nextActions === actions &&
|
|
464
475
|
nextLayout === layout &&
|
|
465
|
-
nextListScreenId === listScreenId
|
|
476
|
+
nextListScreenId === listScreenId &&
|
|
477
|
+
nextBanner === banner &&
|
|
478
|
+
nextSteps === steps;
|
|
466
479
|
if (unchanged)
|
|
467
480
|
return screen;
|
|
468
481
|
return {
|
|
@@ -472,6 +485,8 @@ function projectProjectionDetailScreen(screen, feature, indices, keptScreenQns)
|
|
|
472
485
|
...(nextMetrics !== undefined && { metrics: nextMetrics }),
|
|
473
486
|
...(nextActions !== undefined && { actions: nextActions }),
|
|
474
487
|
...(nextListScreenId !== undefined && { listScreenId: nextListScreenId }),
|
|
488
|
+
...(nextBanner !== undefined && { banner: nextBanner }),
|
|
489
|
+
...(nextSteps !== undefined && { steps: nextSteps }),
|
|
475
490
|
};
|
|
476
491
|
}
|
|
477
492
|
function projectEntityEditScreen(screen, feature, indices, keptScreenQns) {
|
|
@@ -103,7 +103,6 @@ export function isValidQn(value) {
|
|
|
103
103
|
// True if `name` is a valid QN segment (lowercase letters, digits, dashes;
|
|
104
104
|
// starts with a letter). Same rule as `QN_SEGMENT` — kept public so feature
|
|
105
105
|
// registration can reject bad names at the source instead of at registry-boot.
|
|
106
|
-
// @wrapper-known semantic-alias
|
|
107
106
|
export function isKebabSegment(name) {
|
|
108
107
|
return QN_SEGMENT.test(name);
|
|
109
108
|
}
|
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
import { filterByPhase, filterOwned } from "./registry-state.js";
|
|
2
|
-
import {
|
|
2
|
+
import { createWebhookContractResolver, } from "./webhook-contracts.js";
|
|
3
3
|
function isFeatureSystemScoped(state, featureName) {
|
|
4
4
|
if (!featureName)
|
|
5
5
|
return false;
|
|
@@ -10,7 +10,6 @@ function isFeatureSystemScoped(state, featureName) {
|
|
|
10
10
|
// return-object literal, only the closure-captured variable changed
|
|
11
11
|
// (state.X instead of bare X, done in the RegistryState-threading step).
|
|
12
12
|
export function buildRegistryFacade(state) {
|
|
13
|
-
assertUniqueWebhookWireNames([...state.featureMap.values()]);
|
|
14
13
|
let resolver;
|
|
15
14
|
const webhookContracts = () => {
|
|
16
15
|
resolver ??= createWebhookContractResolver([...state.featureMap.values()]);
|
|
@@ -23,7 +23,7 @@ export type SearchableReferenceField = {
|
|
|
23
23
|
};
|
|
24
24
|
export type SortableReferenceField = SearchableReferenceField;
|
|
25
25
|
export declare const IMPLICIT_PROJECTION_SUFFIX: "-entity";
|
|
26
|
-
export declare function buildImplicitProjection(featureName: string, entityName: string, entity: EntityDefinition, qualify: typeof qualifyEntityName, backingTable?: unknown, extensions?: readonly EntityProjectionExtension[]): ProjectionDefinition;
|
|
26
|
+
export declare function buildImplicitProjection(featureName: string, entityName: string, entity: EntityDefinition, qualify: typeof qualifyEntityName, backingTable?: unknown, extensions?: readonly EntityProjectionExtension[], readsSystemRows?: boolean): ProjectionDefinition;
|
|
27
27
|
export declare const qualify: typeof qualifyEntityName;
|
|
28
28
|
export type RegistryState = {
|
|
29
29
|
featureMap: Map<string, FeatureDefinition>;
|
|
@@ -2,7 +2,7 @@ import { applyEntityEvent } from "../db/apply-entity-event.js";
|
|
|
2
2
|
import { assertBackingTableSuperset, deriveEntityTableMeta } from "../db/entity-table-meta.js";
|
|
3
3
|
import { markExecutorManagedTable } from "../db/executor-managed-tables.js";
|
|
4
4
|
import { asEntityTableMeta } from "../db/query.js";
|
|
5
|
-
import { buildEntityTable } from "../db/table-builder.js";
|
|
5
|
+
import { buildEntityTable, declareSystemRowsReadable } from "../db/table-builder.js";
|
|
6
6
|
import { qualifyEntityName } from "./qualified-name.js";
|
|
7
7
|
export const IMPLICIT_PROJECTION_SUFFIX = "-entity";
|
|
8
8
|
// Each `r.entity` registration gets an implicit projection with generated
|
|
@@ -11,7 +11,7 @@ export const IMPLICIT_PROJECTION_SUFFIX = "-entity";
|
|
|
11
11
|
// events through this definition. Both call applyEntityEvent, ensuring live
|
|
12
12
|
// and rebuild use the same logic (also covered by
|
|
13
13
|
// implicit-projection-equivalence.integration.ts).
|
|
14
|
-
export function buildImplicitProjection(featureName, entityName, entity, qualify, backingTable, extensions = []) {
|
|
14
|
+
export function buildImplicitProjection(featureName, entityName, entity, qualify, backingTable, extensions = [], readsSystemRows = false) {
|
|
15
15
|
const name = qualify(featureName, "projection", `${entityName}${IMPLICIT_PROJECTION_SUFFIX}`);
|
|
16
16
|
// Backing table (r.entity({ name, ...def, backingTable })) is the one physical table
|
|
17
17
|
// object shared by executor-writes, rebuild-replay, test-push and
|
|
@@ -21,6 +21,9 @@ export function buildImplicitProjection(featureName, entityName, entity, qualify
|
|
|
21
21
|
const drizzleTable = backingTable !== undefined
|
|
22
22
|
? resolveBackingTable(entityName, entity, backingTable)
|
|
23
23
|
: buildEntityTable(entityName, entity);
|
|
24
|
+
// Push paths read the table's own meta, so the reference-data-derived flag must land there too.
|
|
25
|
+
if (readsSystemRows)
|
|
26
|
+
declareSystemRowsReadable(drizzleTable);
|
|
24
27
|
markExecutorManagedTable(drizzleTable, { entityName, entity });
|
|
25
28
|
// applyEntityEvent returns ApplyResult, but SingleStreamApplyFn expects
|
|
26
29
|
// Promise<void>. The row is irrelevant during rebuild, so we discard it.
|
|
@@ -1,6 +1,7 @@
|
|
|
1
1
|
import { isRateLimitDisabled } from "@cosmicdrift/kumiko-types/handlers";
|
|
2
2
|
import { configureEventPiiCatalog } from "../crypto/event-pii.js";
|
|
3
3
|
import { hasSearchablePlaintext, isSensitiveLabelField } from "../db/entity-field-encryption.js";
|
|
4
|
+
import { entityReadsSystemRows } from "../db/entity-table-meta.js";
|
|
4
5
|
import { entityEventName } from "../db/event-store-executor-context.js";
|
|
5
6
|
import { resolveMaxPerTenant } from "../jobs/max-per-tenant.js";
|
|
6
7
|
import { bindHookEscapeHatchGrant } from "../pipeline/system-identity-switch.js";
|
|
@@ -253,7 +254,7 @@ export function buildImplicitProjections(state, features) {
|
|
|
253
254
|
}
|
|
254
255
|
}
|
|
255
256
|
for (const [entityName, entity] of Object.entries(feature.entities ?? {})) {
|
|
256
|
-
const def = buildImplicitProjection(feature.name, entityName, entity, qualify, feature.entityTables?.[entityName], feature.entityProjectionExtensions?.[entityName] ?? []);
|
|
257
|
+
const def = buildImplicitProjection(feature.name, entityName, entity, qualify, feature.entityTables?.[entityName], feature.entityProjectionExtensions?.[entityName] ?? [], entityReadsSystemRows(feature, entityName, entity));
|
|
257
258
|
if (state.projectionMap.has(def.name)) {
|
|
258
259
|
throw new Error(`Implicit projection "${def.name}" kollidiert mit einer explizit registrierten r.projection. ` +
|
|
259
260
|
`Implicit-Projections werden für jede r.entity mit "-entity"-Suffix angelegt — ` +
|
|
@@ -1,3 +1,4 @@
|
|
|
1
|
+
import { rowMetaFieldNames } from "../db/table-builder.js";
|
|
1
2
|
import { AccessDeniedError, ValidationError } from "../errors/index.js";
|
|
2
3
|
import { hasAccess } from "./access.js";
|
|
3
4
|
export async function resolveNamedListFilters(ctx, user, entityName, name) {
|
|
@@ -19,10 +20,12 @@ export async function resolveNamedListFilters(ctx, user, entityName, name) {
|
|
|
19
20
|
throw new AccessDeniedError();
|
|
20
21
|
}
|
|
21
22
|
const conditions = await def.filters({ ctx, user, now: ctx.tz.now() });
|
|
22
|
-
const
|
|
23
|
+
const entity = ctx.registry.getEntity(entityName);
|
|
24
|
+
const entityFields = entity?.fields ?? {};
|
|
25
|
+
const rowMeta = rowMetaFieldNames(entity?.softDelete === true);
|
|
23
26
|
for (const condition of conditions) {
|
|
24
27
|
// Fail closed: a condition on a non-column is dropped by the list filter and would widen the queue.
|
|
25
|
-
if (condition.field
|
|
28
|
+
if (!Object.hasOwn(entityFields, condition.field) && !rowMeta.has(condition.field)) {
|
|
26
29
|
throw new Error(`Named filter "${name}" of entity "${entityName}" filters on unknown field "${condition.field}".`);
|
|
27
30
|
}
|
|
28
31
|
}
|
|
@@ -1,3 +1,4 @@
|
|
|
1
|
+
import { isFileHandle } from "@cosmicdrift/kumiko-types/identifiers";
|
|
1
2
|
import * as z from "zod";
|
|
2
3
|
import { moneyPayloadToMinorUnits } from "../db/money.js";
|
|
3
4
|
import { isValidIanaTimeZone } from "../time/index.js";
|
|
@@ -272,11 +273,11 @@ function locatedTimestampToZod() {
|
|
|
272
273
|
z.object({ utc, tz, at: at.optional() }),
|
|
273
274
|
]);
|
|
274
275
|
}
|
|
276
|
+
// A fileRef UUID (the type of fileRefsTable.id) or the handle of a pending anonymous upload,
|
|
277
|
+
// which the executor resolves to the bare UUID before anything is stored.
|
|
278
|
+
const fileRefReferenceToZod = () => z.union([z.uuid(), z.string().refine(isFileHandle, { message: "invalid file handle" })]);
|
|
275
279
|
function fileListFieldToZod(field) {
|
|
276
|
-
|
|
277
|
-
// variant — the element type has to match the UUID column on
|
|
278
|
-
// fileRefsTable.id.
|
|
279
|
-
const ids = z.array(z.uuid());
|
|
280
|
+
const ids = z.array(fileRefReferenceToZod());
|
|
280
281
|
return field.maxCount === undefined ? ids : ids.max(field.maxCount);
|
|
281
282
|
}
|
|
282
283
|
export function fieldToZod(field, currencies, opts = {}) {
|
|
@@ -335,12 +336,7 @@ export function fieldToZod(field, currencies, opts = {}) {
|
|
|
335
336
|
return locatedTimestampToZod();
|
|
336
337
|
case "file":
|
|
337
338
|
case "image":
|
|
338
|
-
|
|
339
|
-
// (uuid column). Pre-fix this was z.number() from an era when the
|
|
340
|
-
// column was (wrongly) integer; the table-builder fix to uuid needs
|
|
341
|
-
// a matching validation-layer fix here or the CRUD pipeline rejects
|
|
342
|
-
// every valid UUID with "expected number".
|
|
343
|
-
return z.uuid();
|
|
339
|
+
return fileRefReferenceToZod();
|
|
344
340
|
case "files":
|
|
345
341
|
case "images":
|
|
346
342
|
return fileListFieldToZod(field);
|
|
@@ -351,7 +347,9 @@ export function fieldToZod(field, currencies, opts = {}) {
|
|
|
351
347
|
// validator's; checking it here would require a database round trip during
|
|
352
348
|
// parsing.
|
|
353
349
|
// Multi-mode accepts an array of UUIDs.
|
|
354
|
-
return field.multiple === true
|
|
350
|
+
return field.multiple === true
|
|
351
|
+
? z.array(z.uuid().meta({ references: field.entity }))
|
|
352
|
+
: z.uuid().meta({ references: field.entity });
|
|
355
353
|
default:
|
|
356
354
|
assertUnreachable(field, "field type");
|
|
357
355
|
}
|
|
@@ -27,6 +27,17 @@ export declare function normalizeListColumn(c: ListColumnSpec): Exclude<ListColu
|
|
|
27
27
|
* (form-condition closures) reuse it; three hand-rolled copies had
|
|
28
28
|
* already drifted in shape. */
|
|
29
29
|
export declare function evalFieldCondition(cond: FieldCondition, values: Record<string, unknown>): boolean;
|
|
30
|
+
type EmptyStateText = {
|
|
31
|
+
readonly title: string;
|
|
32
|
+
readonly description?: string | undefined;
|
|
33
|
+
};
|
|
34
|
+
/** Picks the first emptyState variant whose `when` matches the record, else the base emptyState.
|
|
35
|
+
* Shared by the renderer and the specs' tests so they cannot diverge. */
|
|
36
|
+
export declare function pickEmptyStateText<Variant extends EmptyStateText & {
|
|
37
|
+
readonly when: FieldCondition;
|
|
38
|
+
}, EmptyState extends EmptyStateText & {
|
|
39
|
+
readonly variants?: readonly Variant[];
|
|
40
|
+
}>(emptyState: EmptyState | undefined, record: Readonly<Record<string, unknown>>): EmptyState | Variant | undefined;
|
|
30
41
|
export declare function isRecordLocked(lockedWhen: FieldCondition | undefined, row: Readonly<Record<string, unknown>>): boolean;
|
|
31
42
|
type SelectOptionRules = Pick<SelectFieldDef, "options" | "conditionalOptions">;
|
|
32
43
|
export type UnavailableSelectOption = {
|
|
@@ -36,6 +47,7 @@ export type UnavailableSelectOption = {
|
|
|
36
47
|
};
|
|
37
48
|
/** Options of a select field that are offered for the given row values, in declaration order. */
|
|
38
49
|
export declare function availableSelectOptions(field: SelectOptionRules, values: Record<string, unknown>): readonly string[];
|
|
50
|
+
export declare function stableJson(value: unknown): string;
|
|
39
51
|
export declare function isUnchangedValue(a: unknown, b: unknown): boolean;
|
|
40
52
|
/** Select values that violate a `conditionalOptions` rule. With `previous`, a field is only
|
|
41
53
|
* checked when it or one of its condition fields changed, so legacy rows stay editable. */
|
|
@@ -113,6 +113,14 @@ export function evalFieldCondition(cond, values) {
|
|
|
113
113
|
return !cond.notIn.includes(val);
|
|
114
114
|
return val !== cond.ne;
|
|
115
115
|
}
|
|
116
|
+
/** Picks the first emptyState variant whose `when` matches the record, else the base emptyState.
|
|
117
|
+
* Shared by the renderer and the specs' tests so they cannot diverge. */
|
|
118
|
+
export function pickEmptyStateText(emptyState, record) {
|
|
119
|
+
if (emptyState === undefined)
|
|
120
|
+
return undefined;
|
|
121
|
+
return (emptyState.variants?.find((variant) => evalFieldCondition(variant.when, { ...record })) ??
|
|
122
|
+
emptyState);
|
|
123
|
+
}
|
|
116
124
|
// A row that lacks the condition's field counts as locked: an unreadable lock state
|
|
117
125
|
// must not open the record.
|
|
118
126
|
export function isRecordLocked(lockedWhen, row) {
|
|
@@ -129,8 +137,16 @@ export function availableSelectOptions(field, values) {
|
|
|
129
137
|
return field.options;
|
|
130
138
|
return field.options.filter((option) => rules.every((rule) => !rule.options.includes(option) || evalFieldCondition(rule.when, values)));
|
|
131
139
|
}
|
|
140
|
+
// Key-order-stable: stored jsonb and schema-parsed rows order object keys differently.
|
|
141
|
+
export function stableJson(value) {
|
|
142
|
+
return JSON.stringify(value, (_key, nested) => {
|
|
143
|
+
if (!nested || typeof nested !== "object" || Array.isArray(nested))
|
|
144
|
+
return nested;
|
|
145
|
+
return Object.fromEntries(Object.entries(nested).sort(([a], [b]) => a.localeCompare(b)));
|
|
146
|
+
});
|
|
147
|
+
}
|
|
132
148
|
export function isUnchangedValue(a, b) {
|
|
133
|
-
return
|
|
149
|
+
return stableJson(a) === stableJson(b);
|
|
134
150
|
}
|
|
135
151
|
/** Select values that violate a `conditionalOptions` rule. With `previous`, a field is only
|
|
136
152
|
* checked when it or one of its condition fields changed, so legacy rows stay editable. */
|
|
@@ -67,11 +67,7 @@ export const softDeleteCleanupJob = async (_payload, ctx) => {
|
|
|
67
67
|
// explicitly tenant-filtered below as defense-in-depth — otherwise a
|
|
68
68
|
// tenant with a short grace would purge another tenant's still-within-grace
|
|
69
69
|
// rows.
|
|
70
|
-
const tenantId = ctx.systemUser
|
|
71
|
-
if (tenantId === undefined) {
|
|
72
|
-
// skip: cron fired without a perTenant fan-out tenant — nothing scoped to purge
|
|
73
|
-
return;
|
|
74
|
-
}
|
|
70
|
+
const tenantId = ctx.systemUser.tenantId;
|
|
75
71
|
const graceDays = await resolveGraceDays(ctx, tenantId, db);
|
|
76
72
|
const cutoff = ctx.tz.now().subtract({ hours: graceDays * 24 });
|
|
77
73
|
for (const proj of registry.getAllProjections().values()) {
|
|
@@ -171,6 +167,7 @@ export function buildSoftDeleteCleanupJob() {
|
|
|
171
167
|
includeSystemTenant: true,
|
|
172
168
|
concurrency: "skip",
|
|
173
169
|
runIn: "worker",
|
|
170
|
+
irreversibleWithoutEntryHandler: "high-risk-or-cron-pipeline",
|
|
174
171
|
};
|
|
175
172
|
}
|
|
176
173
|
export function buildSoftDeleteCleanupSystemJob() {
|
|
@@ -180,6 +177,7 @@ export function buildSoftDeleteCleanupSystemJob() {
|
|
|
180
177
|
trigger: { maintenance: true },
|
|
181
178
|
concurrency: "skip",
|
|
182
179
|
runIn: "worker",
|
|
180
|
+
irreversibleWithoutEntryHandler: "high-risk-or-cron-pipeline",
|
|
183
181
|
escapeHatch: {
|
|
184
182
|
reason: "hard-deletes expired soft-deleted rows of global entities (e.g. user) once, system-wide",
|
|
185
183
|
grants: ["unsafeRaw"],
|
|
@@ -39,7 +39,6 @@ export function defineTransitions(map) {
|
|
|
39
39
|
* form. Both are supported; the graph method is the idiomatic API for new
|
|
40
40
|
* code.
|
|
41
41
|
*/
|
|
42
|
-
// @wrapper-known semantic-alias
|
|
43
42
|
export function guardTransition(transitions, from, to) {
|
|
44
43
|
transitions.assertTransition(from, to);
|
|
45
44
|
}
|
|
@@ -0,0 +1,6 @@
|
|
|
1
|
+
import { legacyDateToInstant } from "../../time/legacy-date.js";
|
|
2
|
+
// The resume scan compares wakeAt against Postgres now(); deriving it from the app clock would
|
|
3
|
+
// fire timers early or late by the host's clock skew.
|
|
4
|
+
export async function databaseNowIso(ctx) {
|
|
5
|
+
return legacyDateToInstant(await ctx.db.databaseNow()).toString();
|
|
6
|
+
}
|