@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
|
@@ -3,6 +3,7 @@ import { bootRuleError } from "./boot-validator/boot-rule.js";
|
|
|
3
3
|
import { DEFINITION_WEBHOOK_EVENT_RULES } from "./boot-validator/definition-webhook-events-rules.js";
|
|
4
4
|
import { isObjectArgument, throwObjectArgumentRequired } from "./object-form.js";
|
|
5
5
|
import { isKebabSegment, toKebab } from "./qualified-name.js";
|
|
6
|
+
import { findOpenPayloadShape } from "./webhook-payload-strictness.js";
|
|
6
7
|
/** Delivery sends the returned payload, never the input: zod strips keys the contract does not
|
|
7
8
|
* declare, so a field added to the source row cannot leak into a webhook by accident. */
|
|
8
9
|
export function parseWebhookPayload(contract, payload) {
|
|
@@ -22,9 +23,17 @@ export function parseWebhookPayload(contract, payload) {
|
|
|
22
23
|
* included, even when the event payload carries them. */
|
|
23
24
|
export function toEntityWebhookPayload(contract, event) {
|
|
24
25
|
const { aggregateId, payload } = event;
|
|
25
|
-
const shaped =
|
|
26
|
-
|
|
27
|
-
|
|
26
|
+
const shaped = (() => {
|
|
27
|
+
switch (contract.verb) {
|
|
28
|
+
case "created":
|
|
29
|
+
return { ...payload, id: aggregateId };
|
|
30
|
+
case "updated":
|
|
31
|
+
case "deleted":
|
|
32
|
+
return { id: aggregateId, changes: payload["changes"], previous: payload["previous"] };
|
|
33
|
+
case undefined:
|
|
34
|
+
throw new Error("toEntityWebhookPayload needs an entity-derived contract; a declared contract has no verb.");
|
|
35
|
+
}
|
|
36
|
+
})();
|
|
28
37
|
return parseWebhookPayload(contract, shaped);
|
|
29
38
|
}
|
|
30
39
|
export function formatWebhookPayloadIssues(issues) {
|
|
@@ -32,6 +41,41 @@ export function formatWebhookPayloadIssues(issues) {
|
|
|
32
41
|
.map((issue) => `${issue.path === "" ? "(root)" : issue.path}: ${issue.message}`)
|
|
33
42
|
.join("; ");
|
|
34
43
|
}
|
|
44
|
+
function assertValidWebhookEventDefinition(where, definition) {
|
|
45
|
+
const { name, description, payload, version } = definition;
|
|
46
|
+
if (typeof name !== "string" || !isKebabSegment(name)) {
|
|
47
|
+
throw bootRuleError(DEFINITION_WEBHOOK_EVENT_RULES.nameNotKebab, {
|
|
48
|
+
message: `${where}: name must be kebab-case, got ${JSON.stringify(name)}`,
|
|
49
|
+
});
|
|
50
|
+
}
|
|
51
|
+
if (typeof description !== "string" || description.trim() === "") {
|
|
52
|
+
throw bootRuleError(DEFINITION_WEBHOOK_EVENT_RULES.descriptionEmpty, {
|
|
53
|
+
message: `${where}("${name}"): description must be a non-empty sentence`,
|
|
54
|
+
});
|
|
55
|
+
}
|
|
56
|
+
if (!(payload instanceof ZodObject)) {
|
|
57
|
+
throw bootRuleError(DEFINITION_WEBHOOK_EVENT_RULES.payloadNotZodObject, {
|
|
58
|
+
message: `${where}("${name}"): payload must be a zod object schema`,
|
|
59
|
+
});
|
|
60
|
+
}
|
|
61
|
+
const openShape = findOpenPayloadShape(payload);
|
|
62
|
+
if (openShape !== undefined) {
|
|
63
|
+
throw bootRuleError(DEFINITION_WEBHOOK_EVENT_RULES.payloadOpenShape, {
|
|
64
|
+
message: `${where}("${name}"): payload lets undeclared keys through at ${openShape}; use closed objects (no looseObject, passthrough or catchall)`,
|
|
65
|
+
});
|
|
66
|
+
}
|
|
67
|
+
if (!Number.isInteger(version) || version < 1) {
|
|
68
|
+
throw bootRuleError(DEFINITION_WEBHOOK_EVENT_RULES.versionInvalid, {
|
|
69
|
+
message: `${where}("${name}"): version must be a positive integer`,
|
|
70
|
+
});
|
|
71
|
+
}
|
|
72
|
+
if (definition.wireName !== undefined &&
|
|
73
|
+
(typeof definition.wireName !== "string" || definition.wireName.trim() === "")) {
|
|
74
|
+
throw bootRuleError(DEFINITION_WEBHOOK_EVENT_RULES.wireNameEmpty, {
|
|
75
|
+
message: `${where}("${name}"): wireName must be a non-empty string`,
|
|
76
|
+
});
|
|
77
|
+
}
|
|
78
|
+
}
|
|
35
79
|
export function buildWebhookEventMethods(state, featureName) {
|
|
36
80
|
return {
|
|
37
81
|
defineWebhookEvent(definition) {
|
|
@@ -39,32 +83,7 @@ export function buildWebhookEventMethods(state, featureName) {
|
|
|
39
83
|
throwObjectArgumentRequired(featureName, "defineWebhookEvent");
|
|
40
84
|
const { name, description, payload, version } = definition;
|
|
41
85
|
const where = `[Feature ${featureName}] defineWebhookEvent`;
|
|
42
|
-
|
|
43
|
-
throw bootRuleError(DEFINITION_WEBHOOK_EVENT_RULES.nameNotKebab, {
|
|
44
|
-
message: `${where}: name must be kebab-case, got ${JSON.stringify(name)}`,
|
|
45
|
-
});
|
|
46
|
-
}
|
|
47
|
-
if (typeof description !== "string" || description.trim() === "") {
|
|
48
|
-
throw bootRuleError(DEFINITION_WEBHOOK_EVENT_RULES.descriptionEmpty, {
|
|
49
|
-
message: `${where}("${name}"): description must be a non-empty sentence`,
|
|
50
|
-
});
|
|
51
|
-
}
|
|
52
|
-
if (!(payload instanceof ZodObject)) {
|
|
53
|
-
throw bootRuleError(DEFINITION_WEBHOOK_EVENT_RULES.payloadNotZodObject, {
|
|
54
|
-
message: `${where}("${name}"): payload must be a zod object schema`,
|
|
55
|
-
});
|
|
56
|
-
}
|
|
57
|
-
if (!Number.isInteger(version) || version < 1) {
|
|
58
|
-
throw bootRuleError(DEFINITION_WEBHOOK_EVENT_RULES.versionInvalid, {
|
|
59
|
-
message: `${where}("${name}"): version must be a positive integer`,
|
|
60
|
-
});
|
|
61
|
-
}
|
|
62
|
-
if (definition.wireName !== undefined &&
|
|
63
|
-
(typeof definition.wireName !== "string" || definition.wireName.trim() === "")) {
|
|
64
|
-
throw bootRuleError(DEFINITION_WEBHOOK_EVENT_RULES.wireNameEmpty, {
|
|
65
|
-
message: `${where}("${name}"): wireName must be a non-empty string`,
|
|
66
|
-
});
|
|
67
|
-
}
|
|
86
|
+
assertValidWebhookEventDefinition(where, definition);
|
|
68
87
|
const wireName = definition.wireName?.trim() ?? name;
|
|
69
88
|
const qn = `${toKebab(featureName)}:${name}`;
|
|
70
89
|
if (state.webhookEvents[qn] !== undefined) {
|
|
@@ -0,0 +1,7 @@
|
|
|
1
|
+
import type { $ZodType } from "zod/v4/core";
|
|
2
|
+
/**
|
|
3
|
+
* Path of the first object that would let undeclared keys through, else undefined.
|
|
4
|
+
* Only open object shapes count: record/any/unknown are explicitly declared field types
|
|
5
|
+
* carrying one named value, so they do not smuggle unknown keys of the row into the payload.
|
|
6
|
+
*/
|
|
7
|
+
export declare function findOpenPayloadShape(schema: $ZodType, path?: string, visited?: Set<$ZodType>): string | undefined;
|
|
@@ -0,0 +1,53 @@
|
|
|
1
|
+
import { propertyOf } from "@cosmicdrift/kumiko-types/type-guards";
|
|
2
|
+
function isLooseDef(def) {
|
|
3
|
+
return typeof def === "object" && def !== null && typeof propertyOf(def, "type") === "string";
|
|
4
|
+
}
|
|
5
|
+
function childSchemas(def, path) {
|
|
6
|
+
const candidates = [
|
|
7
|
+
[def.element, `${path}[]`],
|
|
8
|
+
[def.innerType, path],
|
|
9
|
+
[def.rest, `${path}[]`],
|
|
10
|
+
[def.in, path],
|
|
11
|
+
[def.out, path],
|
|
12
|
+
[def.valueType, `${path}[]`],
|
|
13
|
+
[def.left, path],
|
|
14
|
+
[def.right, path],
|
|
15
|
+
[def.getter?.(), path],
|
|
16
|
+
...(def.options ?? []).map((option) => [option, path]),
|
|
17
|
+
...(def.items ?? []).map((item) => [item, path]),
|
|
18
|
+
];
|
|
19
|
+
return candidates.flatMap(([child, childPath]) => child === undefined ? [] : [[child, childPath]]);
|
|
20
|
+
}
|
|
21
|
+
function findInObject(def, path, visited) {
|
|
22
|
+
if (def.catchall !== undefined && def.catchall._zod.def.type !== "never") {
|
|
23
|
+
return path === "" ? "(root)" : path;
|
|
24
|
+
}
|
|
25
|
+
for (const [key, child] of Object.entries(def.shape ?? {})) {
|
|
26
|
+
const found = findOpenPayloadShape(child, path === "" ? key : `${path}.${key}`, visited);
|
|
27
|
+
if (found !== undefined)
|
|
28
|
+
return found;
|
|
29
|
+
}
|
|
30
|
+
return undefined;
|
|
31
|
+
}
|
|
32
|
+
/**
|
|
33
|
+
* Path of the first object that would let undeclared keys through, else undefined.
|
|
34
|
+
* Only open object shapes count: record/any/unknown are explicitly declared field types
|
|
35
|
+
* carrying one named value, so they do not smuggle unknown keys of the row into the payload.
|
|
36
|
+
*/
|
|
37
|
+
export function findOpenPayloadShape(schema, path = "", visited = new Set()) {
|
|
38
|
+
// A lazy getter may point back at an ancestor; every schema is walked once.
|
|
39
|
+
if (visited.has(schema))
|
|
40
|
+
return undefined;
|
|
41
|
+
visited.add(schema);
|
|
42
|
+
const def = schema._zod.def;
|
|
43
|
+
if (!isLooseDef(def))
|
|
44
|
+
return undefined;
|
|
45
|
+
if (def.type === "object")
|
|
46
|
+
return findInObject(def, path, visited);
|
|
47
|
+
for (const [child, childPath] of childSchemas(def, path)) {
|
|
48
|
+
const found = findOpenPayloadShape(child, childPath, visited);
|
|
49
|
+
if (found !== undefined)
|
|
50
|
+
return found;
|
|
51
|
+
}
|
|
52
|
+
return undefined;
|
|
53
|
+
}
|
package/dist/env/dry-run.d.ts
CHANGED
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
import type { DryRunOptions } from "./dry-run-internals.ts";
|
|
2
|
-
import {
|
|
2
|
+
import type { ComposedEnvSchema, EnvFieldInspection } from "./index.ts";
|
|
3
3
|
export type DryRunMode = "human" | "json" | "pulumi" | "k8s";
|
|
4
4
|
/** `boot` runs the boot validators without connecting anywhere; the other
|
|
5
5
|
* modes only render the env inventory. */
|
package/dist/env/dry-run.js
CHANGED
|
@@ -8,7 +8,7 @@
|
|
|
8
8
|
// The same schema introspection (`classifyField`, `readKumikoMeta`) used
|
|
9
9
|
// by parseEnv drives the output here — single source of truth.
|
|
10
10
|
import { zodShape } from "./_zod-introspect.js";
|
|
11
|
-
import { classifyField, readKumikoMeta
|
|
11
|
+
import { classifyField, readKumikoMeta } from "./field-meta.js";
|
|
12
12
|
import { getDefaultValue, getFieldDescription, pulumiConfigKey } from "./internals.js";
|
|
13
13
|
export const DRY_RUN_ENV_VAR = "KUMIKO_DRY_RUN_ENV";
|
|
14
14
|
/** Reads `KUMIKO_DRY_RUN_ENV`. `1` and `true` mean `human`; an unknown value
|
|
@@ -0,0 +1,67 @@
|
|
|
1
|
+
import * as z from "zod";
|
|
2
|
+
import { zodDef, zodMeta } from "./_zod-introspect.js";
|
|
3
|
+
function isKumikoMeta(value) {
|
|
4
|
+
if (value === null || typeof value !== "object")
|
|
5
|
+
return false;
|
|
6
|
+
// @cast-boundary schema-walk — runtime-shape narrowing of zod-meta payload
|
|
7
|
+
const v = value;
|
|
8
|
+
if (v.kms !== undefined && v.kms !== true)
|
|
9
|
+
return false;
|
|
10
|
+
if (v.pulumi === undefined)
|
|
11
|
+
return true;
|
|
12
|
+
if (v.pulumi === null || typeof v.pulumi !== "object")
|
|
13
|
+
return false;
|
|
14
|
+
// @cast-boundary schema-walk
|
|
15
|
+
const p = v.pulumi;
|
|
16
|
+
if (p.name !== undefined && typeof p.name !== "string")
|
|
17
|
+
return false;
|
|
18
|
+
if (p.generator !== undefined && typeof p.generator !== "string")
|
|
19
|
+
return false;
|
|
20
|
+
if (p.secret !== undefined && typeof p.secret !== "boolean")
|
|
21
|
+
return false;
|
|
22
|
+
return true;
|
|
23
|
+
}
|
|
24
|
+
export function readKumikoMeta(field) {
|
|
25
|
+
const meta = zodMeta(field);
|
|
26
|
+
if (meta && typeof meta === "object" && meta !== null && "kumiko" in meta) {
|
|
27
|
+
// @cast-boundary schema-walk
|
|
28
|
+
const k = meta.kumiko;
|
|
29
|
+
if (isKumikoMeta(k))
|
|
30
|
+
return k;
|
|
31
|
+
}
|
|
32
|
+
return {};
|
|
33
|
+
}
|
|
34
|
+
export function classifyField(field) {
|
|
35
|
+
// Drill through ZodEffects/ZodPipe wrappers to find the inner kind.
|
|
36
|
+
let current = field;
|
|
37
|
+
for (let i = 0; i < 8; i++) {
|
|
38
|
+
if (current instanceof z.ZodDefault)
|
|
39
|
+
return "withDefault";
|
|
40
|
+
// `.required()` on an object wraps optional fields in nonoptional(); the
|
|
41
|
+
// wrapper makes the field required, whatever the optional beneath it says.
|
|
42
|
+
if (current instanceof z.ZodNonOptional) {
|
|
43
|
+
const beneath = zodDef(current)?.innerType;
|
|
44
|
+
if (beneath instanceof z.ZodOptional) {
|
|
45
|
+
const unwrapped = zodDef(beneath)?.innerType;
|
|
46
|
+
if (unwrapped === undefined)
|
|
47
|
+
return "required";
|
|
48
|
+
current = unwrapped;
|
|
49
|
+
continue;
|
|
50
|
+
}
|
|
51
|
+
}
|
|
52
|
+
if (current instanceof z.ZodOptional || current instanceof z.ZodNullable) {
|
|
53
|
+
return "optional";
|
|
54
|
+
}
|
|
55
|
+
const inner = zodDef(current);
|
|
56
|
+
if (inner?.innerType) {
|
|
57
|
+
current = inner.innerType;
|
|
58
|
+
continue;
|
|
59
|
+
}
|
|
60
|
+
if (inner?.in) {
|
|
61
|
+
current = inner.in;
|
|
62
|
+
continue;
|
|
63
|
+
}
|
|
64
|
+
break;
|
|
65
|
+
}
|
|
66
|
+
return "required";
|
|
67
|
+
}
|
|
@@ -0,0 +1,9 @@
|
|
|
1
|
+
import type * as z from "zod";
|
|
2
|
+
/** Cross-variable rule on one env field: gets the field's raw value and the whole env being
|
|
3
|
+
* booted (so `NODE_ENV` comes from the injected source, not `process.env`), returns a message
|
|
4
|
+
* when the value is unacceptable. Attach via `.meta({ kumiko: { envRule } })`. */
|
|
5
|
+
export type EnvFieldRule = (value: string, env: Readonly<Record<string, string | undefined>>) => string | undefined;
|
|
6
|
+
/** Rule message for one set field; undefined when the field has no rule or the value passes. */
|
|
7
|
+
export declare function envRuleViolation(field: z.ZodType, value: string, env: Readonly<Record<string, string | undefined>>): string | undefined;
|
|
8
|
+
/** Field name to rule message for every set field whose rule rejects it. */
|
|
9
|
+
export declare function envRuleViolations(schema: z.ZodObject<z.ZodRawShape>, env: Readonly<Record<string, string | undefined>>): ReadonlyMap<string, string>;
|
|
@@ -0,0 +1,46 @@
|
|
|
1
|
+
import { zodDef, zodMeta, zodShape } from "./_zod-introspect.js";
|
|
2
|
+
function isEnvFieldRule(value) {
|
|
3
|
+
return typeof value === "function";
|
|
4
|
+
}
|
|
5
|
+
function ownEnvRule(field) {
|
|
6
|
+
const meta = zodMeta(field);
|
|
7
|
+
if (typeof meta !== "object" || meta === null || !("kumiko" in meta))
|
|
8
|
+
return undefined;
|
|
9
|
+
const kumiko = meta.kumiko;
|
|
10
|
+
if (typeof kumiko !== "object" || kumiko === null || !("envRule" in kumiko))
|
|
11
|
+
return undefined;
|
|
12
|
+
return isEnvFieldRule(kumiko.envRule) ? kumiko.envRule : undefined;
|
|
13
|
+
}
|
|
14
|
+
// `.optional()`/`.default()` and unions wrap a fresh instance without the inner meta, so a
|
|
15
|
+
// reusable schema that carries the rule keeps it when an app wraps it in its own field.
|
|
16
|
+
function envRuleOf(field) {
|
|
17
|
+
const own = ownEnvRule(field);
|
|
18
|
+
if (own !== undefined)
|
|
19
|
+
return own;
|
|
20
|
+
const def = zodDef(field);
|
|
21
|
+
if (def?.innerType !== undefined)
|
|
22
|
+
return envRuleOf(def.innerType);
|
|
23
|
+
for (const option of def?.options ?? []) {
|
|
24
|
+
const fromOption = envRuleOf(option);
|
|
25
|
+
if (fromOption !== undefined)
|
|
26
|
+
return fromOption;
|
|
27
|
+
}
|
|
28
|
+
return undefined;
|
|
29
|
+
}
|
|
30
|
+
/** Rule message for one set field; undefined when the field has no rule or the value passes. */
|
|
31
|
+
export function envRuleViolation(field, value, env) {
|
|
32
|
+
return envRuleOf(field)?.(value, env);
|
|
33
|
+
}
|
|
34
|
+
/** Field name to rule message for every set field whose rule rejects it. */
|
|
35
|
+
export function envRuleViolations(schema, env) {
|
|
36
|
+
const violations = new Map();
|
|
37
|
+
for (const [name, field] of Object.entries(zodShape(schema))) {
|
|
38
|
+
const value = env[name];
|
|
39
|
+
if (value === undefined)
|
|
40
|
+
continue;
|
|
41
|
+
const message = envRuleViolation(field, value, env);
|
|
42
|
+
if (message !== undefined)
|
|
43
|
+
violations.set(name, message);
|
|
44
|
+
}
|
|
45
|
+
return violations;
|
|
46
|
+
}
|
package/dist/env/index.d.ts
CHANGED
|
@@ -1,12 +1,12 @@
|
|
|
1
1
|
import * as z from "zod";
|
|
2
2
|
import type { FeatureDefinition } from "../engine/types/feature.ts";
|
|
3
|
-
import {
|
|
3
|
+
import { classifyField, readKumikoMeta } from "./field-meta.ts";
|
|
4
|
+
import { type ComposedEnvShape, type ComposeEnvSchemaOptions, type EmptyShape, type EnvError, type EnvFieldClass, type EnvFieldStatus, type ParseEnvOptions } from "./internals.ts";
|
|
4
5
|
export { type EnvSource, requiredEnvFor } from "./required-env.ts";
|
|
5
|
-
export
|
|
6
|
+
export { classifyField, readKumikoMeta };
|
|
6
7
|
/** Env names whose schema field declares `kms: true` — the slots
|
|
7
8
|
* `resolvePlatformKeks` resolves from a ciphertext. */
|
|
8
9
|
export declare function kmsSlotsOf(schema: z.ZodObject<z.ZodRawShape>): readonly string[];
|
|
9
|
-
export declare function classifyField(field: z.ZodType): EnvFieldClass;
|
|
10
10
|
/** A feature whose registered env schema is visible in its type, so
|
|
11
11
|
* `composeEnvSchema` can type the merged schema from the feature list. */
|
|
12
12
|
export type FeatureWithEnvSchema<TFeature extends FeatureDefinition, TShape extends z.ZodRawShape> = TFeature & {
|
package/dist/env/index.js
CHANGED
|
@@ -14,41 +14,12 @@
|
|
|
14
14
|
// Without meta, defaults: `camelCase(envVarName)` for the Pulumi key,
|
|
15
15
|
// `<set-me>` placeholder for the value, no `--secret` flag.
|
|
16
16
|
import * as z from "zod";
|
|
17
|
-
import {
|
|
17
|
+
import { zodShape, zodShapeField } from "./_zod-introspect.js";
|
|
18
|
+
import { classifyField, readKumikoMeta } from "./field-meta.js";
|
|
19
|
+
import { envRuleViolation, envRuleViolations } from "./field-rules.js";
|
|
18
20
|
import { buildPulumiSuggestion, getFieldDescription, } from "./internals.js";
|
|
19
21
|
export { requiredEnvFor } from "./required-env.js";
|
|
20
|
-
|
|
21
|
-
function isKumikoMeta(value) {
|
|
22
|
-
if (value === null || typeof value !== "object")
|
|
23
|
-
return false;
|
|
24
|
-
// @cast-boundary schema-walk — runtime-shape narrowing of zod-meta payload
|
|
25
|
-
const v = value;
|
|
26
|
-
if (v.kms !== undefined && v.kms !== true)
|
|
27
|
-
return false;
|
|
28
|
-
if (v.pulumi === undefined)
|
|
29
|
-
return true;
|
|
30
|
-
if (v.pulumi === null || typeof v.pulumi !== "object")
|
|
31
|
-
return false;
|
|
32
|
-
// @cast-boundary schema-walk
|
|
33
|
-
const p = v.pulumi;
|
|
34
|
-
if (p.name !== undefined && typeof p.name !== "string")
|
|
35
|
-
return false;
|
|
36
|
-
if (p.generator !== undefined && typeof p.generator !== "string")
|
|
37
|
-
return false;
|
|
38
|
-
if (p.secret !== undefined && typeof p.secret !== "boolean")
|
|
39
|
-
return false;
|
|
40
|
-
return true;
|
|
41
|
-
}
|
|
42
|
-
export function readKumikoMeta(field) {
|
|
43
|
-
const meta = zodMeta(field);
|
|
44
|
-
if (meta && typeof meta === "object" && meta !== null && "kumiko" in meta) {
|
|
45
|
-
// @cast-boundary schema-walk
|
|
46
|
-
const k = meta.kumiko;
|
|
47
|
-
if (isKumikoMeta(k))
|
|
48
|
-
return k;
|
|
49
|
-
}
|
|
50
|
-
return {};
|
|
51
|
-
}
|
|
22
|
+
export { classifyField, readKumikoMeta };
|
|
52
23
|
/** Env names whose schema field declares `kms: true` — the slots
|
|
53
24
|
* `resolvePlatformKeks` resolves from a ciphertext. */
|
|
54
25
|
export function kmsSlotsOf(schema) {
|
|
@@ -73,41 +44,6 @@ function relaxCiphertextOnlySlots(schema, env) {
|
|
|
73
44
|
}
|
|
74
45
|
return Object.keys(relaxed).length === 0 ? schema : schema.safeExtend(relaxed);
|
|
75
46
|
}
|
|
76
|
-
// --- Field-classification helpers (Zod v4 introspection) ---
|
|
77
|
-
export function classifyField(field) {
|
|
78
|
-
// Drill through ZodEffects/ZodPipe wrappers to find the inner kind.
|
|
79
|
-
let current = field;
|
|
80
|
-
for (let i = 0; i < 8; i++) {
|
|
81
|
-
if (current instanceof z.ZodDefault)
|
|
82
|
-
return "withDefault";
|
|
83
|
-
// `.required()` on an object wraps optional fields in nonoptional(); the
|
|
84
|
-
// wrapper makes the field required, whatever the optional beneath it says.
|
|
85
|
-
if (current instanceof z.ZodNonOptional) {
|
|
86
|
-
const beneath = zodDef(current)?.innerType;
|
|
87
|
-
if (beneath instanceof z.ZodOptional) {
|
|
88
|
-
const unwrapped = zodDef(beneath)?.innerType;
|
|
89
|
-
if (unwrapped === undefined)
|
|
90
|
-
return "required";
|
|
91
|
-
current = unwrapped;
|
|
92
|
-
continue;
|
|
93
|
-
}
|
|
94
|
-
}
|
|
95
|
-
if (current instanceof z.ZodOptional || current instanceof z.ZodNullable) {
|
|
96
|
-
return "optional";
|
|
97
|
-
}
|
|
98
|
-
const inner = zodDef(current);
|
|
99
|
-
if (inner?.innerType) {
|
|
100
|
-
current = inner.innerType;
|
|
101
|
-
continue;
|
|
102
|
-
}
|
|
103
|
-
if (inner?.in) {
|
|
104
|
-
current = inner.in;
|
|
105
|
-
continue;
|
|
106
|
-
}
|
|
107
|
-
break;
|
|
108
|
-
}
|
|
109
|
-
return "required";
|
|
110
|
-
}
|
|
111
47
|
function registersEnvSchema(feature, schema) {
|
|
112
48
|
return feature.envSchema === schema;
|
|
113
49
|
}
|
|
@@ -305,12 +241,14 @@ export function parseEnv(schema, env, options = {}) {
|
|
|
305
241
|
cleaned[k] = v;
|
|
306
242
|
}
|
|
307
243
|
const result = safeParseReportingThrows(relaxCiphertextOnlySlots(schema, cleaned), cleaned);
|
|
308
|
-
|
|
244
|
+
const ruleViolations = envRuleViolations(schema, cleaned);
|
|
245
|
+
if (result.success && ruleViolations.size === 0) {
|
|
309
246
|
// @cast-boundary schema-walk — z.infer<S> erasure across safeParse result
|
|
310
247
|
return result.data;
|
|
311
248
|
}
|
|
312
249
|
// Map Zod-issues → EnvError[], augmenting with suggestions when meta+prefix.
|
|
313
|
-
const
|
|
250
|
+
const issues = result.success ? [] : result.error.issues;
|
|
251
|
+
const errors = issues.map((issue) => {
|
|
314
252
|
const name = String(issue.path[0] ?? "<unknown>");
|
|
315
253
|
const field = zodShapeField(schema, name);
|
|
316
254
|
// Zod v4 dropped the `received` property on invalid_type issues; the
|
|
@@ -333,6 +271,13 @@ export function parseEnv(schema, env, options = {}) {
|
|
|
333
271
|
...(suggestion ? { suggestion } : {}),
|
|
334
272
|
};
|
|
335
273
|
});
|
|
274
|
+
const reported = new Set(errors.map((error) => error.name));
|
|
275
|
+
for (const [name, message] of ruleViolations) {
|
|
276
|
+
if (reported.has(name))
|
|
277
|
+
continue;
|
|
278
|
+
const source = options.sources?.[name];
|
|
279
|
+
errors.push({ name, kind: "invalid", message, ...(source ? { source } : {}) });
|
|
280
|
+
}
|
|
336
281
|
throw new KumikoBootError(errors);
|
|
337
282
|
}
|
|
338
283
|
// --- Pulumi-suggestion ---
|
|
@@ -375,7 +320,7 @@ export function inspectEnv(schema, env, options = {}) {
|
|
|
375
320
|
if (raw === undefined) {
|
|
376
321
|
return { name, klass, source, status: klass === "required" ? "missing" : "unset" };
|
|
377
322
|
}
|
|
378
|
-
const issue = firstFieldIssue(field, raw);
|
|
323
|
+
const issue = firstFieldIssue(field, raw) ?? envRuleViolation(field, raw, cleaned);
|
|
379
324
|
return issue === undefined
|
|
380
325
|
? { name, klass, source, status: "set" }
|
|
381
326
|
: { name, klass, source, status: "invalid", message: issue };
|
package/dist/env/internals.d.ts
CHANGED
|
@@ -1,5 +1,6 @@
|
|
|
1
1
|
import * as z from "zod";
|
|
2
2
|
import type { FeatureDefinition } from "../engine/types/feature.ts";
|
|
3
|
+
import type { EnvFieldRule } from "./field-rules.ts";
|
|
3
4
|
export type KumikoEnvMeta = {
|
|
4
5
|
readonly pulumi?: {
|
|
5
6
|
/** Override the auto-derived camelCase Pulumi-config-key name. Apps
|
|
@@ -19,6 +20,8 @@ export type KumikoEnvMeta = {
|
|
|
19
20
|
* is unset; a set plaintext always wins. A flag, not an object: every slot
|
|
20
21
|
* uses the same `_CIPHERTEXT` twin and one shared key (`PLATFORM_KEK_KMS_*`). */
|
|
21
22
|
readonly kms?: true;
|
|
23
|
+
/** Rule that needs sibling variables, e.g. the production flag; runs in parseEnv and the boot dry run. */
|
|
24
|
+
readonly envRule?: EnvFieldRule;
|
|
22
25
|
};
|
|
23
26
|
export type EnvFieldClass = "required" | "optional" | "withDefault";
|
|
24
27
|
export declare function getDefaultValue(field: z.ZodType): unknown;
|
package/dist/env/internals.js
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
import * as z from "zod";
|
|
2
2
|
import { zodDef, zodDescription } from "./_zod-introspect.js";
|
|
3
|
-
import { readKumikoMeta } from "./
|
|
3
|
+
import { readKumikoMeta } from "./field-meta.js";
|
|
4
4
|
export function getDefaultValue(field) {
|
|
5
5
|
let current = field;
|
|
6
6
|
for (let i = 0; i < 8; i++) {
|
|
@@ -20,7 +20,6 @@ export function getDefaultValue(field) {
|
|
|
20
20
|
}
|
|
21
21
|
return undefined;
|
|
22
22
|
}
|
|
23
|
-
// @wrapper-known semantic-alias
|
|
24
23
|
export function getFieldDescription(field) {
|
|
25
24
|
return zodDescription(field);
|
|
26
25
|
}
|
|
@@ -1,2 +1,4 @@
|
|
|
1
1
|
export type EnvSource = Readonly<Record<string, string | undefined>>;
|
|
2
|
-
|
|
2
|
+
/** Strict env read for scripts and tests with a fixed label. `runProdApp`/dev boot use
|
|
3
|
+
* server-runtime's `requireEnv` instead because their advice depends on the boot context. */
|
|
4
|
+
export declare function requiredEnvFor(label: string, env: EnvSource, hint?: string): (name: string) => string;
|
package/dist/env/required-env.js
CHANGED
|
@@ -1,8 +1,11 @@
|
|
|
1
|
-
|
|
1
|
+
/** Strict env read for scripts and tests with a fixed label. `runProdApp`/dev boot use
|
|
2
|
+
* server-runtime's `requireEnv` instead because their advice depends on the boot context. */
|
|
3
|
+
export function requiredEnvFor(label, env, hint) {
|
|
2
4
|
return (name) => {
|
|
3
5
|
const value = env[name];
|
|
4
6
|
if (value === undefined || value === "") {
|
|
5
|
-
|
|
7
|
+
const suffix = hint === undefined ? "" : ` ${hint}`;
|
|
8
|
+
throw new Error(`[${label}] required env var ${name} is missing or empty.${suffix}`);
|
|
6
9
|
}
|
|
7
10
|
return value;
|
|
8
11
|
};
|
package/dist/errors/serialize.js
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
import { resolveErrorDocsUrl } from "./docs-url.js";
|
|
2
2
|
// InternalError deliberately omits `details` from the response in production,
|
|
3
|
-
// because that field often carries the internal cause. The log
|
|
4
|
-
//
|
|
3
|
+
// because that field often carries the internal cause. The server log keeps
|
|
4
|
+
// the full details.
|
|
5
5
|
//
|
|
6
6
|
// In dev/test the cause is exposed in the response body to make debugging
|
|
7
7
|
// possible — without this, a crash in a handler comes back as a bare
|
|
@@ -15,11 +15,9 @@ export function writeFailure(err) {
|
|
|
15
15
|
// over a same-named key in `details`, so passing an unrelated `reason` there
|
|
16
16
|
// by mistake can't shadow the slug). Reach for the concrete classes when you
|
|
17
17
|
// need richer payload — these two cover the bulk of handler code.
|
|
18
|
-
// @wrapper-known error-helper
|
|
19
18
|
export function failNotFound(entity, id) {
|
|
20
19
|
return writeFailure(new NotFoundError(entity, id));
|
|
21
20
|
}
|
|
22
|
-
// @wrapper-known error-helper
|
|
23
21
|
export function failUnprocessable(reason, details) {
|
|
24
22
|
return writeFailure(new UnprocessableError(reason, details ? { details } : undefined));
|
|
25
23
|
}
|
|
@@ -3,6 +3,7 @@
|
|
|
3
3
|
// without schema sprawl; CLI status commands filter by type:
|
|
4
4
|
// bunx kumiko ops seed:status → operation_type = "seed-migration"
|
|
5
5
|
// bunx kumiko ops projection:status → operation_type = "projection-rebuild"
|
|
6
|
+
import { openUnboundedSiblingPool } from "../db/connection.js";
|
|
6
7
|
import { index, integer, table as pgTable, sql, text, timestamp } from "../db/dialect.js";
|
|
7
8
|
// sql now comes from native dialect
|
|
8
9
|
import { tableExists } from "../db/index.js";
|
|
@@ -28,16 +29,26 @@ export const esOperationsTable = pgTable("kumiko_es_operations", {
|
|
|
28
29
|
typeIdx: index("kumiko_es_operations_type_idx").on(t.operationType),
|
|
29
30
|
}));
|
|
30
31
|
const ES_OPERATIONS_DDL_LOCK_KEY = "kumiko_es_operations:ddl";
|
|
32
|
+
const SIBLING_POOL_CLOSE_TIMEOUT_SECONDS = 5;
|
|
31
33
|
// Replicas boot concurrently and CREATE TABLE IF NOT EXISTS is not race-safe: the loser trips
|
|
32
|
-
// pg_type_typname_nsp_index. The lock transaction
|
|
34
|
+
// pg_type_typname_nsp_index. The lock transaction pins one pool connection, so the re-check and
|
|
35
|
+
// DDL run on a sibling pool; asking the same pool again deadlocks at DATABASE_POOL_MAX=1 or when
|
|
36
|
+
// every connection is held by a waiting lock transaction.
|
|
33
37
|
export async function createEsOperationsTable(db) {
|
|
34
38
|
// skip: the table exists, no lock needed on the common boot path.
|
|
35
39
|
if (await tableExists(db, "public.kumiko_es_operations"))
|
|
36
40
|
return;
|
|
37
|
-
|
|
38
|
-
|
|
39
|
-
|
|
40
|
-
|
|
41
|
-
|
|
42
|
-
|
|
41
|
+
const sibling = openUnboundedSiblingPool(db);
|
|
42
|
+
const ddlDb = sibling?.client ?? db;
|
|
43
|
+
try {
|
|
44
|
+
await db.begin(async (lockTx) => {
|
|
45
|
+
await acquireNamespacedAdvisoryLock(lockTx, ES_OPS_ADVISORY_LOCK_KEY, ES_OPERATIONS_DDL_LOCK_KEY);
|
|
46
|
+
if (!(await tableExists(ddlDb, "public.kumiko_es_operations"))) {
|
|
47
|
+
await unsafePushTables(ddlDb, { kumikoEsOperations: esOperationsTable });
|
|
48
|
+
}
|
|
49
|
+
});
|
|
50
|
+
}
|
|
51
|
+
finally {
|
|
52
|
+
await sibling?.close(SIBLING_POOL_CLOSE_TIMEOUT_SECONDS);
|
|
53
|
+
}
|
|
43
54
|
}
|
|
@@ -3,9 +3,9 @@
|
|
|
3
3
|
// Specification and behavior: docs/plans/features/event-store-admin-api.md
|
|
4
4
|
//
|
|
5
5
|
// Guard rail: this module is NOT re-exported from event-store/index.ts. Import only via the deep
|
|
6
|
-
// path `@cosmicdrift/kumiko-framework/event-store/admin-api`. The
|
|
7
|
-
// `
|
|
8
|
-
// scripts/migrations/, this definition
|
|
6
|
+
// path `@cosmicdrift/kumiko-framework/event-store/admin-api`. The Biome plugin
|
|
7
|
+
// `restricted-event-store-symbols` blocks calls from application code. Allowlist: samples/*/migration/,
|
|
8
|
+
// scripts/migrations/, and this definition.
|
|
9
9
|
import { instantToTimestamptzParam } from "../db/driver-value-preparation.js";
|
|
10
10
|
import { constraintOf, isUniqueViolation } from "../db/pg-error.js";
|
|
11
11
|
import { claimXactId, runAtomicEventWrite } from "../db/queries/event-store.js";
|
|
@@ -265,7 +265,6 @@ export async function loadAggregateAsOf(db, aggregateId, tenantId, asOf, options
|
|
|
265
265
|
// the next CRUD write to fail with version_conflict. Indexed lookup on the
|
|
266
266
|
// existing (aggregate_id, version) unique index. Returns 0 for empty/unknown
|
|
267
267
|
// streams (matches create()'s expectedVersion=0 convention).
|
|
268
|
-
// @wrapper-known semantic-alias
|
|
269
268
|
export async function getStreamVersion(db, aggregateId, tenantId) {
|
|
270
269
|
return inEventStreamScope(tenantId, () => selectStreamMaxVersion(db, aggregateId, tenantId));
|
|
271
270
|
}
|
|
@@ -277,7 +276,6 @@ export async function getStreamVersions(db, aggregateIds, tenantId) {
|
|
|
277
276
|
* membership. Only call from seed/system-internal paths (idempotency checks
|
|
278
277
|
* against a known aggregateId) — never from a handler reachable with
|
|
279
278
|
* caller-controlled input. */
|
|
280
|
-
// @wrapper-known semantic-alias
|
|
281
279
|
export async function getUnscopedAggregateStreamMaxVersion(db, aggregateId) {
|
|
282
280
|
return selectAggregateMaxVersion(db, aggregateId);
|
|
283
281
|
}
|
|
@@ -285,7 +283,6 @@ export async function getUnscopedAggregateStreamMaxVersion(db, aggregateId) {
|
|
|
285
283
|
// projection/consumer lag math: lag = HWM - cursor. Single-row aggregate over
|
|
286
284
|
// the bigserial PK index — sub-millisecond cost. Returns 0n on an empty log
|
|
287
285
|
// (boot, fresh tenant, post-archive).
|
|
288
|
-
// @wrapper-known semantic-alias
|
|
289
286
|
/** Seed/orphan helper — prefer this over importing the restricted existence-oracle by name. */
|
|
290
287
|
export async function getUnscopedStreamMaxVersionForSeed(...args) {
|
|
291
288
|
return getUnscopedAggregateStreamMaxVersion(...args);
|
|
@@ -1,5 +1,6 @@
|
|
|
1
1
|
export { APP_INSTANCE_STREAM_TYPE, APP_STARTED_EVENT_TYPE } from "../crypto/system-event-pii.ts";
|
|
2
2
|
export { backfillEventPiiEncryption, backfillEventPiiEncryptionBatch, } from "../db/queries/backfill-pii.ts";
|
|
3
|
+
export { type OpenStream, type OpenStreamsArgs, selectOpenStreamsStartedBefore, } from "../db/queries/event-store-open-streams.ts";
|
|
3
4
|
export { deleteRowsWithoutReplayableStream } from "../db/queries/event-store-orphan-rows.ts";
|
|
4
5
|
export { archivedStreamsTable, archiveStream, createArchivedStreamsTable, isStreamArchived, } from "./archive.ts";
|
|
5
6
|
export { SeedTimeOrderError, VersionConflictError, } from "./errors.ts";
|
|
@@ -1,5 +1,6 @@
|
|
|
1
1
|
export { APP_INSTANCE_STREAM_TYPE, APP_STARTED_EVENT_TYPE } from "../crypto/system-event-pii.js";
|
|
2
2
|
export { backfillEventPiiEncryption, backfillEventPiiEncryptionBatch, } from "../db/queries/backfill-pii.js";
|
|
3
|
+
export { selectOpenStreamsStartedBefore, } from "../db/queries/event-store-open-streams.js";
|
|
3
4
|
export { deleteRowsWithoutReplayableStream } from "../db/queries/event-store-orphan-rows.js";
|
|
4
5
|
export { archivedStreamsTable, archiveStream, createArchivedStreamsTable, isStreamArchived, } from "./archive.js";
|
|
5
6
|
export { SeedTimeOrderError, VersionConflictError, } from "./errors.js";
|