@cosmicdrift/kumiko-framework 0.413.1 → 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 +63 -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/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.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 +1 -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/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 +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 +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.js +31 -70
- package/dist/jobs/obliterate-job-queues.d.ts +6 -0
- package/dist/jobs/obliterate-job-queues.js +23 -0
- package/dist/lifecycle/lifecycle.js +1 -1
- package/dist/migrations/event-header-scrub.d.ts +11 -0
- package/dist/migrations/event-header-scrub.js +33 -0
- package/dist/migrations/event-payload-scrub.d.ts +1 -1
- package/dist/migrations/event-payload-scrub.js +36 -4
- package/dist/migrations/index.d.ts +1 -0
- package/dist/migrations/index.js +2 -0
- package/dist/migrations/kumiko-drift.d.ts +5 -2
- package/dist/migrations/kumiko-drift.js +51 -14
- package/dist/migrations/pending-rebuilds.js +4 -5
- package/dist/observability/sensitive-filter.js +0 -12
- package/dist/pipeline/aggregate-type-removal.js +17 -4
- package/dist/pipeline/context-services.d.ts +2 -0
- package/dist/pipeline/context-services.js +5 -2
- package/dist/pipeline/dispatch-batch.js +4 -3
- package/dist/pipeline/dispatch-context-helpers.d.ts +11 -0
- package/dist/pipeline/dispatch-context-helpers.js +58 -0
- package/dist/pipeline/dispatch-nested-write.d.ts +7 -0
- package/dist/pipeline/dispatch-nested-write.js +119 -0
- package/dist/pipeline/dispatch-query.js +10 -3
- package/dist/pipeline/dispatch-scope.js +4 -3
- package/dist/pipeline/dispatch-shared.d.ts +2 -6
- package/dist/pipeline/dispatch-shared.js +6 -38
- package/dist/pipeline/dispatch-write.d.ts +0 -1
- package/dist/pipeline/dispatch-write.js +3 -302
- package/dist/pipeline/dispatcher-utils.js +6 -0
- package/dist/pipeline/effective-system-scope.d.ts +3 -0
- package/dist/pipeline/effective-system-scope.js +22 -0
- package/dist/pipeline/event-dispatcher-delivery.d.ts +1 -0
- package/dist/pipeline/event-dispatcher-delivery.js +17 -9
- package/dist/pipeline/event-dispatcher.d.ts +4 -1
- package/dist/pipeline/event-dispatcher.js +6 -7
- package/dist/pipeline/handler-context-auth.d.ts +3 -2
- package/dist/pipeline/handler-context-auth.js +3 -4
- package/dist/pipeline/handler-context-db.js +11 -4
- package/dist/pipeline/handler-context-dispatch.js +2 -2
- package/dist/pipeline/handler-context-events.d.ts +8 -3
- package/dist/pipeline/handler-context-events.js +20 -65
- package/dist/pipeline/handler-context-member-resolution.js +16 -8
- package/dist/pipeline/handler-context-notify.d.ts +1 -0
- package/dist/pipeline/handler-context-notify.js +2 -0
- package/dist/pipeline/handler-context-phase-denials.js +3 -2
- package/dist/pipeline/handler-context-projection.d.ts +3 -0
- package/dist/pipeline/handler-context-projection.js +39 -0
- package/dist/pipeline/handler-context-scope.d.ts +1 -1
- package/dist/pipeline/handler-context-scope.js +14 -2
- package/dist/pipeline/index.d.ts +1 -1
- package/dist/pipeline/index.js +1 -1
- package/dist/pipeline/lifecycle-pipeline.d.ts +1 -0
- package/dist/pipeline/lifecycle-pipeline.js +7 -4
- package/dist/pipeline/member-reader.js +4 -2
- package/dist/pipeline/msp-rebuild.js +1 -1
- package/dist/pipeline/nested-write-parent-guard.d.ts +5 -0
- package/dist/pipeline/nested-write-parent-guard.js +81 -0
- package/dist/pipeline/projection-rebuild.d.ts +2 -0
- package/dist/pipeline/projection-rebuild.js +16 -7
- package/dist/pipeline/projection-state.js +4 -6
- package/dist/pipeline/system-hooks.js +36 -6
- package/dist/pipeline/write-result-masking.js +31 -3
- package/dist/pipeline/write-transition-guard.d.ts +7 -0
- package/dist/pipeline/write-transition-guard.js +95 -0
- package/dist/schema-cli/shared.d.ts +2 -0
- package/dist/schema-cli/shared.js +4 -2
- package/dist/schema-cli/validate-command.js +43 -28
- package/dist/search/meilisearch-adapter.js +14 -9
- package/dist/search/reindex-entity.d.ts +2 -0
- package/dist/search/reindex-entity.js +32 -4
- package/dist/search/reindex-tenants-search.js +20 -4
- package/dist/time/tz-context.js +1 -1
- package/dist/ui-types/card-column-roles.d.ts +4 -0
- package/dist/ui-types/card-column-roles.js +6 -3
- package/dist/ui-types/index.d.ts +2 -2
- package/dist/ui-types/index.js +1 -1
- package/dist/utils/ids.js +0 -1
- package/dist/utils/index.d.ts +1 -0
- package/dist/utils/index.js +1 -0
- package/dist/utils/return-path-limit.d.ts +1 -0
- package/dist/utils/return-path-limit.js +1 -0
- package/package.json +5 -3
- package/presets/biome-app.json +39 -21
- package/presets/biome-plugins/admin-api.grit +10 -0
- package/presets/biome-plugins/error-reasons.grit +53 -0
- package/presets/biome-plugins/es-literal-writes-tests.grit +18 -0
- package/presets/biome-plugins/es-literal-writes.grit +22 -0
- package/presets/biome-plugins/i18n-locale-terminology-de.grit +15 -0
- package/presets/biome-plugins/i18n-locale-terminology-romance.grit +10 -0
- package/presets/biome-plugins/no-create-test-dispatcher.grit +5 -0
- package/presets/biome-plugins/no-css-properties-type.grit +7 -0
- package/presets/biome-plugins/no-date-api.grit +9 -0
- package/presets/biome-plugins/no-direct-fetch.grit +16 -0
- package/presets/biome-plugins/no-direct-fs.grit +16 -0
- package/presets/biome-plugins/no-external-font-cdn-css.grit +9 -0
- package/presets/biome-plugins/no-external-font-cdn.grit +12 -0
- package/presets/biome-plugins/no-raw-hooks.grit +10 -0
- package/presets/biome-plugins/no-same-folder-barrel-import.grit +11 -0
- package/presets/biome-plugins/no-screen-container-classes.grit +7 -0
- package/presets/biome-plugins/no-skipped-or-retried-tests.grit +34 -0
- package/presets/biome-plugins/no-temporal-polyfill-require.grit +10 -0
- package/presets/biome-plugins/raw-html-in-web.grit +40 -0
- package/presets/biome-plugins/raw-ui-in-app.grit +142 -0
- package/presets/biome-plugins/restricted-event-store-symbols.grit +18 -0
- package/presets/biome-plugins/test-title.grit +20 -0
- package/presets/biome-plugins/unsafe-json-parse.grit +6 -0
- package/presets/biome-rules.json +465 -0
- package/src/changes.json +309 -0
- package/dist/engine/minor-units.d.ts +0 -2
- package/dist/engine/minor-units.js +0 -8
package/dist/utils/index.d.ts
CHANGED
|
@@ -5,5 +5,6 @@ export { generateDeterministicId, generateId } from "./ids.ts";
|
|
|
5
5
|
export { isPlainObject } from "./is-plain-object.ts";
|
|
6
6
|
export { createLruCache, type LruCache, type LruCacheOptions } from "./lru-cache.ts";
|
|
7
7
|
export { parseStringArrayJson } from "./parse-string-array-json.ts";
|
|
8
|
+
export { MAX_RETURN_PATH_LENGTH } from "./return-path-limit.ts";
|
|
8
9
|
export { parseJsonOrThrow, parseJsonSafe } from "./safe-json.ts";
|
|
9
10
|
export { parseRoles } from "./serialization.ts";
|
package/dist/utils/index.js
CHANGED
|
@@ -5,5 +5,6 @@ export { generateDeterministicId, generateId } from "./ids.js";
|
|
|
5
5
|
export { isPlainObject } from "./is-plain-object.js";
|
|
6
6
|
export { createLruCache } from "./lru-cache.js";
|
|
7
7
|
export { parseStringArrayJson } from "./parse-string-array-json.js";
|
|
8
|
+
export { MAX_RETURN_PATH_LENGTH } from "./return-path-limit.js";
|
|
8
9
|
export { parseJsonOrThrow, parseJsonSafe } from "./safe-json.js";
|
|
9
10
|
export { parseRoles } from "./serialization.js";
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
export declare const MAX_RETURN_PATH_LENGTH = 2048;
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
export const MAX_RETURN_PATH_LENGTH = 2048;
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@cosmicdrift/kumiko-framework",
|
|
3
|
-
"version": "0.
|
|
3
|
+
"version": "0.414.0",
|
|
4
4
|
"description": "Framework core — engine, pipeline, API, DB, and every other bit that makes Kumiko go.",
|
|
5
5
|
"license": "MIT",
|
|
6
6
|
"author": "Marc Frost <marc@cosmicdriftgamestudio.com>",
|
|
@@ -39,6 +39,7 @@
|
|
|
39
39
|
"default": "./dist/config/index.js"
|
|
40
40
|
},
|
|
41
41
|
"./biome": "./presets/biome-app.json",
|
|
42
|
+
"./biome-rules": "./presets/biome-rules.json",
|
|
42
43
|
"./tsconfig.app.json": "./presets/tsconfig.app.json",
|
|
43
44
|
"./es-ops": {
|
|
44
45
|
"types": "./dist/es-ops/index.d.ts",
|
|
@@ -203,7 +204,7 @@
|
|
|
203
204
|
"./package.json": "./package.json"
|
|
204
205
|
},
|
|
205
206
|
"dependencies": {
|
|
206
|
-
"@cosmicdrift/kumiko-types": "0.
|
|
207
|
+
"@cosmicdrift/kumiko-types": "0.414.0",
|
|
207
208
|
"bullmq": "^5.81.5",
|
|
208
209
|
"hono": "^4.13.14",
|
|
209
210
|
"i18next": "^26.5.12",
|
|
@@ -225,7 +226,7 @@
|
|
|
225
226
|
}
|
|
226
227
|
},
|
|
227
228
|
"devDependencies": {
|
|
228
|
-
"@cosmicdrift/kumiko-testing": "0.
|
|
229
|
+
"@cosmicdrift/kumiko-testing": "0.414.0",
|
|
229
230
|
"bun-types": "^1.4.4",
|
|
230
231
|
"fflate": "^0.8.3",
|
|
231
232
|
"meilisearch": "^0.62.0",
|
|
@@ -244,6 +245,7 @@
|
|
|
244
245
|
"default": "./dist/config/index.js"
|
|
245
246
|
},
|
|
246
247
|
"./biome": "./presets/biome-app.json",
|
|
248
|
+
"./biome-rules": "./presets/biome-rules.json",
|
|
247
249
|
"./tsconfig.app.json": "./presets/tsconfig.app.json",
|
|
248
250
|
"./es-ops": {
|
|
249
251
|
"types": "./dist/es-ops/index.d.ts",
|
package/presets/biome-app.json
CHANGED
|
@@ -1,5 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"$schema": "https://biomejs.dev/schemas/2.6.4/schema.json",
|
|
3
|
+
"extends": ["./biome-rules.json"],
|
|
3
4
|
"vcs": {
|
|
4
5
|
"enabled": true,
|
|
5
6
|
"clientKind": "git",
|
|
@@ -31,7 +32,10 @@
|
|
|
31
32
|
"lineEnding": "lf"
|
|
32
33
|
},
|
|
33
34
|
"css": {
|
|
34
|
-
"parser": {
|
|
35
|
+
"parser": {
|
|
36
|
+
"cssModules": false,
|
|
37
|
+
"tailwindDirectives": true
|
|
38
|
+
}
|
|
35
39
|
},
|
|
36
40
|
"javascript": {
|
|
37
41
|
"formatter": {
|
|
@@ -42,23 +46,10 @@
|
|
|
42
46
|
"arrowParentheses": "always"
|
|
43
47
|
}
|
|
44
48
|
},
|
|
45
|
-
"json": {
|
|
46
|
-
|
|
47
|
-
|
|
48
|
-
|
|
49
|
-
"preset": "recommended",
|
|
50
|
-
"correctness": {
|
|
51
|
-
"noUnusedVariables": "error",
|
|
52
|
-
"noUnusedImports": "error"
|
|
53
|
-
},
|
|
54
|
-
"suspicious": {
|
|
55
|
-
"noExplicitAny": "error",
|
|
56
|
-
"noDebugger": "error",
|
|
57
|
-
"noConsole": "warn"
|
|
58
|
-
},
|
|
59
|
-
"complexity": { "useLiteralKeys": "off" },
|
|
60
|
-
"style": { "useConst": "error" },
|
|
61
|
-
"nursery": { "noFloatingPromises": "error" }
|
|
49
|
+
"json": {
|
|
50
|
+
"formatter": {
|
|
51
|
+
"indentWidth": 2,
|
|
52
|
+
"lineWidth": 80
|
|
62
53
|
}
|
|
63
54
|
},
|
|
64
55
|
"overrides": [
|
|
@@ -66,7 +57,9 @@
|
|
|
66
57
|
"includes": ["bin/**", "scripts/**", "**/bin/**", "**/scripts/**"],
|
|
67
58
|
"linter": {
|
|
68
59
|
"rules": {
|
|
69
|
-
"suspicious": {
|
|
60
|
+
"suspicious": {
|
|
61
|
+
"noConsole": "off"
|
|
62
|
+
}
|
|
70
63
|
}
|
|
71
64
|
}
|
|
72
65
|
},
|
|
@@ -79,8 +72,33 @@
|
|
|
79
72
|
],
|
|
80
73
|
"linter": {
|
|
81
74
|
"rules": {
|
|
82
|
-
"suspicious": {
|
|
83
|
-
|
|
75
|
+
"suspicious": {
|
|
76
|
+
"noConsole": "off"
|
|
77
|
+
},
|
|
78
|
+
"style": {
|
|
79
|
+
"noNonNullAssertion": "off"
|
|
80
|
+
}
|
|
81
|
+
}
|
|
82
|
+
}
|
|
83
|
+
},
|
|
84
|
+
{
|
|
85
|
+
"includes": [
|
|
86
|
+
"**/bin/**/*.ts",
|
|
87
|
+
"**/src/**/*.ts",
|
|
88
|
+
"!**/bin/env.ts",
|
|
89
|
+
"!**/bin/server.ts",
|
|
90
|
+
"!**/bin/kumiko.ts",
|
|
91
|
+
"!**/__tests__/**",
|
|
92
|
+
"!**/*.test.ts",
|
|
93
|
+
"!**/*.integration.ts",
|
|
94
|
+
"!**/*.d.ts",
|
|
95
|
+
"!**/node_modules/**"
|
|
96
|
+
],
|
|
97
|
+
"linter": {
|
|
98
|
+
"rules": {
|
|
99
|
+
"style": {
|
|
100
|
+
"noProcessEnv": "error"
|
|
101
|
+
}
|
|
84
102
|
}
|
|
85
103
|
}
|
|
86
104
|
}
|
|
@@ -0,0 +1,10 @@
|
|
|
1
|
+
language js
|
|
2
|
+
|
|
3
|
+
or {
|
|
4
|
+
`$target.appendRaw($...)`,
|
|
5
|
+
`$target.appendRawBatch($...)`,
|
|
6
|
+
`appendRaw($...)`,
|
|
7
|
+
`appendRawBatch($...)`
|
|
8
|
+
} as $call where {
|
|
9
|
+
register_diagnostic(span=$call, message="Admin API (appendRaw/appendRawBatch) bypasses the pipeline and is only allowed in samples/*/migration/, scripts/migrations/ and the event-store admin-api itself. For domain events use ctx.events.append or a write handler.", severity="error")
|
|
10
|
+
}
|
|
@@ -0,0 +1,53 @@
|
|
|
1
|
+
language js
|
|
2
|
+
|
|
3
|
+
or {
|
|
4
|
+
`$callee($reason, $...)` where {
|
|
5
|
+
$callee <: or {
|
|
6
|
+
`UnprocessableError`,
|
|
7
|
+
`failUnprocessable`,
|
|
8
|
+
`$_.failUnprocessable`
|
|
9
|
+
},
|
|
10
|
+
$reason <: or {
|
|
11
|
+
JsStringLiteralExpression(),
|
|
12
|
+
JsTemplateExpression()
|
|
13
|
+
},
|
|
14
|
+
$reason <: r"^[\"'`][^$]*[\"'`]$",
|
|
15
|
+
not $reason <: r"^[\"'`][a-z][a-z0-9_]*(?:\.[a-z][a-z0-9_]*)*[\"'`]$",
|
|
16
|
+
register_diagnostic(span=$reason, message="Error reason must be snake_case ASCII with optional dot namespaces (^[a-z][a-z0-9_]*(\\.[a-z][a-z0-9_]*)*$): clients key off it across wire, logs and i18n. Reusable? Add a const to FrameworkReasons/<Feature>Reasons.", severity="error")
|
|
17
|
+
},
|
|
18
|
+
`new UnprocessableError($reason, $...)` where {
|
|
19
|
+
$reason <: or {
|
|
20
|
+
JsStringLiteralExpression(),
|
|
21
|
+
JsTemplateExpression()
|
|
22
|
+
},
|
|
23
|
+
$reason <: r"^[\"'`][^$]*[\"'`]$",
|
|
24
|
+
not $reason <: r"^[\"'`][a-z][a-z0-9_]*(?:\.[a-z][a-z0-9_]*)*[\"'`]$",
|
|
25
|
+
register_diagnostic(span=$reason, message="Error reason must be snake_case ASCII with optional dot namespaces (^[a-z][a-z0-9_]*(\\.[a-z][a-z0-9_]*)*$): clients key off it across wire, logs and i18n. Reusable? Add a const to FrameworkReasons/<Feature>Reasons.", severity="error")
|
|
26
|
+
},
|
|
27
|
+
JsPropertyObjectMember(name=`reason`, value=$reason) as $member where {
|
|
28
|
+
$reason <: or {
|
|
29
|
+
JsStringLiteralExpression(),
|
|
30
|
+
JsTemplateExpression()
|
|
31
|
+
},
|
|
32
|
+
$reason <: r"^[\"'`][^$]*[\"'`]$",
|
|
33
|
+
not $reason <: r"^[\"'`][a-z][a-z0-9_]*(?:\.[a-z][a-z0-9_]*)*[\"'`]$",
|
|
34
|
+
not $member <: within JsPropertyObjectMember(name=or {
|
|
35
|
+
`openToAll`,
|
|
36
|
+
`escapeHatch`,
|
|
37
|
+
`unsafeAllTenants`,
|
|
38
|
+
`systemIdentity`,
|
|
39
|
+
`globalWrites`,
|
|
40
|
+
`unsafeRaw`,
|
|
41
|
+
`crossTenantReads`
|
|
42
|
+
}),
|
|
43
|
+
not $member <: within `$callee($...)` where {
|
|
44
|
+
$callee <: or {
|
|
45
|
+
`declareEscapeHatch`,
|
|
46
|
+
`withUnsafeRawGrant`,
|
|
47
|
+
`createTenantDb`,
|
|
48
|
+
`subjectForgetAfterDeleteHook`
|
|
49
|
+
}
|
|
50
|
+
},
|
|
51
|
+
register_diagnostic(span=$reason, message="Error reason must be snake_case ASCII with optional dot namespaces (^[a-z][a-z0-9_]*(\\.[a-z][a-z0-9_]*)*$): clients key off it across wire, logs and i18n. Reusable? Add a const to FrameworkReasons/<Feature>Reasons.", severity="error")
|
|
52
|
+
}
|
|
53
|
+
}
|
|
@@ -0,0 +1,18 @@
|
|
|
1
|
+
language js
|
|
2
|
+
|
|
3
|
+
or {
|
|
4
|
+
JsStringLiteralExpression(),
|
|
5
|
+
JsTemplateExpression()
|
|
6
|
+
} as $literal where {
|
|
7
|
+
$literal <: includes or {
|
|
8
|
+
"kumiko_events",
|
|
9
|
+
"read_tenant_memberships",
|
|
10
|
+
"KUMIKO_EVENTS",
|
|
11
|
+
"READ_TENANT_MEMBERSHIPS"
|
|
12
|
+
},
|
|
13
|
+
or {
|
|
14
|
+
$literal <: r"(?is).*(?:(?-u:\b)(?:INSERT[ \t\n\r]+INTO|UPDATE)[ \t\n\r]+.{0,2}kumiko_events(?-u:\b)).*",
|
|
15
|
+
$literal <: r"(?is).*(?:(?-u:\b)CREATE[ \t\n\r]+TABLE(?-u:\b)[^;]*?(?-u:\b)read_tenant_memberships(?-u:\b)).*"
|
|
16
|
+
},
|
|
17
|
+
register_diagnostic(span=$literal, message="Raw INSERT/UPDATE on kumiko_events or hand-written read_tenant_memberships DDL in a test. Seed events with append() (runSeedWritesAt for backdating) and membership rows with unsafeCreateEntityTable(db, tenantMembershipEntity) plus seedRow.", severity="error")
|
|
18
|
+
}
|
|
@@ -0,0 +1,22 @@
|
|
|
1
|
+
language js
|
|
2
|
+
|
|
3
|
+
or {
|
|
4
|
+
JsStringLiteralExpression(),
|
|
5
|
+
JsTemplateExpression()
|
|
6
|
+
} as $literal where {
|
|
7
|
+
$literal <: includes or {
|
|
8
|
+
"kumiko_events",
|
|
9
|
+
"kumiko_snapshots",
|
|
10
|
+
"kumiko_archived_streams",
|
|
11
|
+
"read_tenant_memberships",
|
|
12
|
+
"KUMIKO_EVENTS",
|
|
13
|
+
"KUMIKO_SNAPSHOTS",
|
|
14
|
+
"KUMIKO_ARCHIVED_STREAMS",
|
|
15
|
+
"READ_TENANT_MEMBERSHIPS"
|
|
16
|
+
},
|
|
17
|
+
or {
|
|
18
|
+
$literal <: r"(?is).*(?:(?-u:\b)(?:UPDATE|DELETE[ \t\n\r]+FROM|INSERT[ \t\n\r]+INTO)(?-u:\b).*?[\"'`]?(?:kumiko_events|kumiko_snapshots|kumiko_archived_streams)).*",
|
|
19
|
+
$literal <: r"(?is).*(?:(?-u:\b)CREATE[ \t\n\r]+TABLE(?-u:\b)[^;]*?(?-u:\b)read_tenant_memberships(?-u:\b)).*"
|
|
20
|
+
},
|
|
21
|
+
register_diagnostic(span=$literal, message="Raw SQL write on an event-store table (kumiko_events, kumiko_snapshots, kumiko_archived_streams) or hand-written read_tenant_memberships DDL. Only packages/framework/src/event-store/** may write these tables; use transferAggregateStreams for a tenant move or add an event-store primitive. In tests seed with append() (runSeedWritesAt for backdating) and unsafeCreateEntityTable(db, tenantMembershipEntity).", severity="error")
|
|
22
|
+
}
|
|
@@ -0,0 +1,15 @@
|
|
|
1
|
+
language js
|
|
2
|
+
|
|
3
|
+
JsPropertyObjectMember(value=$text) as $member where {
|
|
4
|
+
$text <: includes or {
|
|
5
|
+
"enant",
|
|
6
|
+
"ENANT",
|
|
7
|
+
"rganisation",
|
|
8
|
+
"RGANISATION"
|
|
9
|
+
},
|
|
10
|
+
$text <: or {
|
|
11
|
+
r"(?i)(?s).*(?:(?-u:\b)Tenants?(?-u:\b)).*",
|
|
12
|
+
r"(?i)(?s).*(?:(?-u:\b)organisation(?:en|s)?).*"
|
|
13
|
+
},
|
|
14
|
+
register_diagnostic(span=$member, message="German locale terminology: use Mandant instead of Tenant/Organisation (fw#2200). Role names like TenantAdmin are fine.", severity="error")
|
|
15
|
+
}
|
|
@@ -0,0 +1,10 @@
|
|
|
1
|
+
language js
|
|
2
|
+
|
|
3
|
+
JsPropertyObjectMember(value=$text) as $member where {
|
|
4
|
+
$text <: includes or {
|
|
5
|
+
"enant",
|
|
6
|
+
"ENANT"
|
|
7
|
+
},
|
|
8
|
+
$text <: r"(?i)(?s).*(?:(?-u:\b)tenants?(?-u:\b)).*",
|
|
9
|
+
register_diagnostic(span=$member, message="Locale terminology: use Organización (es), organisation (fr) or organizzazione (it) instead of the tenant loanword (fw#2200). Role names like TenantAdmin are fine.", severity="error")
|
|
10
|
+
}
|
|
@@ -0,0 +1,5 @@
|
|
|
1
|
+
language js
|
|
2
|
+
|
|
3
|
+
`createTestDispatcher($...)` as $call where {
|
|
4
|
+
register_diagnostic(span=$call, message="Integration tests run through the real stack: use setupTestStack from @cosmicdrift/kumiko-testing/stack and stack.http.writeOk/queryOk, never createTestDispatcher.", severity="error")
|
|
5
|
+
}
|
|
@@ -0,0 +1,7 @@
|
|
|
1
|
+
language js
|
|
2
|
+
|
|
3
|
+
TsReferenceType() as $reference where {
|
|
4
|
+
$reference <: includes "CSSProperties",
|
|
5
|
+
$reference <: r"^(?:React\.)?CSSProperties\b.*",
|
|
6
|
+
register_diagnostic(span=$reference, message="CSSProperties style objects bypass theme tokens and dark mode. Use widgets and theme tokens.", severity="error")
|
|
7
|
+
}
|
|
@@ -0,0 +1,9 @@
|
|
|
1
|
+
language js
|
|
2
|
+
|
|
3
|
+
or {
|
|
4
|
+
`new Date($...)` as $hit,
|
|
5
|
+
`$target.toISOString($...)` as $hit,
|
|
6
|
+
`$target.getTime($...)` as $hit
|
|
7
|
+
} where {
|
|
8
|
+
register_diagnostic(span=$hit, message="JS Date API in production code: use Temporal.Now.instant(), Temporal.Instant.from(...), .toString() or .epochMilliseconds (ctx.tz for wall-clock + IANA zone). Date.now() and Date.parse() stay allowed. See docs/plans/architecture/timezones.md.", severity="error")
|
|
9
|
+
}
|
|
@@ -0,0 +1,16 @@
|
|
|
1
|
+
language js
|
|
2
|
+
|
|
3
|
+
or {
|
|
4
|
+
`fetch($url, $...)`,
|
|
5
|
+
`globalThis.fetch($url, $...)`,
|
|
6
|
+
`window.fetch($url, $...)`
|
|
7
|
+
} as $call where {
|
|
8
|
+
not {
|
|
9
|
+
$url <: or {
|
|
10
|
+
JsStringLiteralExpression(),
|
|
11
|
+
JsTemplateExpression()
|
|
12
|
+
},
|
|
13
|
+
$url <: r"(?s)^[\"'`]/[^/$\\].*"
|
|
14
|
+
},
|
|
15
|
+
register_diagnostic(span=$call, message="Raw fetch() skips the SSRF policy in server code: use egress(policy)(...) from @cosmicdrift/kumiko-framework/http. In web screens use useQuery/useMutation or an API client (*.ts). A same-origin path literal (\"/api/...\") is allowed; any other exception needs a biome-ignore with a specific reason.", severity="error")
|
|
16
|
+
}
|
|
@@ -0,0 +1,16 @@
|
|
|
1
|
+
language js
|
|
2
|
+
|
|
3
|
+
or {
|
|
4
|
+
`import $_ from $source`,
|
|
5
|
+
`import $source`,
|
|
6
|
+
`export { $_ } from $source`,
|
|
7
|
+
`export { $_, $... } from $source`,
|
|
8
|
+
`export * as $_ from $source`,
|
|
9
|
+
`import $_ = require($source)`,
|
|
10
|
+
`export * from $source`,
|
|
11
|
+
`require($source)`,
|
|
12
|
+
`import($source)`
|
|
13
|
+
} as $hit where {
|
|
14
|
+
$source <: r"^[\"'`](?:node:)?fs(?:/promises)?[\"'`]$",
|
|
15
|
+
register_diagnostic(span=$hit, message="Direct fs import: request-derived paths passed straight to fs caused path-traversal bugs. Use FileStorageProvider (resolveContainedPath) or readBundledAsset; build/CLI/script tooling belongs under scripts/, bin/, tools/ or e2e/.", severity="error")
|
|
16
|
+
}
|
|
@@ -0,0 +1,9 @@
|
|
|
1
|
+
language css
|
|
2
|
+
|
|
3
|
+
CssString() as $literal where {
|
|
4
|
+
$literal <: includes or {
|
|
5
|
+
"fonts.googleapis.com",
|
|
6
|
+
"fonts.gstatic.com"
|
|
7
|
+
},
|
|
8
|
+
register_diagnostic(span=$literal, message="No external font CDNs (fonts.googleapis.com, fonts.gstatic.com): self-host fonts so no visitor data leaves for a third party.", severity="error")
|
|
9
|
+
}
|
|
@@ -0,0 +1,12 @@
|
|
|
1
|
+
language js
|
|
2
|
+
|
|
3
|
+
or {
|
|
4
|
+
JsStringLiteralExpression(),
|
|
5
|
+
JsTemplateExpression()
|
|
6
|
+
} as $literal where {
|
|
7
|
+
$literal <: includes or {
|
|
8
|
+
"fonts.googleapis.com",
|
|
9
|
+
"fonts.gstatic.com"
|
|
10
|
+
},
|
|
11
|
+
register_diagnostic(span=$literal, message="No external font CDNs (fonts.googleapis.com, fonts.gstatic.com): self-host fonts so no visitor data leaves for a third party.", severity="error")
|
|
12
|
+
}
|
|
@@ -0,0 +1,10 @@
|
|
|
1
|
+
language js
|
|
2
|
+
|
|
3
|
+
or {
|
|
4
|
+
`useEffect($...)`,
|
|
5
|
+
`useLayoutEffect($...)`,
|
|
6
|
+
`$namespace.useEffect($...)`,
|
|
7
|
+
`$namespace.useLayoutEffect($...)`
|
|
8
|
+
} as $hit where {
|
|
9
|
+
register_diagnostic(span=$hit, message="Raw useEffect/useLayoutEffect in web screens is the source of endless-rerender bugs and bypasses the framework hooks. Use useQuery (live: true for SSE), useMutation, useDisclosure or useReportStepComplete; a real DOM-integration case needs a biome-ignore with a reason.", severity="error")
|
|
10
|
+
}
|
|
@@ -0,0 +1,11 @@
|
|
|
1
|
+
language js
|
|
2
|
+
|
|
3
|
+
or {
|
|
4
|
+
`import $_ from "./index"`,
|
|
5
|
+
`import $_ from "./index.ts"`,
|
|
6
|
+
`import $_ from "."`,
|
|
7
|
+
`import $_ from "./"`
|
|
8
|
+
} as $import where {
|
|
9
|
+
not $import <: r"(?s)^import[ \t\n\r]+type[ \t\n\r].*",
|
|
10
|
+
register_diagnostic(span=$import, message="Import siblings directly (./Component), not through the folder's own barrel: barrel-importing from inside the same folder creates require cycles.", severity="error")
|
|
11
|
+
}
|
|
@@ -0,0 +1,7 @@
|
|
|
1
|
+
language js
|
|
2
|
+
|
|
3
|
+
JsxAttribute(name=`className`, initializer=$classes) where {
|
|
4
|
+
$classes <: includes "mx-auto",
|
|
5
|
+
$classes <: r"(?s).*(?:(?:^|[ \t\n\r\"'`:])mx-auto[ \t\n\r\"'`}](?:.*[ \t\n\r\"'`:])?max-w-|(?:^|[ \t\n\r\"'`:])max-w-.*[ \t\n\r\"'`:]mx-auto(?:$|[ \t\n\r\"'`}])).*",
|
|
6
|
+
register_diagnostic(span=$classes, message="Screen container classes (mx-auto + max-w-*) belong in <PageSection maxWidth> (3xl/4xl/full), not in screen code.", severity="error")
|
|
7
|
+
}
|
|
@@ -0,0 +1,34 @@
|
|
|
1
|
+
language js
|
|
2
|
+
|
|
3
|
+
or {
|
|
4
|
+
`$callee.skip($title, $...)` where {
|
|
5
|
+
$callee <: or {
|
|
6
|
+
`test`,
|
|
7
|
+
`it`,
|
|
8
|
+
`describe`
|
|
9
|
+
},
|
|
10
|
+
$title <: or {
|
|
11
|
+
JsStringLiteralExpression(),
|
|
12
|
+
JsTemplateExpression()
|
|
13
|
+
},
|
|
14
|
+
register_diagnostic(span=$callee, message="Unconditionally skipped test. Fix or delete it; an environment gate belongs in skipIf(condition) with the reason in the title.", severity="error")
|
|
15
|
+
},
|
|
16
|
+
`$callee($title, $fn, { $..., retry: $count, $... })` where {
|
|
17
|
+
$callee <: or {
|
|
18
|
+
`test`,
|
|
19
|
+
`it`,
|
|
20
|
+
`describe`
|
|
21
|
+
},
|
|
22
|
+
$count <: not `0`,
|
|
23
|
+
register_diagnostic(span=$count, message="A retry count hides a flaky test. Find the shared state or missing wait behind the flake instead.", severity="error")
|
|
24
|
+
},
|
|
25
|
+
`$callee($title, { $..., retry: $count, $... }, $fn)` where {
|
|
26
|
+
$callee <: or {
|
|
27
|
+
`test`,
|
|
28
|
+
`it`,
|
|
29
|
+
`describe`
|
|
30
|
+
},
|
|
31
|
+
$count <: not `0`,
|
|
32
|
+
register_diagnostic(span=$count, message="A retry count hides a flaky test. Find the shared state or missing wait behind the flake instead.", severity="error")
|
|
33
|
+
}
|
|
34
|
+
}
|
|
@@ -0,0 +1,10 @@
|
|
|
1
|
+
language js
|
|
2
|
+
|
|
3
|
+
or {
|
|
4
|
+
`require($source)`,
|
|
5
|
+
`import($source)`
|
|
6
|
+
} as $call where {
|
|
7
|
+
$source <: includes "temporal-polyfill",
|
|
8
|
+
$source <: r"^[\"'`]temporal-polyfill(?:/[^\"'`]*)?[\"'`]$",
|
|
9
|
+
register_diagnostic(span=$call, message="temporal-polyfill loaded by require()/import(): import { Temporal } from \"@cosmicdrift/kumiko-types/temporal\" instead — it prefers the native global, so framework and consumer share one set of Temporal classes.", severity="error")
|
|
10
|
+
}
|
|
@@ -0,0 +1,40 @@
|
|
|
1
|
+
language js
|
|
2
|
+
|
|
3
|
+
or {
|
|
4
|
+
JsxOpeningElement(name=$tag) as $element where {
|
|
5
|
+
$tag <: or {
|
|
6
|
+
`table`,
|
|
7
|
+
`thead`,
|
|
8
|
+
`tbody`,
|
|
9
|
+
`tr`,
|
|
10
|
+
`td`,
|
|
11
|
+
`th`,
|
|
12
|
+
`form`,
|
|
13
|
+
`button`,
|
|
14
|
+
`dialog`
|
|
15
|
+
},
|
|
16
|
+
register_diagnostic(span=$tag, message="Raw HTML element in web code: use the framework primitives (usePrimitives(): DataTable, Form, Button, DefaultDialog) instead of table/form/button/dialog.", severity="error")
|
|
17
|
+
},
|
|
18
|
+
JsxSelfClosingElement(name=$tag) as $element where {
|
|
19
|
+
$tag <: or {
|
|
20
|
+
`table`,
|
|
21
|
+
`thead`,
|
|
22
|
+
`tbody`,
|
|
23
|
+
`tr`,
|
|
24
|
+
`td`,
|
|
25
|
+
`th`,
|
|
26
|
+
`form`,
|
|
27
|
+
`button`,
|
|
28
|
+
`dialog`
|
|
29
|
+
},
|
|
30
|
+
register_diagnostic(span=$tag, message="Raw HTML element in web code: use the framework primitives (usePrimitives(): DataTable, Form, Button, DefaultDialog) instead of table/form/button/dialog.", severity="error")
|
|
31
|
+
},
|
|
32
|
+
JsxAttribute(name=`className`, initializer=$classes) where {
|
|
33
|
+
$classes <: includes "bg-card",
|
|
34
|
+
$classes <: r"(?s).*(?:(?:^|[ \t\n\r\"'`:])bg-card(?:$|[ \t\n\r\"'`}])).*",
|
|
35
|
+
register_diagnostic(span=$classes, message="bg-card in a className is a hand-rolled card: use <Card> from the framework primitives (slots/options).", severity="error")
|
|
36
|
+
},
|
|
37
|
+
`alert($...)` as $call where {
|
|
38
|
+
register_diagnostic(span=$call, message="alert() in web code: use <DefaultDialog> from @cosmicdrift/kumiko-renderer/web.", severity="error")
|
|
39
|
+
}
|
|
40
|
+
}
|
|
@@ -0,0 +1,142 @@
|
|
|
1
|
+
language js
|
|
2
|
+
|
|
3
|
+
or {
|
|
4
|
+
JsxOpeningElement(name=$tag) as $element where {
|
|
5
|
+
$tag <: or {
|
|
6
|
+
`input`,
|
|
7
|
+
`select`,
|
|
8
|
+
`textarea`,
|
|
9
|
+
`label`
|
|
10
|
+
},
|
|
11
|
+
register_diagnostic(span=$tag, message="Raw form element in app code: use the framework primitives (usePrimitives(): Input via Field, ComboboxInput) instead of input/select/textarea/label.", severity="error")
|
|
12
|
+
},
|
|
13
|
+
JsxSelfClosingElement(name=$tag) as $element where {
|
|
14
|
+
$tag <: or {
|
|
15
|
+
`input`,
|
|
16
|
+
`select`,
|
|
17
|
+
`textarea`,
|
|
18
|
+
`label`
|
|
19
|
+
},
|
|
20
|
+
register_diagnostic(span=$tag, message="Raw form element in app code: use the framework primitives (usePrimitives(): Input via Field, ComboboxInput) instead of input/select/textarea/label.", severity="error")
|
|
21
|
+
},
|
|
22
|
+
JsxOpeningElement(name=$tag) as $element where {
|
|
23
|
+
$tag <: or {
|
|
24
|
+
`a`,
|
|
25
|
+
`details`,
|
|
26
|
+
`summary`
|
|
27
|
+
},
|
|
28
|
+
$element <: within JsModule() as $module,
|
|
29
|
+
$module <: contains or {
|
|
30
|
+
`import $_ from "@cosmicdrift/kumiko-renderer/web"`,
|
|
31
|
+
`import $_ from "@cosmicdrift/kumiko-renderer-web"`,
|
|
32
|
+
`usePrimitives`
|
|
33
|
+
},
|
|
34
|
+
register_diagnostic(span=$tag, message="Raw interactive element in a file that has the primitives: use usePrimitives().Link for a, CollapsibleSection (@cosmicdrift/kumiko-renderer/web) for details/summary.", severity="warn")
|
|
35
|
+
},
|
|
36
|
+
JsxSelfClosingElement(name=$tag) as $element where {
|
|
37
|
+
$tag <: or {
|
|
38
|
+
`a`,
|
|
39
|
+
`details`,
|
|
40
|
+
`summary`
|
|
41
|
+
},
|
|
42
|
+
$element <: within JsModule() as $module,
|
|
43
|
+
$module <: contains or {
|
|
44
|
+
`import $_ from "@cosmicdrift/kumiko-renderer/web"`,
|
|
45
|
+
`import $_ from "@cosmicdrift/kumiko-renderer-web"`,
|
|
46
|
+
`usePrimitives`
|
|
47
|
+
},
|
|
48
|
+
register_diagnostic(span=$tag, message="Raw interactive element in a file that has the primitives: use usePrimitives().Link for a, CollapsibleSection (@cosmicdrift/kumiko-renderer/web) for details/summary.", severity="warn")
|
|
49
|
+
},
|
|
50
|
+
JsxAttribute(name=`className`, initializer=$classes) where {
|
|
51
|
+
$classes <: includes or {
|
|
52
|
+
"bg-",
|
|
53
|
+
"text-",
|
|
54
|
+
"border-",
|
|
55
|
+
"ring-",
|
|
56
|
+
"fill-",
|
|
57
|
+
"stroke-",
|
|
58
|
+
"from-",
|
|
59
|
+
"via-",
|
|
60
|
+
"to-",
|
|
61
|
+
"outline-",
|
|
62
|
+
"decoration-",
|
|
63
|
+
"divide-",
|
|
64
|
+
"accent-",
|
|
65
|
+
"caret-",
|
|
66
|
+
"shadow"
|
|
67
|
+
},
|
|
68
|
+
$classes <: r"(?s).*(?:(?:^|[ \t\n\r\"'`:])(?:(?:bg|text|border|ring|fill|stroke|from|via|to|outline|decoration|divide|accent|caret)-(?:red|orange|amber|yellow|lime|green|emerald|teal|cyan|sky|blue|indigo|violet|purple|fuchsia|pink|rose|slate|gray|zinc|neutral|stone)-[0-9]+(?:/[0-9]+)?|(?:bg|text|border|ring|fill|stroke|from|via|to|outline|decoration|divide|accent|caret)-\[(?:#|rgb|hsl|oklch|color-mix)[^ \t\n\r\"'`}]*|shadow(?:-[^ \t\n\r\"'`}]+)?)(?:$|[ \t\n\r\"'`}])).*",
|
|
69
|
+
register_diagnostic(span=$classes, message="Design-bearing Tailwind classes (palette colours, arbitrary colours, shadow) belong in widgets and theme tokens (--color-status-*), not in screen code.", severity="error")
|
|
70
|
+
},
|
|
71
|
+
JsFunctionDeclaration(id=$name) where {
|
|
72
|
+
$name <: includes or {
|
|
73
|
+
"Card",
|
|
74
|
+
"Table",
|
|
75
|
+
"Badge",
|
|
76
|
+
"Button",
|
|
77
|
+
"Chart",
|
|
78
|
+
"Modal",
|
|
79
|
+
"Dialog",
|
|
80
|
+
"Tooltip",
|
|
81
|
+
"Spinner",
|
|
82
|
+
"Sparkline",
|
|
83
|
+
"ProgressBar",
|
|
84
|
+
"MiniStat",
|
|
85
|
+
"EmptyState",
|
|
86
|
+
"LoadingState",
|
|
87
|
+
"ErrorState",
|
|
88
|
+
"ModeSwitch",
|
|
89
|
+
"Collapsible",
|
|
90
|
+
"DetailList",
|
|
91
|
+
"MessageThread",
|
|
92
|
+
"MessageReader",
|
|
93
|
+
"StepList",
|
|
94
|
+
"MobileTopBar",
|
|
95
|
+
"ClampedText",
|
|
96
|
+
"AttachmentChip",
|
|
97
|
+
"AttachmentCard",
|
|
98
|
+
"HtmlMailFrame",
|
|
99
|
+
"SenderSheet",
|
|
100
|
+
"SenderFrame",
|
|
101
|
+
"AiSurface"
|
|
102
|
+
},
|
|
103
|
+
$name <: r"^[A-Z][A-Za-z0-9_]*(?:Card|Table|Badge|Button|Chart|Modal|Dialog|Tooltip|Spinner|Sparkline)$|^(?:ProgressBar|MiniStat|StatCard|EmptyState|LoadingState|ErrorState|ModeSwitch|Collapsible[A-Za-z0-9_]*|DetailList|MessageThread|MessageReader|StepList|MobileTopBar|ClampedText|AttachmentChip|AttachmentCard|HtmlMailFrame|SenderSheet|SenderFrame|AiSurface)$",
|
|
104
|
+
register_diagnostic(span=$name, message="App-local UI primitive: use a framework widget or primitive (@cosmicdrift/kumiko-renderer/web: StatCard, SectionCard, StatusBadge, QueryTable, Charts, ...) or usePrimitives().", severity="error")
|
|
105
|
+
},
|
|
106
|
+
JsVariableDeclarator(id=$name, initializer=$init) where {
|
|
107
|
+
$name <: includes or {
|
|
108
|
+
"Card",
|
|
109
|
+
"Table",
|
|
110
|
+
"Badge",
|
|
111
|
+
"Button",
|
|
112
|
+
"Chart",
|
|
113
|
+
"Modal",
|
|
114
|
+
"Dialog",
|
|
115
|
+
"Tooltip",
|
|
116
|
+
"Spinner",
|
|
117
|
+
"Sparkline",
|
|
118
|
+
"ProgressBar",
|
|
119
|
+
"MiniStat",
|
|
120
|
+
"EmptyState",
|
|
121
|
+
"LoadingState",
|
|
122
|
+
"ErrorState",
|
|
123
|
+
"ModeSwitch",
|
|
124
|
+
"Collapsible",
|
|
125
|
+
"DetailList",
|
|
126
|
+
"MessageThread",
|
|
127
|
+
"MessageReader",
|
|
128
|
+
"StepList",
|
|
129
|
+
"MobileTopBar",
|
|
130
|
+
"ClampedText",
|
|
131
|
+
"AttachmentChip",
|
|
132
|
+
"AttachmentCard",
|
|
133
|
+
"HtmlMailFrame",
|
|
134
|
+
"SenderSheet",
|
|
135
|
+
"SenderFrame",
|
|
136
|
+
"AiSurface"
|
|
137
|
+
},
|
|
138
|
+
$init <: contains JsArrowFunctionExpression(),
|
|
139
|
+
$name <: r"^[A-Z][A-Za-z0-9_]*(?:Card|Table|Badge|Button|Chart|Modal|Dialog|Tooltip|Spinner|Sparkline)$|^(?:ProgressBar|MiniStat|StatCard|EmptyState|LoadingState|ErrorState|ModeSwitch|Collapsible[A-Za-z0-9_]*|DetailList|MessageThread|MessageReader|StepList|MobileTopBar|ClampedText|AttachmentChip|AttachmentCard|HtmlMailFrame|SenderSheet|SenderFrame|AiSurface)$",
|
|
140
|
+
register_diagnostic(span=$name, message="App-local UI primitive: use a framework widget or primitive (@cosmicdrift/kumiko-renderer/web: StatCard, SectionCard, StatusBadge, QueryTable, Charts, ...) or usePrimitives().", severity="error")
|
|
141
|
+
}
|
|
142
|
+
}
|