@cosmicdrift/kumiko-framework 0.413.0 → 0.414.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/AGENTS.md +5 -2
- package/agents/api/framework-db.md +14 -3
- package/agents/api/framework-engine.md +64 -13
- package/agents/api/framework-event-store.md +14 -0
- package/agents/api/framework-ui-types.md +149 -21
- package/agents/api/renderer-web.md +93 -9
- package/agents/api/testing-helpers.md +3 -2
- package/agents/api/testing-stack.md +3 -0
- package/agents/api/types.md +205 -14
- package/agents/api.md +7 -7
- package/agents/boot-rules.md +63 -9
- package/agents/examples/api-docs.md +2 -6
- package/agents/examples/auth-mfa.md +57 -10
- package/agents/examples/chat-channels.md +2 -0
- package/agents/examples/currencies-global.md +1 -0
- package/agents/examples/env-composition.md +7 -11
- package/agents/examples/helpdesk.md +15 -8
- package/agents/examples/managed-pages.md +90 -1
- package/agents/examples/pwa-shell.md +210 -0
- package/agents/examples/rate-limiting.md +3 -3
- package/agents/examples/record-detail-layout.md +1537 -67
- package/agents/examples/workflow-engine.md +16 -12
- package/agents/examples.md +1 -0
- package/agents/features-index.md +4 -2
- package/agents/features.md +22 -7
- package/agents/widgets.md +19 -1
- package/dist/api/api-constants.d.ts +1 -0
- package/dist/api/api-constants.js +4 -0
- package/dist/api/auth-middleware.js +4 -3
- package/dist/api/auth-routes-shared.js +2 -1
- package/dist/api/entity-read-access.d.ts +1 -0
- package/dist/api/entity-read-access.js +18 -0
- package/dist/api/export/export-route.d.ts +6 -1
- package/dist/api/export/export-route.js +27 -1
- package/dist/api/export/export-rows.js +19 -3
- package/dist/api/routes.d.ts +2 -0
- package/dist/api/routes.js +9 -1
- package/dist/api/server-extra-routes.js +2 -1
- package/dist/api/server-feature-http-routes.d.ts +9 -0
- package/dist/api/server-feature-http-routes.js +109 -0
- package/dist/api/server-middleware.js +2 -19
- package/dist/api/server-pat-rate-limit-guard.d.ts +3 -0
- package/dist/api/server-pat-rate-limit-guard.js +19 -0
- package/dist/api/server-rate-limit-wiring.d.ts +10 -0
- package/dist/api/server-rate-limit-wiring.js +37 -0
- package/dist/api/server-routes.d.ts +4 -12
- package/dist/api/server-routes.js +12 -171
- package/dist/api/server-schema-route.d.ts +3 -0
- package/dist/api/server-schema-route.js +58 -0
- package/dist/api/server-wiring.js +2 -37
- package/dist/api/server.js +3 -1
- package/dist/compliance/override-schema.js +5 -5
- package/dist/compliance/sub-processors.js +10 -1
- package/dist/crypto/index.d.ts +1 -1
- package/dist/crypto/index.js +1 -1
- package/dist/crypto/pii-field-encryption.d.ts +2 -0
- package/dist/crypto/pii-field-encryption.js +16 -1
- package/dist/db/apply-entity-event.js +4 -0
- package/dist/db/bun-sql-connection-codes.d.ts +1 -0
- package/dist/db/bun-sql-connection-codes.js +7 -0
- package/dist/db/collect-table-metas.js +4 -1
- package/dist/db/config-seed.js +1 -1
- package/dist/db/derived-field-sql.js +15 -13
- package/dist/db/derived-related-sql.d.ts +2 -2
- package/dist/db/derived-related-sql.js +4 -2
- package/dist/db/dialect.d.ts +3 -0
- package/dist/db/dialect.js +1 -3
- package/dist/db/driver-row-coercion.js +2 -2
- package/dist/db/driver-value-preparation.js +1 -1
- package/dist/db/eagerload.js +15 -12
- package/dist/db/entity-table-meta.d.ts +2 -0
- package/dist/db/entity-table-meta.js +7 -0
- package/dist/db/event-store-executor-context.js +13 -8
- package/dist/db/event-store-executor-read-aggregate-currencies.js +2 -2
- package/dist/db/event-store-executor-read-aggregate.js +2 -2
- package/dist/db/event-store-executor-read-filter.d.ts +4 -0
- package/dist/db/event-store-executor-read-filter.js +28 -11
- package/dist/db/event-store-executor-read-search.d.ts +1 -0
- package/dist/db/event-store-executor-read-search.js +6 -6
- package/dist/db/event-store-executor-read-sort.js +3 -3
- package/dist/db/event-store-executor-read-where.js +14 -5
- package/dist/db/event-store-executor-read.js +7 -7
- package/dist/db/event-store-executor-write.js +50 -95
- package/dist/db/executor-managed-tables.js +4 -1
- package/dist/db/index.d.ts +4 -2
- package/dist/db/index.js +4 -2
- package/dist/db/known-table-names.d.ts +1 -0
- package/dist/db/known-table-names.js +7 -5
- package/dist/db/list-aggregate-labels.d.ts +1 -0
- package/dist/db/list-aggregate-labels.js +9 -1
- package/dist/db/migrate-generator.js +23 -4
- package/dist/db/migrate-rls-diff.d.ts +1 -0
- package/dist/db/migrate-rls-diff.js +15 -1
- package/dist/db/migrate-runner.js +2 -2
- package/dist/db/money.d.ts +1 -1
- package/dist/db/money.js +1 -4
- package/dist/db/parent-ref-clause.d.ts +6 -2
- package/dist/db/parent-ref-clause.js +76 -23
- package/dist/db/parent-ref-global-hosts.d.ts +20 -0
- package/dist/db/parent-ref-global-hosts.js +47 -0
- package/dist/db/production-schema-command-hint.d.ts +1 -0
- package/dist/db/production-schema-command-hint.js +3 -0
- package/dist/db/queries/backfill-pii.js +55 -29
- package/dist/db/queries/ddl.js +13 -2
- package/dist/db/queries/event-store-open-streams.d.ts +15 -0
- package/dist/db/queries/event-store-open-streams.js +33 -0
- package/dist/db/queries/event-store-payload-scrub.d.ts +5 -0
- package/dist/db/queries/event-store-payload-scrub.js +11 -0
- package/dist/db/queries/event-store.js +0 -1
- package/dist/db/queries/raw-sql.js +0 -1
- package/dist/db/queries/rebuild-rls-guard.d.ts +2 -1
- package/dist/db/queries/rebuild-rls-guard.js +24 -11
- package/dist/db/queries/rls-boot-catalog.d.ts +1 -0
- package/dist/db/queries/rls-boot-catalog.js +13 -8
- package/dist/db/queries/rls-shape.d.ts +2 -1
- package/dist/db/queries/rls-shape.js +10 -0
- package/dist/db/queries/session-advisory-lock.js +2 -1
- package/dist/db/queries/test-stack.js +7 -7
- package/dist/db/query.js +16 -11
- package/dist/db/rebuild-marker.js +11 -2
- package/dist/db/render-rls-ddl.d.ts +2 -0
- package/dist/db/render-rls-ddl.js +16 -11
- package/dist/db/replay-migration-sql.js +1 -1
- package/dist/db/row-level-security-boot-check.js +18 -5
- package/dist/db/row-level-security-connection.js +25 -12
- package/dist/db/row-level-security-scope.d.ts +2 -1
- package/dist/db/row-level-security-scope.js +9 -5
- package/dist/db/sql-identifier.d.ts +1 -0
- package/dist/db/sql-identifier.js +3 -0
- package/dist/db/system-tenant-read-db.d.ts +5 -0
- package/dist/db/system-tenant-read-db.js +28 -0
- package/dist/db/table-builder.d.ts +3 -1
- package/dist/db/table-builder.js +18 -8
- package/dist/db/table-info.d.ts +1 -2
- package/dist/db/table-introspection.d.ts +3 -0
- package/dist/db/table-introspection.js +6 -0
- package/dist/db/table-push.d.ts +1 -0
- package/dist/db/table-push.js +7 -1
- package/dist/db/tenant-db-runner.d.ts +3 -0
- package/dist/db/tenant-db-runner.js +19 -1
- package/dist/db/transaction-serialization.d.ts +1 -0
- package/dist/db/transaction-serialization.js +20 -3
- package/dist/db/where-clause.js +11 -2
- package/dist/db/write-ownership-failures.d.ts +25 -0
- package/dist/db/write-ownership-failures.js +82 -0
- package/dist/engine/boot-validator/boot-check.js +7 -1
- package/dist/engine/boot-validator/boot-phases-app.js +5 -5
- package/dist/engine/boot-validator/boot-phases.js +3 -2
- package/dist/engine/boot-validator/boot-rules.d.ts +293 -26
- package/dist/engine/boot-validator/boot-rules.js +4 -0
- package/dist/engine/boot-validator/bundled-lists-table.js +2 -2
- package/dist/engine/boot-validator/card-meta-overflow.js +1 -0
- package/dist/engine/boot-validator/config-deps.d.ts +0 -1
- package/dist/engine/boot-validator/config-deps.js +0 -28
- package/dist/engine/boot-validator/config-key-rules.d.ts +0 -15
- package/dist/engine/boot-validator/config-key-rules.js +0 -15
- package/dist/engine/boot-validator/dashboard-screen-target.d.ts +22 -0
- package/dist/engine/boot-validator/dashboard-screen-target.js +20 -0
- package/dist/engine/boot-validator/dashboard-stat-navigate.d.ts +1 -0
- package/dist/engine/boot-validator/dashboard-stat-navigate.js +25 -17
- package/dist/engine/boot-validator/definition-webhook-events-rules.d.ts +5 -0
- package/dist/engine/boot-validator/definition-webhook-events-rules.js +5 -0
- package/dist/engine/boot-validator/derived-sql-fields.js +1 -2
- package/dist/engine/boot-validator/entity-declaration-rules.d.ts +5 -0
- package/dist/engine/boot-validator/entity-declaration-rules.js +5 -0
- package/dist/engine/boot-validator/entity-list-screens.d.ts +1 -0
- package/dist/engine/boot-validator/entity-list-screens.js +33 -6
- package/dist/engine/boot-validator/entity-structure-rules.d.ts +5 -0
- package/dist/engine/boot-validator/entity-structure-rules.js +5 -0
- package/dist/engine/boot-validator/list-column-layout.js +10 -6
- package/dist/engine/boot-validator/list-row-guidance-rules.d.ts +67 -0
- package/dist/engine/boot-validator/list-row-guidance-rules.js +67 -0
- package/dist/engine/boot-validator/list-row-guidance.d.ts +20 -0
- package/dist/engine/boot-validator/list-row-guidance.js +129 -0
- package/dist/engine/boot-validator/list-sort-summary-rules.d.ts +42 -0
- package/dist/engine/boot-validator/list-sort-summary-rules.js +42 -0
- package/dist/engine/boot-validator/list-sort-summary.d.ts +5 -0
- package/dist/engine/boot-validator/list-sort-summary.js +149 -0
- package/dist/engine/boot-validator/list-table-options.js +15 -1
- package/dist/engine/boot-validator/list-table-rules.d.ts +10 -5
- package/dist/engine/boot-validator/list-table-rules.js +10 -5
- package/dist/engine/boot-validator/list-toolbar-options.d.ts +10 -0
- package/dist/engine/boot-validator/list-toolbar-options.js +31 -0
- package/dist/engine/boot-validator/named-filter-rules.d.ts +32 -2
- package/dist/engine/boot-validator/named-filter-rules.js +32 -2
- package/dist/engine/boot-validator/ownership.js +10 -1
- package/dist/engine/boot-validator/parent-ref.js +87 -50
- package/dist/engine/boot-validator/projection-list-screens.d.ts +1 -0
- package/dist/engine/boot-validator/projection-list-screens.js +31 -1
- package/dist/engine/boot-validator/query-output-columns.js +62 -9
- package/dist/engine/boot-validator/query-output-guidance.d.ts +7 -0
- package/dist/engine/boot-validator/query-output-guidance.js +39 -0
- package/dist/engine/boot-validator/query-refs.js +24 -1
- package/dist/engine/boot-validator/row-decoration.d.ts +11 -0
- package/dist/engine/boot-validator/row-decoration.js +16 -0
- package/dist/engine/boot-validator/screens-dashboard-links.d.ts +10 -0
- package/dist/engine/boot-validator/screens-dashboard-links.js +36 -0
- package/dist/engine/boot-validator/screens-dashboard-narrow.d.ts +4 -0
- package/dist/engine/boot-validator/screens-dashboard-narrow.js +211 -0
- package/dist/engine/boot-validator/screens-dashboard-rules.d.ts +84 -4
- package/dist/engine/boot-validator/screens-dashboard-rules.js +84 -4
- package/dist/engine/boot-validator/screens-dashboard.js +29 -7
- package/dist/engine/boot-validator/screens-kind-entity-list.js +32 -27
- package/dist/engine/boot-validator/screens-kind-projection-detail-guidance.d.ts +3 -0
- package/dist/engine/boot-validator/screens-kind-projection-detail-guidance.js +46 -0
- package/dist/engine/boot-validator/screens-kind-projection-detail-rules.d.ts +20 -0
- package/dist/engine/boot-validator/screens-kind-projection-detail-rules.js +20 -0
- package/dist/engine/boot-validator/screens-kind-projection-detail.js +2 -0
- package/dist/engine/boot-validator/screens-kind-projection-list.js +4 -0
- package/dist/engine/boot-validator/screens-kind-rules.d.ts +25 -0
- package/dist/engine/boot-validator/screens-kind-rules.js +25 -0
- package/dist/engine/boot-validator/screens-lists.d.ts +8 -2
- package/dist/engine/boot-validator/screens-lists.js +19 -3
- package/dist/engine/boot-validator/screens.js +1 -1
- package/dist/engine/boot-validator/sort-nulls.d.ts +2 -0
- package/dist/engine/boot-validator/sort-nulls.js +15 -0
- package/dist/engine/boot-validator/zod-shape.d.ts +2 -1
- package/dist/engine/boot-validator/zod-shape.js +19 -1
- package/dist/engine/build-app-schema.js +4 -0
- package/dist/engine/config-helpers.d.ts +1 -2
- package/dist/engine/config-helpers.js +6 -7
- package/dist/engine/define-feature.js +1 -0
- package/dist/engine/define-handler.d.ts +1 -0
- package/dist/engine/define-handler.js +4 -2
- package/dist/engine/definition-violations.js +2 -2
- package/dist/engine/entity-handlers.js +3 -8
- package/dist/engine/entity-list-runtime-options.js +9 -8
- package/dist/engine/factories.d.ts +2 -0
- package/dist/engine/feature-config-events-jobs.js +1 -0
- package/dist/engine/feature-entity-handlers.js +5 -2
- package/dist/engine/field-access.d.ts +1 -1
- package/dist/engine/field-access.js +7 -10
- package/dist/engine/find-entity.js +3 -3
- package/dist/engine/form-derivations.js +3 -3
- package/dist/engine/index.d.ts +3 -3
- package/dist/engine/index.js +2 -2
- package/dist/engine/named-filter-roles.d.ts +3 -0
- package/dist/engine/named-filter-roles.js +23 -0
- package/dist/engine/pipeline.js +0 -1
- package/dist/engine/project-app-schema-for-roles.js +17 -2
- package/dist/engine/qualified-name.js +0 -1
- package/dist/engine/registry-facade.js +1 -2
- package/dist/engine/registry-state.d.ts +1 -1
- package/dist/engine/registry-state.js +5 -2
- package/dist/engine/registry-validate.d.ts +1 -0
- package/dist/engine/registry-validate.js +9 -1
- package/dist/engine/registry.js +2 -1
- package/dist/engine/resolve-named-list-filters.js +5 -2
- package/dist/engine/schema-builder.js +6 -10
- package/dist/engine/screen-helpers.d.ts +12 -0
- package/dist/engine/screen-helpers.js +17 -1
- package/dist/engine/soft-delete-cleanup.js +5 -8
- package/dist/engine/state-machine.js +0 -1
- package/dist/engine/steps/_database-clock.d.ts +2 -0
- package/dist/engine/steps/_database-clock.js +6 -0
- package/dist/engine/steps/compute.js +1 -1
- package/dist/engine/steps/retry.js +5 -1
- package/dist/engine/steps/return.js +0 -1
- package/dist/engine/steps/wait-for-event.js +2 -1
- package/dist/engine/steps/wait.js +2 -1
- package/dist/engine/system-user.d.ts +2 -2
- package/dist/engine/system-user.js +2 -2
- package/dist/engine/types/handlers.d.ts +1 -1
- package/dist/engine/types/handlers.js +1 -1
- package/dist/engine/types/screen.d.ts +1 -1
- package/dist/engine/types/screen.js +1 -1
- package/dist/engine/webhook-contracts.d.ts +2 -3
- package/dist/engine/webhook-contracts.js +2 -25
- package/dist/engine/webhook-events.js +48 -29
- package/dist/engine/webhook-payload-strictness.d.ts +7 -0
- package/dist/engine/webhook-payload-strictness.js +53 -0
- package/dist/env/_zod-introspect.d.ts +1 -0
- package/dist/env/dry-run.d.ts +1 -1
- package/dist/env/dry-run.js +1 -1
- package/dist/env/field-meta.d.ts +4 -0
- package/dist/env/field-meta.js +67 -0
- package/dist/env/field-rules.d.ts +9 -0
- package/dist/env/field-rules.js +46 -0
- package/dist/env/index.d.ts +3 -3
- package/dist/env/index.js +16 -71
- package/dist/env/internals.d.ts +3 -0
- package/dist/env/internals.js +1 -2
- package/dist/env/required-env.d.ts +3 -1
- package/dist/env/required-env.js +5 -2
- package/dist/errors/serialize.js +2 -2
- package/dist/errors/write-error-info.js +0 -2
- package/dist/es-ops/operations-schema.js +18 -7
- package/dist/event-store/admin-api.js +3 -3
- package/dist/event-store/event-store.js +0 -3
- package/dist/event-store/index.d.ts +1 -0
- package/dist/event-store/index.js +1 -0
- package/dist/event-store/transfer.js +1 -1
- package/dist/files/assert-file-refs-belong-to-tenant.d.ts +2 -1
- package/dist/files/assert-file-refs-belong-to-tenant.js +15 -13
- package/dist/files/bind-pending-file-refs.d.ts +3 -1
- package/dist/files/bind-pending-file-refs.js +54 -27
- package/dist/files/copy-pending-file-refs-to-tenant.js +7 -3
- package/dist/files/create-file-ref.d.ts +4 -1
- package/dist/files/create-file-ref.js +14 -3
- package/dist/files/default-file-guard.js +4 -1
- package/dist/files/feature.js +1 -0
- package/dist/files/file-claim.d.ts +6 -0
- package/dist/files/file-claim.js +17 -0
- package/dist/files/file-field-slots.d.ts +2 -0
- package/dist/files/file-field-slots.js +28 -0
- package/dist/files/file-ref-entity.d.ts +3 -0
- package/dist/files/file-ref-entity.js +2 -0
- package/dist/files/file-ref-table.d.ts +3 -0
- package/dist/files/file-routes.d.ts +4 -1
- package/dist/files/file-routes.js +80 -16
- package/dist/files/in-memory-provider.d.ts +1 -1
- package/dist/files/in-memory-provider.js +2 -1
- package/dist/files/index.d.ts +1 -1
- package/dist/files/index.js +1 -1
- package/dist/files/invalid-file-ref-error.d.ts +2 -0
- package/dist/files/invalid-file-ref-error.js +15 -0
- package/dist/files/local-provider.js +9 -2
- package/dist/files/provider-resolver.js +1 -1
- package/dist/files/rebind-file-ref.d.ts +3 -2
- package/dist/files/rebind-file-ref.js +24 -18
- package/dist/files/resolve-file-handles.d.ts +13 -0
- package/dist/files/resolve-file-handles.js +57 -0
- package/dist/files/storage-tracking.d.ts +1 -1
- package/dist/files/storage-tracking.js +5 -2
- package/dist/files/sweep-stale-pending-file-refs.js +10 -4
- package/dist/files/types.d.ts +4 -0
- package/dist/files/types.js +10 -0
- package/dist/files/upload-field-resolution.d.ts +1 -0
- package/dist/files/upload-field-resolution.js +16 -2
- package/dist/files/upload-ledger.js +1 -1
- package/dist/i18n/required-surface-guidance-keys.d.ts +3 -0
- package/dist/i18n/required-surface-guidance-keys.js +9 -0
- package/dist/i18n/required-surface-keys.js +19 -4
- package/dist/internal/boot-rule-table-expectations.d.ts +2 -0
- package/dist/internal/boot-rule-table-expectations.js +29 -0
- package/dist/internal/row-level-security.d.ts +1 -0
- package/dist/internal/row-level-security.js +1 -0
- package/dist/internal/testing.d.ts +1 -0
- package/dist/internal/testing.js +1 -0
- package/dist/jobs/index.d.ts +1 -0
- package/dist/jobs/index.js +1 -0
- package/dist/jobs/job-load-events.d.ts +10 -0
- package/dist/jobs/job-load-events.js +12 -0
- package/dist/jobs/job-runner-context.js +6 -158
- package/dist/jobs/job-runner-dispatch.d.ts +7 -0
- package/dist/jobs/job-runner-dispatch.js +57 -0
- package/dist/jobs/job-runner-event-triggers.js +18 -9
- package/dist/jobs/job-runner-execution.js +2 -2
- package/dist/jobs/job-runner-facets.d.ts +48 -0
- package/dist/jobs/job-runner-facets.js +156 -0
- package/dist/jobs/job-runner-gates.js +24 -12
- package/dist/jobs/job-runner-helpers.d.ts +5 -1
- package/dist/jobs/job-runner-helpers.js +18 -3
- package/dist/jobs/job-runner-scope.d.ts +1 -0
- package/dist/jobs/job-runner-scope.js +2 -0
- package/dist/jobs/job-runner-tenant-cap-lock.d.ts +2 -0
- package/dist/jobs/job-runner-tenant-cap-lock.js +30 -0
- package/dist/jobs/job-runner.js +31 -70
- package/dist/jobs/obliterate-job-queues.d.ts +6 -0
- package/dist/jobs/obliterate-job-queues.js +23 -0
- package/dist/lifecycle/lifecycle.js +1 -1
- package/dist/migrations/event-header-scrub.d.ts +11 -0
- package/dist/migrations/event-header-scrub.js +33 -0
- package/dist/migrations/event-payload-scrub.d.ts +1 -1
- package/dist/migrations/event-payload-scrub.js +36 -4
- package/dist/migrations/index.d.ts +1 -0
- package/dist/migrations/index.js +2 -0
- package/dist/migrations/kumiko-drift.d.ts +5 -2
- package/dist/migrations/kumiko-drift.js +51 -14
- package/dist/migrations/pending-rebuilds.js +4 -5
- package/dist/observability/sensitive-filter.js +0 -12
- package/dist/pipeline/aggregate-type-removal.js +17 -4
- package/dist/pipeline/context-services.d.ts +2 -0
- package/dist/pipeline/context-services.js +5 -2
- package/dist/pipeline/dispatch-batch.js +4 -3
- package/dist/pipeline/dispatch-context-helpers.d.ts +11 -0
- package/dist/pipeline/dispatch-context-helpers.js +58 -0
- package/dist/pipeline/dispatch-nested-write.d.ts +7 -0
- package/dist/pipeline/dispatch-nested-write.js +119 -0
- package/dist/pipeline/dispatch-query.js +10 -3
- package/dist/pipeline/dispatch-scope.js +4 -3
- package/dist/pipeline/dispatch-shared.d.ts +2 -6
- package/dist/pipeline/dispatch-shared.js +6 -38
- package/dist/pipeline/dispatch-write.d.ts +0 -1
- package/dist/pipeline/dispatch-write.js +3 -302
- package/dist/pipeline/dispatcher-utils.js +6 -0
- package/dist/pipeline/effective-system-scope.d.ts +3 -0
- package/dist/pipeline/effective-system-scope.js +22 -0
- package/dist/pipeline/event-dispatcher-delivery.d.ts +1 -0
- package/dist/pipeline/event-dispatcher-delivery.js +17 -9
- package/dist/pipeline/event-dispatcher.d.ts +4 -1
- package/dist/pipeline/event-dispatcher.js +6 -7
- package/dist/pipeline/handler-context-auth.d.ts +3 -2
- package/dist/pipeline/handler-context-auth.js +3 -4
- package/dist/pipeline/handler-context-db.js +11 -4
- package/dist/pipeline/handler-context-dispatch.js +2 -2
- package/dist/pipeline/handler-context-events.d.ts +8 -3
- package/dist/pipeline/handler-context-events.js +20 -65
- package/dist/pipeline/handler-context-member-resolution.js +16 -8
- package/dist/pipeline/handler-context-notify.d.ts +1 -0
- package/dist/pipeline/handler-context-notify.js +2 -0
- package/dist/pipeline/handler-context-phase-denials.js +3 -2
- package/dist/pipeline/handler-context-projection.d.ts +3 -0
- package/dist/pipeline/handler-context-projection.js +39 -0
- package/dist/pipeline/handler-context-scope.d.ts +1 -1
- package/dist/pipeline/handler-context-scope.js +14 -2
- package/dist/pipeline/index.d.ts +1 -1
- package/dist/pipeline/index.js +1 -1
- package/dist/pipeline/lifecycle-pipeline.d.ts +1 -0
- package/dist/pipeline/lifecycle-pipeline.js +7 -4
- package/dist/pipeline/member-reader.js +4 -2
- package/dist/pipeline/msp-rebuild.js +1 -1
- package/dist/pipeline/nested-write-parent-guard.d.ts +5 -0
- package/dist/pipeline/nested-write-parent-guard.js +81 -0
- package/dist/pipeline/projection-rebuild.d.ts +2 -0
- package/dist/pipeline/projection-rebuild.js +16 -7
- package/dist/pipeline/projection-state.js +4 -6
- package/dist/pipeline/system-hooks.js +36 -6
- package/dist/pipeline/write-result-masking.js +31 -3
- package/dist/pipeline/write-transition-guard.d.ts +7 -0
- package/dist/pipeline/write-transition-guard.js +95 -0
- package/dist/schema-cli/shared.d.ts +2 -0
- package/dist/schema-cli/shared.js +4 -2
- package/dist/schema-cli/validate-command.js +43 -28
- package/dist/search/meilisearch-adapter.js +14 -9
- package/dist/search/reindex-entity.d.ts +2 -0
- package/dist/search/reindex-entity.js +32 -4
- package/dist/search/reindex-tenants-search.js +20 -4
- package/dist/time/tz-context.js +1 -1
- package/dist/ui-types/card-column-roles.d.ts +4 -0
- package/dist/ui-types/card-column-roles.js +6 -3
- package/dist/ui-types/index.d.ts +2 -2
- package/dist/ui-types/index.js +1 -1
- package/dist/utils/ids.js +0 -1
- package/dist/utils/index.d.ts +1 -0
- package/dist/utils/index.js +1 -0
- package/dist/utils/return-path-limit.d.ts +1 -0
- package/dist/utils/return-path-limit.js +1 -0
- package/package.json +5 -3
- package/presets/biome-app.json +39 -21
- package/presets/biome-plugins/admin-api.grit +10 -0
- package/presets/biome-plugins/error-reasons.grit +53 -0
- package/presets/biome-plugins/es-literal-writes-tests.grit +18 -0
- package/presets/biome-plugins/es-literal-writes.grit +22 -0
- package/presets/biome-plugins/i18n-locale-terminology-de.grit +15 -0
- package/presets/biome-plugins/i18n-locale-terminology-romance.grit +10 -0
- package/presets/biome-plugins/no-create-test-dispatcher.grit +5 -0
- package/presets/biome-plugins/no-css-properties-type.grit +7 -0
- package/presets/biome-plugins/no-date-api.grit +9 -0
- package/presets/biome-plugins/no-direct-fetch.grit +16 -0
- package/presets/biome-plugins/no-direct-fs.grit +16 -0
- package/presets/biome-plugins/no-external-font-cdn-css.grit +9 -0
- package/presets/biome-plugins/no-external-font-cdn.grit +12 -0
- package/presets/biome-plugins/no-raw-hooks.grit +10 -0
- package/presets/biome-plugins/no-same-folder-barrel-import.grit +11 -0
- package/presets/biome-plugins/no-screen-container-classes.grit +7 -0
- package/presets/biome-plugins/no-skipped-or-retried-tests.grit +34 -0
- package/presets/biome-plugins/no-temporal-polyfill-require.grit +10 -0
- package/presets/biome-plugins/raw-html-in-web.grit +40 -0
- package/presets/biome-plugins/raw-ui-in-app.grit +142 -0
- package/presets/biome-plugins/restricted-event-store-symbols.grit +18 -0
- package/presets/biome-plugins/test-title.grit +20 -0
- package/presets/biome-plugins/unsafe-json-parse.grit +6 -0
- package/presets/biome-rules.json +465 -0
- package/src/changes.json +309 -0
- package/dist/engine/minor-units.d.ts +0 -2
- package/dist/engine/minor-units.js +0 -8
|
@@ -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,23 @@
|
|
|
1
|
+
// Only a plain role rule is serializable; openToAll, anySignedIn and no rule restrict nobody.
|
|
2
|
+
function rolesRestrictingNamedFilter(access) {
|
|
3
|
+
if (access === undefined || "openToAll" in access || access.anySignedIn === true) {
|
|
4
|
+
return undefined;
|
|
5
|
+
}
|
|
6
|
+
return access.roles;
|
|
7
|
+
}
|
|
8
|
+
// `roles` on a ref is framework-owned: an authored value is dropped so a screen cannot widen the
|
|
9
|
+
// entity's access rule on the client.
|
|
10
|
+
function refWithEntityRoles(ref, defs) {
|
|
11
|
+
const { roles: _authored, ...plain } = ref;
|
|
12
|
+
const def = Object.hasOwn(defs, ref.id) ? defs[ref.id] : undefined;
|
|
13
|
+
const roles = rolesRestrictingNamedFilter(def?.access);
|
|
14
|
+
return roles === undefined ? plain : { ...plain, roles };
|
|
15
|
+
}
|
|
16
|
+
export function projectNamedFilterRoles(screen, defs) {
|
|
17
|
+
if (screen.namedFilters === undefined)
|
|
18
|
+
return screen;
|
|
19
|
+
return {
|
|
20
|
+
...screen,
|
|
21
|
+
namedFilters: screen.namedFilters.map((ref) => refWithEntityRoles(ref, defs ?? {})),
|
|
22
|
+
};
|
|
23
|
+
}
|
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.
|
|
@@ -27,6 +27,7 @@ export declare function validateLifecycleHookTargets(state: RegistryState): void
|
|
|
27
27
|
export declare function validateEntityHookTargets(state: RegistryState, features: readonly FeatureDefinition[]): void;
|
|
28
28
|
export declare function resolveJobTriggers(state: RegistryState): void;
|
|
29
29
|
export declare function validateLiveEntities(state: RegistryState): void;
|
|
30
|
+
export declare function validateIncludeSystemTenantJobs(state: RegistryState): void;
|
|
30
31
|
export declare function validateBootGates(state: RegistryState): void;
|
|
31
32
|
export declare function validateJobBackoff(state: RegistryState): void;
|
|
32
33
|
export declare function validateMaxDefers(state: RegistryState): void;
|
|
@@ -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 — ` +
|
|
@@ -744,6 +745,13 @@ export function validateLiveEntities(state) {
|
|
|
744
745
|
}
|
|
745
746
|
}
|
|
746
747
|
}
|
|
748
|
+
export function validateIncludeSystemTenantJobs(state) {
|
|
749
|
+
for (const [jobName, jobDef] of state.jobMap) {
|
|
750
|
+
if (jobDef.includeSystemTenant && !jobDef.perTenant) {
|
|
751
|
+
throw new Error(`Job "${jobName}" sets includeSystemTenant without perTenant`);
|
|
752
|
+
}
|
|
753
|
+
}
|
|
754
|
+
}
|
|
747
755
|
export function validateBootGates(state) {
|
|
748
756
|
// Boot gates run inline in JobRunner.start(), which has neither the
|
|
749
757
|
// per-tenant fan-out (that re-enqueues) nor the sequential lock's
|
package/dist/engine/registry.js
CHANGED
|
@@ -4,7 +4,7 @@ import { buildRegistryFacade } from "./registry-facade.js";
|
|
|
4
4
|
import { populateClaimsAndAuth, populateConfigKeys, populateEvents, populateExtensionsAndSeeds, populateFeatureCore, populateHandlers, populateHooks, populateJobsAndNotifications, populateMetricsAndSecrets, populateProjectionsAndTables, populateScreensNavWorkspaces, populateSystemEvents, populateTranslations, } from "./registry-ingest.js";
|
|
5
5
|
import { populateReadModelEntities } from "./registry-read-models.js";
|
|
6
6
|
import { createInitialState } from "./registry-state.js";
|
|
7
|
-
import { applyExtensionUsages, autoWireSoftDeleteJobs, buildEntityEventUpcasterChains, buildEventUpcasterChains, buildImplicitProjections, buildIncomingRelations, buildSearchableSortableCaches, computeHasRateLimitedHandler, finalizeWorkspaceNavMembership, populateHandlerEntityMappings, publishEventPiiCatalog, resolveJobTriggers, resolveNotificationTriggersAndRegisterHooks, validateBootGates, validateEntityHookTargets, validateEventMigrationVersions, validateExtensionSelectors, validateExtensionUsageTargets, validateFieldAccessHandlersAreEntityMapped, validateJobBackoff, validateLifecycleHookTargets, validateLiveEntities, validateMaxDefers, validateMaxPerTenant, validateNotificationRecordMappings, validateNotificationRenamedFrom, validateProjectionApplyKeys, validateRelationTargetsExist, validateRequiredFeatures, } from "./registry-validate.js";
|
|
7
|
+
import { applyExtensionUsages, autoWireSoftDeleteJobs, buildEntityEventUpcasterChains, buildEventUpcasterChains, buildImplicitProjections, buildIncomingRelations, buildSearchableSortableCaches, computeHasRateLimitedHandler, finalizeWorkspaceNavMembership, populateHandlerEntityMappings, publishEventPiiCatalog, resolveJobTriggers, resolveNotificationTriggersAndRegisterHooks, validateBootGates, validateEntityHookTargets, validateEventMigrationVersions, validateExtensionSelectors, validateExtensionUsageTargets, validateFieldAccessHandlersAreEntityMapped, validateIncludeSystemTenantJobs, validateJobBackoff, validateLifecycleHookTargets, validateLiveEntities, validateMaxDefers, validateMaxPerTenant, validateNotificationRecordMappings, validateNotificationRenamedFrom, validateProjectionApplyKeys, validateRelationTargetsExist, validateRequiredFeatures, } from "./registry-validate.js";
|
|
8
8
|
// This is where the magic happens. By "magic" I mean: precomputed maps.
|
|
9
9
|
// I build everything once at boot (hooks, relations, searchable fields, ...)
|
|
10
10
|
// so nothing has to iterate over objects at runtime. O(1) instead of O(n*m).
|
|
@@ -49,6 +49,7 @@ export function createRegistry(rawFeatures) {
|
|
|
49
49
|
validateEntityHookTargets(state, features);
|
|
50
50
|
resolveJobTriggers(state);
|
|
51
51
|
validateBootGates(state);
|
|
52
|
+
validateIncludeSystemTenantJobs(state);
|
|
52
53
|
validateLiveEntities(state);
|
|
53
54
|
validateJobBackoff(state);
|
|
54
55
|
validateMaxDefers(state);
|
|
@@ -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);
|
|
@@ -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. */
|
|
@@ -62,18 +62,14 @@ export const softDeleteCleanupJob = async (_payload, ctx) => {
|
|
|
62
62
|
if (!db || !registry) {
|
|
63
63
|
throw new Error("soft-delete cleanup: ctx.db + ctx.registry required (JobContext incomplete)");
|
|
64
64
|
}
|
|
65
|
-
// perTenant fan-out → one run per active tenant, systemUser scoped to it.
|
|
65
|
+
// perTenant fan-out → one run per active tenant plus the system tenant, systemUser scoped to it.
|
|
66
66
|
// The job's db is a tenant-filtered TenantDb, but every delete is still
|
|
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
|
-
const cutoff =
|
|
72
|
+
const cutoff = ctx.tz.now().subtract({ hours: graceDays * 24 });
|
|
77
73
|
for (const proj of registry.getAllProjections().values()) {
|
|
78
74
|
if (proj.isImplicit !== true || typeof proj.source !== "string" || !proj.table)
|
|
79
75
|
continue;
|
|
@@ -143,7 +139,7 @@ export const softDeleteCleanupSystemJob = async (_payload, ctx) => {
|
|
|
143
139
|
if (!db || !registry) {
|
|
144
140
|
throw new Error("soft-delete system cleanup: ctx.db + ctx.registry required (JobContext incomplete)");
|
|
145
141
|
}
|
|
146
|
-
const cutoff =
|
|
142
|
+
const cutoff = ctx.tz.now().subtract({ hours: DEFAULT_GRACE_DAYS * 24 });
|
|
147
143
|
for (const proj of registry.getAllProjections().values()) {
|
|
148
144
|
if (proj.isImplicit !== true || typeof proj.source !== "string" || !proj.table)
|
|
149
145
|
continue;
|
|
@@ -168,6 +164,7 @@ export function buildSoftDeleteCleanupJob() {
|
|
|
168
164
|
handler: softDeleteCleanupJob,
|
|
169
165
|
trigger: { maintenance: true },
|
|
170
166
|
perTenant: true,
|
|
167
|
+
includeSystemTenant: true,
|
|
171
168
|
concurrency: "skip",
|
|
172
169
|
runIn: "worker",
|
|
173
170
|
};
|
|
@@ -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
|
+
}
|
|
@@ -19,7 +19,7 @@ defineStep({
|
|
|
19
19
|
kind: "compute",
|
|
20
20
|
defaultFailureStrategy: "throw",
|
|
21
21
|
resultKey: (args) => args.name,
|
|
22
|
-
run: (args, ctx) => args.fn(ctx),
|
|
22
|
+
run: (args, ctx) => args.fn(ctx),
|
|
23
23
|
});
|
|
24
24
|
export function buildComputeStep(name, fn) {
|
|
25
25
|
return {
|
|
@@ -6,9 +6,11 @@
|
|
|
6
6
|
// event and returns SUSPEND_SENTINEL to suspend. The Resume-Loop picks it up
|
|
7
7
|
// after the backoff duration and re-enters the step at the same index.
|
|
8
8
|
// After all attempts exhausted, the original error propagates.
|
|
9
|
+
import { Temporal } from "@cosmicdrift/kumiko-types/temporal";
|
|
9
10
|
import { createFallbackLogger } from "../../logging/index.js";
|
|
10
11
|
import { defineStep } from "../define-step.js";
|
|
11
12
|
import { runStepList } from "../run-pipeline.js";
|
|
13
|
+
import { databaseNowIso } from "./_database-clock.js";
|
|
12
14
|
import { SUSPEND_SENTINEL, WORKFLOW_AGGREGATE_TYPE, WORKFLOW_RETRY_SCHEDULED_TYPE, } from "./_step-dispatch-constants.js";
|
|
13
15
|
import { describeWorkflowStepError } from "./describe-workflow-step-error.js";
|
|
14
16
|
import { unwrapWorkflowStepError } from "./workflow-step-error.js";
|
|
@@ -42,7 +44,9 @@ defineStep({
|
|
|
42
44
|
error: String(unwrapWorkflowStepError(error)),
|
|
43
45
|
});
|
|
44
46
|
const backoffMs = calculateBackoff(attempt, args.backoff);
|
|
45
|
-
const wakeAt = Temporal.
|
|
47
|
+
const wakeAt = Temporal.Instant.from(await databaseNowIso(ctx))
|
|
48
|
+
.add({ milliseconds: backoffMs })
|
|
49
|
+
.toString();
|
|
46
50
|
await ctx.events.unsafeAppend({
|
|
47
51
|
aggregateId: ctx.workflow.runId,
|
|
48
52
|
aggregateType: WORKFLOW_AGGREGATE_TYPE,
|
|
@@ -21,6 +21,7 @@
|
|
|
21
21
|
// result), so a subsequent step only ever sees the matched event's payload
|
|
22
22
|
// after a resume seeds it in.
|
|
23
23
|
import { defineStep } from "../define-step.js";
|
|
24
|
+
import { databaseNowIso } from "./_database-clock.js";
|
|
24
25
|
import { addDuration } from "./_duration-utils.js";
|
|
25
26
|
import { resolveOptional, resolveRequired } from "./_resolver-utils.js";
|
|
26
27
|
import { SUSPEND_SENTINEL, WORKFLOW_AGGREGATE_TYPE, WORKFLOW_WAITING_FOR_EVENT_TYPE, } from "./_step-dispatch-constants.js";
|
|
@@ -36,7 +37,7 @@ defineStep({
|
|
|
36
37
|
}
|
|
37
38
|
const timeout = resolveRequired(args.timeout, ctx);
|
|
38
39
|
const resolvedMatch = resolveOptional(args.match, ctx);
|
|
39
|
-
const now =
|
|
40
|
+
const now = await databaseNowIso(ctx);
|
|
40
41
|
const timeoutAt = timeout.startsWith("P") || timeout.startsWith("PT") ? addDuration(now, timeout) : timeout;
|
|
41
42
|
await ctx.events.unsafeAppend({
|
|
42
43
|
aggregateId: ctx.workflow.runId,
|
|
@@ -9,6 +9,7 @@
|
|
|
9
9
|
// The `for` resolver accepts ISO-8601 duration strings ("PT1H", "P1D")
|
|
10
10
|
// or absolute ISO timestamps ("2026-05-16T12:00:00Z").
|
|
11
11
|
import { defineStep } from "../define-step.js";
|
|
12
|
+
import { databaseNowIso } from "./_database-clock.js";
|
|
12
13
|
import { addDuration } from "./_duration-utils.js";
|
|
13
14
|
import { resolveRequired } from "./_resolver-utils.js";
|
|
14
15
|
import { SUSPEND_SENTINEL, WORKFLOW_AGGREGATE_TYPE, WORKFLOW_WAITING_TYPE, } from "./_step-dispatch-constants.js";
|
|
@@ -22,7 +23,7 @@ defineStep({
|
|
|
22
23
|
"sync handlers cannot suspend (use r.step.webhook.send with mode: 'deferred' instead).");
|
|
23
24
|
}
|
|
24
25
|
const duration = resolveRequired(args.for, ctx);
|
|
25
|
-
const now =
|
|
26
|
+
const now = await databaseNowIso(ctx);
|
|
26
27
|
const wakeAt = duration.startsWith("P") || duration.startsWith("PT") ? addDuration(now, duration) : duration;
|
|
27
28
|
await ctx.events.unsafeAppend({
|
|
28
29
|
aggregateId: ctx.workflow.runId,
|
|
@@ -1,9 +1,9 @@
|
|
|
1
|
+
import { ANONYMOUS_ROLE } from "./types/handlers.ts";
|
|
1
2
|
import { SYSTEM_USER_ID, type TenantId } from "./types/identifiers.ts";
|
|
2
3
|
import type { SessionUser } from "./types/index.ts";
|
|
3
|
-
export { SYSTEM_USER_ID };
|
|
4
|
+
export { ANONYMOUS_ROLE, SYSTEM_USER_ID };
|
|
4
5
|
export declare const SYSTEM_ROLE: "system";
|
|
5
6
|
export declare function createSystemUser(tenantId: TenantId, extraRoles?: readonly string[]): SessionUser;
|
|
6
7
|
export declare const ANONYMOUS_USER_ID = "anonymous";
|
|
7
|
-
export declare const ANONYMOUS_ROLE: "anonymous";
|
|
8
8
|
export declare function isAnonymousSessionUser(user: Pick<SessionUser, "roles">): boolean;
|
|
9
9
|
export declare function createAnonymousUser(tenantId: TenantId): SessionUser;
|
|
@@ -1,5 +1,6 @@
|
|
|
1
|
+
import { ANONYMOUS_ROLE } from "./types/handlers.js";
|
|
1
2
|
import { SYSTEM_USER_ID } from "./types/identifiers.js";
|
|
2
|
-
export { SYSTEM_USER_ID };
|
|
3
|
+
export { ANONYMOUS_ROLE, SYSTEM_USER_ID };
|
|
3
4
|
export const SYSTEM_ROLE = "system";
|
|
4
5
|
// extraRoles: hasAccess has no system bypass — handlers gate on
|
|
5
6
|
// explicit roles. Callers that must reach handlers gated e.g. on
|
|
@@ -19,7 +20,6 @@ export function createSystemUser(tenantId, extraRoles = []) {
|
|
|
19
20
|
// like SYSTEM_ROLE: the boot-validator rejects apps that declare these as
|
|
20
21
|
// custom roles.
|
|
21
22
|
export const ANONYMOUS_USER_ID = "anonymous";
|
|
22
|
-
export const ANONYMOUS_ROLE = "anonymous";
|
|
23
23
|
export function isAnonymousSessionUser(user) {
|
|
24
24
|
return user.roles.includes(ANONYMOUS_ROLE);
|
|
25
25
|
}
|
|
@@ -1,2 +1,2 @@
|
|
|
1
1
|
export type * from "@cosmicdrift/kumiko-types/handlers";
|
|
2
|
-
export { isOpenToAllGranted, isUiAccessGranted } from "@cosmicdrift/kumiko-types/handlers";
|
|
2
|
+
export { ANONYMOUS_ROLE, isOpenToAllGranted, isUiAccessGranted, } from "@cosmicdrift/kumiko-types/handlers";
|
|
@@ -1 +1 @@
|
|
|
1
|
-
export { isOpenToAllGranted, isUiAccessGranted } from "@cosmicdrift/kumiko-types/handlers";
|
|
1
|
+
export { ANONYMOUS_ROLE, isOpenToAllGranted, isUiAccessGranted, } from "@cosmicdrift/kumiko-types/handlers";
|
|
@@ -1,2 +1,2 @@
|
|
|
1
1
|
export type * from "@cosmicdrift/kumiko-types/screen";
|
|
2
|
-
export { DEFAULT_EXPORT_MAX_ROWS, LIST_BULK_ACTION_KEYS, LIST_COLUMN_PINS, LIST_TABLE_DENSITIES, LIST_TABLE_DENSITY_KEYS, LIST_TABLE_EXPORT_KEYS, LIST_TABLE_GROUPING_KEYS, LIST_TABLE_OPTION_KEYS, LIST_TABLE_TOTAL_KEYS, MAX_BULK_SELECTION, MAX_EXPORT_MAX_ROWS, relatedListGroupHeaderLabel, relatedListGroupKey, } from "@cosmicdrift/kumiko-types/screen";
|
|
2
|
+
export { DEFAULT_EXPORT_MAX_ROWS, LIST_BULK_ACTION_KEYS, LIST_COLUMN_PINS, LIST_TABLE_DENSITIES, LIST_TABLE_DENSITY_KEYS, LIST_TABLE_EXPORT_KEYS, LIST_TABLE_FRAMES, LIST_TABLE_GROUPING_KEYS, LIST_TABLE_OPTION_KEYS, LIST_TABLE_SUMMARY_ROW_KEYS, LIST_TABLE_TOTAL_KEYS, MAX_BULK_SELECTION, MAX_EXPORT_MAX_ROWS, relatedListGroupHeaderLabel, relatedListGroupKey, } from "@cosmicdrift/kumiko-types/screen";
|
|
@@ -1 +1 @@
|
|
|
1
|
-
export { DEFAULT_EXPORT_MAX_ROWS, LIST_BULK_ACTION_KEYS, LIST_COLUMN_PINS, LIST_TABLE_DENSITIES, LIST_TABLE_DENSITY_KEYS, LIST_TABLE_EXPORT_KEYS, LIST_TABLE_GROUPING_KEYS, LIST_TABLE_OPTION_KEYS, LIST_TABLE_TOTAL_KEYS, MAX_BULK_SELECTION, MAX_EXPORT_MAX_ROWS, relatedListGroupHeaderLabel, relatedListGroupKey, } from "@cosmicdrift/kumiko-types/screen";
|
|
1
|
+
export { DEFAULT_EXPORT_MAX_ROWS, LIST_BULK_ACTION_KEYS, LIST_COLUMN_PINS, LIST_TABLE_DENSITIES, LIST_TABLE_DENSITY_KEYS, LIST_TABLE_EXPORT_KEYS, LIST_TABLE_FRAMES, LIST_TABLE_GROUPING_KEYS, LIST_TABLE_OPTION_KEYS, LIST_TABLE_SUMMARY_ROW_KEYS, LIST_TABLE_TOTAL_KEYS, MAX_BULK_SELECTION, MAX_EXPORT_MAX_ROWS, relatedListGroupHeaderLabel, relatedListGroupKey, } from "@cosmicdrift/kumiko-types/screen";
|
|
@@ -1,5 +1,6 @@
|
|
|
1
|
-
import type { WebhookEventContract } from "@cosmicdrift/kumiko-types/feature";
|
|
1
|
+
import type { WebhookEntityVerb, WebhookEventContract } from "@cosmicdrift/kumiko-types/feature";
|
|
2
2
|
import type { FeatureDefinition } from "./types/index.ts";
|
|
3
|
+
export declare const WEBHOOK_ENTITY_VERBS: readonly WebhookEntityVerb[];
|
|
3
4
|
export type WebhookContractResolver = {
|
|
4
5
|
/** Declared contract, or one derived from an entity lifecycle event (`entity.verb`). */
|
|
5
6
|
get(qualifiedName: string): WebhookEventContract | undefined;
|
|
@@ -8,5 +9,3 @@ export type WebhookContractResolver = {
|
|
|
8
9
|
};
|
|
9
10
|
/** Works on the feature list so a boot check, which has no registry, resolves the same contracts. */
|
|
10
11
|
export declare function createWebhookContractResolver(features: readonly FeatureDefinition[]): WebhookContractResolver;
|
|
11
|
-
/** Receivers tell events apart by wire name, so two contracts must never share one. */
|
|
12
|
-
export declare function assertUniqueWebhookWireNames(features: readonly FeatureDefinition[]): void;
|
|
@@ -2,7 +2,7 @@ import * as z from "zod";
|
|
|
2
2
|
import { DEFAULT_CURRENCIES } from "./field-helpers.js";
|
|
3
3
|
import { personalFieldNames } from "./personal-data-fields.js";
|
|
4
4
|
import { fieldToZod } from "./schema-builder.js";
|
|
5
|
-
const
|
|
5
|
+
export const WEBHOOK_ENTITY_VERBS = ["created", "updated", "deleted"];
|
|
6
6
|
const CONTRACT_VERSION = 1;
|
|
7
7
|
// money and locatedTimestamp are stored as several flat columns (amount plus currency, instant
|
|
8
8
|
// plus zone); the event shape of such a field is not mapped yet, so they stay out instead of
|
|
@@ -112,7 +112,7 @@ function entityVerbOf(qualifiedName) {
|
|
|
112
112
|
const dot = qualifiedName.lastIndexOf(".");
|
|
113
113
|
if (dot <= 0)
|
|
114
114
|
return undefined;
|
|
115
|
-
const verb =
|
|
115
|
+
const verb = WEBHOOK_ENTITY_VERBS.find((candidate) => candidate === qualifiedName.slice(dot + 1));
|
|
116
116
|
return verb === undefined ? undefined : { entity: qualifiedName.slice(0, dot), verb };
|
|
117
117
|
}
|
|
118
118
|
/** Works on the feature list so a boot check, which has no registry, resolves the same contracts. */
|
|
@@ -147,26 +147,3 @@ export function createWebhookContractResolver(features) {
|
|
|
147
147
|
},
|
|
148
148
|
};
|
|
149
149
|
}
|
|
150
|
-
/** Receivers tell events apart by wire name, so two contracts must never share one. */
|
|
151
|
-
export function assertUniqueWebhookWireNames(features) {
|
|
152
|
-
const qnByWireName = new Map();
|
|
153
|
-
const claim = (wireName, qn) => {
|
|
154
|
-
const existing = qnByWireName.get(wireName);
|
|
155
|
-
if (existing !== undefined && existing !== qn) {
|
|
156
|
-
throw new Error(`Webhook wire name "${wireName}" is used by both "${existing}" and "${qn}"; give one of them another wireName.`);
|
|
157
|
-
}
|
|
158
|
-
qnByWireName.set(wireName, qn);
|
|
159
|
-
};
|
|
160
|
-
for (const feature of features) {
|
|
161
|
-
for (const def of Object.values(feature.webhookEvents ?? {}))
|
|
162
|
-
claim(def.wireName, def.qn);
|
|
163
|
-
}
|
|
164
|
-
for (const feature of features) {
|
|
165
|
-
for (const [name, entity] of Object.entries(feature.entities ?? {})) {
|
|
166
|
-
if (entity.webhookEvents !== true)
|
|
167
|
-
continue;
|
|
168
|
-
for (const verb of ENTITY_VERBS)
|
|
169
|
-
claim(`${name}.${verb}`, `${name}.${verb}`);
|
|
170
|
-
}
|
|
171
|
-
}
|
|
172
|
-
}
|