@cosmicdrift/kumiko-framework 0.413.1 → 0.415.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/AGENTS.md +5 -2
- package/agents/api/framework-db.md +14 -3
- package/agents/api/framework-engine.md +69 -13
- package/agents/api/framework-errors.md +1 -1
- package/agents/api/framework-event-store.md +14 -0
- package/agents/api/framework-ui-types.md +158 -21
- package/agents/api/renderer-web.md +112 -11
- package/agents/api/testing-helpers.md +3 -2
- package/agents/api/testing-stack.md +3 -0
- package/agents/api/types.md +248 -24
- package/agents/api.md +7 -7
- package/agents/boot-rules.md +66 -10
- package/agents/examples/api-docs.md +2 -6
- package/agents/examples/auth-mfa.md +57 -10
- package/agents/examples/chat-channels.md +2 -0
- package/agents/examples/crypto-shredding-hr.md +63 -1
- package/agents/examples/currencies-global.md +1 -0
- package/agents/examples/env-composition.md +7 -11
- package/agents/examples/managed-pages.md +90 -1
- package/agents/examples/pwa-shell.md +210 -0
- package/agents/examples/rate-limiting.md +3 -3
- package/agents/examples/record-detail-layout.md +1643 -67
- package/agents/examples/workflow-engine.md +16 -12
- package/agents/examples.md +1 -0
- package/agents/features-index.md +4 -2
- package/agents/features.md +22 -7
- package/agents/widgets.md +26 -1
- package/dist/api/api-constants.d.ts +1 -0
- package/dist/api/api-constants.js +4 -0
- package/dist/api/auth-middleware.js +4 -3
- package/dist/api/auth-routes-shared.js +2 -1
- package/dist/api/entity-read-access.d.ts +1 -0
- package/dist/api/entity-read-access.js +18 -0
- package/dist/api/export/export-route.d.ts +6 -1
- package/dist/api/export/export-route.js +27 -1
- package/dist/api/export/export-rows.js +19 -3
- package/dist/api/request-context-internals.d.ts +2 -0
- package/dist/api/request-context-scopes.js +9 -2
- package/dist/api/request-context.js +1 -1
- package/dist/api/routes.d.ts +2 -0
- package/dist/api/routes.js +9 -1
- package/dist/api/server-event-dispatcher.js +3 -0
- package/dist/api/server-extra-routes.js +2 -1
- package/dist/api/server-feature-http-routes.d.ts +9 -0
- package/dist/api/server-feature-http-routes.js +109 -0
- package/dist/api/server-middleware.js +2 -19
- package/dist/api/server-pat-rate-limit-guard.d.ts +3 -0
- package/dist/api/server-pat-rate-limit-guard.js +19 -0
- package/dist/api/server-rate-limit-wiring.d.ts +10 -0
- package/dist/api/server-rate-limit-wiring.js +37 -0
- package/dist/api/server-routes.d.ts +4 -12
- package/dist/api/server-routes.js +12 -171
- package/dist/api/server-schema-route.d.ts +3 -0
- package/dist/api/server-schema-route.js +58 -0
- package/dist/api/server-wiring.js +2 -37
- package/dist/api/server.js +3 -1
- package/dist/compliance/override-schema.js +5 -5
- package/dist/compliance/sub-processors.js +10 -1
- package/dist/crypto/index.d.ts +1 -1
- package/dist/crypto/index.js +1 -1
- package/dist/crypto/pii-field-encryption.d.ts +2 -0
- package/dist/crypto/pii-field-encryption.js +16 -1
- package/dist/db/apply-entity-event.js +4 -0
- package/dist/db/bun-sql-connection-codes.d.ts +1 -0
- package/dist/db/bun-sql-connection-codes.js +7 -0
- package/dist/db/collect-table-metas.js +4 -1
- package/dist/db/config-seed.js +1 -1
- package/dist/db/derived-field-sql.js +15 -13
- package/dist/db/derived-related-sql.d.ts +2 -2
- package/dist/db/derived-related-sql.js +4 -2
- package/dist/db/dialect.d.ts +3 -0
- package/dist/db/dialect.js +1 -3
- package/dist/db/driver-row-coercion.js +2 -2
- package/dist/db/driver-value-preparation.js +1 -1
- package/dist/db/eagerload.js +15 -12
- package/dist/db/entity-table-meta.d.ts +2 -0
- package/dist/db/entity-table-meta.js +7 -0
- package/dist/db/event-store-executor-context.js +13 -8
- package/dist/db/event-store-executor-read-aggregate-currencies.js +2 -2
- package/dist/db/event-store-executor-read-aggregate.js +2 -2
- package/dist/db/event-store-executor-read-filter.d.ts +4 -0
- package/dist/db/event-store-executor-read-filter.js +28 -11
- package/dist/db/event-store-executor-read-search.d.ts +1 -0
- package/dist/db/event-store-executor-read-search.js +6 -6
- package/dist/db/event-store-executor-read-sort.js +3 -3
- package/dist/db/event-store-executor-read-where.js +14 -5
- package/dist/db/event-store-executor-read.js +7 -7
- package/dist/db/event-store-executor-write.js +50 -95
- package/dist/db/executor-managed-tables.js +4 -1
- package/dist/db/index.d.ts +4 -2
- package/dist/db/index.js +4 -2
- package/dist/db/known-table-names.d.ts +1 -0
- package/dist/db/known-table-names.js +7 -5
- package/dist/db/list-aggregate-labels.d.ts +1 -0
- package/dist/db/list-aggregate-labels.js +9 -1
- package/dist/db/migrate-generator.js +23 -4
- package/dist/db/migrate-rls-diff.d.ts +1 -0
- package/dist/db/migrate-rls-diff.js +15 -1
- package/dist/db/migrate-runner.js +2 -2
- package/dist/db/money.d.ts +1 -1
- package/dist/db/money.js +1 -4
- package/dist/db/parent-ref-clause.d.ts +6 -2
- package/dist/db/parent-ref-clause.js +105 -24
- package/dist/db/parent-ref-global-hosts.d.ts +23 -0
- package/dist/db/parent-ref-global-hosts.js +85 -0
- package/dist/db/production-schema-command-hint.d.ts +1 -0
- package/dist/db/production-schema-command-hint.js +3 -0
- package/dist/db/queries/backfill-pii.js +55 -29
- package/dist/db/queries/ddl.js +13 -2
- package/dist/db/queries/event-store-open-streams.d.ts +15 -0
- package/dist/db/queries/event-store-open-streams.js +33 -0
- package/dist/db/queries/event-store-payload-scrub.d.ts +5 -0
- package/dist/db/queries/event-store-payload-scrub.js +11 -0
- package/dist/db/queries/event-store.js +0 -1
- package/dist/db/queries/raw-sql.js +0 -1
- package/dist/db/queries/rebuild-rls-guard.d.ts +2 -1
- package/dist/db/queries/rebuild-rls-guard.js +24 -11
- package/dist/db/queries/rls-boot-catalog.d.ts +1 -0
- package/dist/db/queries/rls-boot-catalog.js +13 -9
- package/dist/db/queries/rls-shape.d.ts +3 -1
- package/dist/db/queries/rls-shape.js +31 -6
- package/dist/db/queries/session-advisory-lock.js +2 -1
- package/dist/db/queries/test-stack.js +7 -7
- package/dist/db/query.js +16 -11
- package/dist/db/rebuild-marker.js +11 -2
- package/dist/db/render-rls-ddl.d.ts +2 -0
- package/dist/db/render-rls-ddl.js +16 -11
- package/dist/db/replay-migration-sql.js +1 -1
- package/dist/db/row-level-security-boot-check.js +18 -5
- package/dist/db/row-level-security-connection.js +25 -12
- package/dist/db/row-level-security-scope.d.ts +2 -1
- package/dist/db/row-level-security-scope.js +9 -5
- package/dist/db/sql-identifier.d.ts +1 -0
- package/dist/db/sql-identifier.js +3 -0
- package/dist/db/system-tenant-read-db.d.ts +5 -0
- package/dist/db/system-tenant-read-db.js +28 -0
- package/dist/db/table-builder.d.ts +3 -1
- package/dist/db/table-builder.js +18 -8
- package/dist/db/table-info.d.ts +1 -2
- package/dist/db/table-introspection.d.ts +3 -0
- package/dist/db/table-introspection.js +6 -0
- package/dist/db/table-push.d.ts +1 -0
- package/dist/db/table-push.js +7 -1
- package/dist/db/tenant-db-runner.d.ts +3 -0
- package/dist/db/tenant-db-runner.js +19 -1
- package/dist/db/transaction-serialization.d.ts +1 -0
- package/dist/db/transaction-serialization.js +20 -3
- package/dist/db/where-clause.js +11 -2
- package/dist/db/write-ownership-failures.d.ts +25 -0
- package/dist/db/write-ownership-failures.js +82 -0
- package/dist/engine/boot-validator/boot-check.js +7 -1
- package/dist/engine/boot-validator/boot-phases-app.js +5 -5
- package/dist/engine/boot-validator/boot-phases.js +3 -2
- package/dist/engine/boot-validator/boot-rules.d.ts +305 -28
- package/dist/engine/boot-validator/boot-rules.js +4 -0
- package/dist/engine/boot-validator/bundled-lists-table.js +2 -2
- package/dist/engine/boot-validator/card-meta-overflow-rules.d.ts +2 -2
- package/dist/engine/boot-validator/card-meta-overflow-rules.js +2 -2
- package/dist/engine/boot-validator/card-meta-overflow.js +8 -5
- package/dist/engine/boot-validator/config-deps.d.ts +0 -1
- package/dist/engine/boot-validator/config-deps.js +0 -28
- package/dist/engine/boot-validator/config-key-rules.d.ts +0 -15
- package/dist/engine/boot-validator/config-key-rules.js +0 -15
- package/dist/engine/boot-validator/dashboard-screen-target.d.ts +22 -0
- package/dist/engine/boot-validator/dashboard-screen-target.js +20 -0
- package/dist/engine/boot-validator/dashboard-stat-navigate.d.ts +1 -0
- package/dist/engine/boot-validator/dashboard-stat-navigate.js +25 -17
- package/dist/engine/boot-validator/definition-webhook-events-rules.d.ts +5 -0
- package/dist/engine/boot-validator/definition-webhook-events-rules.js +5 -0
- package/dist/engine/boot-validator/derived-sql-fields.js +1 -2
- package/dist/engine/boot-validator/entity-declaration-rules.d.ts +5 -0
- package/dist/engine/boot-validator/entity-declaration-rules.js +5 -0
- package/dist/engine/boot-validator/entity-list-screens.d.ts +1 -0
- package/dist/engine/boot-validator/entity-list-screens.js +35 -13
- package/dist/engine/boot-validator/entity-structure-rules.d.ts +5 -0
- package/dist/engine/boot-validator/entity-structure-rules.js +5 -0
- package/dist/engine/boot-validator/list-column-layout.js +10 -6
- package/dist/engine/boot-validator/list-row-guidance-rules.d.ts +67 -0
- package/dist/engine/boot-validator/list-row-guidance-rules.js +67 -0
- package/dist/engine/boot-validator/list-row-guidance.d.ts +20 -0
- package/dist/engine/boot-validator/list-row-guidance.js +143 -0
- package/dist/engine/boot-validator/list-sort-summary-rules.d.ts +42 -0
- package/dist/engine/boot-validator/list-sort-summary-rules.js +42 -0
- package/dist/engine/boot-validator/list-sort-summary.d.ts +5 -0
- package/dist/engine/boot-validator/list-sort-summary.js +160 -0
- package/dist/engine/boot-validator/list-table-options.js +15 -1
- package/dist/engine/boot-validator/list-table-rules.d.ts +10 -5
- package/dist/engine/boot-validator/list-table-rules.js +10 -5
- package/dist/engine/boot-validator/list-toolbar-options.d.ts +10 -0
- package/dist/engine/boot-validator/list-toolbar-options.js +30 -0
- package/dist/engine/boot-validator/named-filter-rules.d.ts +42 -2
- package/dist/engine/boot-validator/named-filter-rules.js +42 -2
- package/dist/engine/boot-validator/ownership.js +10 -1
- package/dist/engine/boot-validator/parent-ref.js +87 -50
- package/dist/engine/boot-validator/projection-list-screens.d.ts +1 -0
- package/dist/engine/boot-validator/projection-list-screens.js +32 -1
- package/dist/engine/boot-validator/query-output-columns.js +62 -9
- package/dist/engine/boot-validator/query-output-guidance.d.ts +7 -0
- package/dist/engine/boot-validator/query-output-guidance.js +40 -0
- package/dist/engine/boot-validator/query-refs.js +34 -1
- package/dist/engine/boot-validator/row-decoration.d.ts +11 -0
- package/dist/engine/boot-validator/row-decoration.js +16 -0
- package/dist/engine/boot-validator/screens-actions.js +1 -1
- package/dist/engine/boot-validator/screens-dashboard-links.d.ts +10 -0
- package/dist/engine/boot-validator/screens-dashboard-links.js +36 -0
- package/dist/engine/boot-validator/screens-dashboard-narrow.d.ts +4 -0
- package/dist/engine/boot-validator/screens-dashboard-narrow.js +211 -0
- package/dist/engine/boot-validator/screens-dashboard-rules.d.ts +84 -4
- package/dist/engine/boot-validator/screens-dashboard-rules.js +84 -4
- package/dist/engine/boot-validator/screens-dashboard.js +29 -7
- package/dist/engine/boot-validator/screens-kind-entity-list.js +32 -27
- package/dist/engine/boot-validator/screens-kind-projection-detail-guidance.d.ts +3 -0
- package/dist/engine/boot-validator/screens-kind-projection-detail-guidance.js +46 -0
- package/dist/engine/boot-validator/screens-kind-projection-detail-rules.d.ts +20 -0
- package/dist/engine/boot-validator/screens-kind-projection-detail-rules.js +20 -0
- package/dist/engine/boot-validator/screens-kind-projection-detail.js +2 -0
- package/dist/engine/boot-validator/screens-kind-projection-list.js +4 -0
- package/dist/engine/boot-validator/screens-kind-rules.d.ts +25 -0
- package/dist/engine/boot-validator/screens-kind-rules.js +25 -0
- package/dist/engine/boot-validator/screens-lists.d.ts +8 -2
- package/dist/engine/boot-validator/screens-lists.js +19 -3
- package/dist/engine/boot-validator/screens.js +1 -1
- package/dist/engine/boot-validator/sort-nulls.d.ts +2 -0
- package/dist/engine/boot-validator/sort-nulls.js +15 -0
- package/dist/engine/boot-validator/zod-shape.d.ts +2 -1
- package/dist/engine/boot-validator/zod-shape.js +19 -1
- package/dist/engine/build-app-schema.js +4 -0
- package/dist/engine/config-helpers.d.ts +1 -2
- package/dist/engine/config-helpers.js +6 -7
- package/dist/engine/define-feature.js +1 -0
- package/dist/engine/define-handler.d.ts +1 -0
- package/dist/engine/define-handler.js +4 -2
- package/dist/engine/definition-violations.js +2 -2
- package/dist/engine/entity-handlers.js +3 -8
- package/dist/engine/entity-list-runtime-options.js +9 -8
- package/dist/engine/factories.d.ts +2 -0
- package/dist/engine/feature-config-events-jobs.js +1 -0
- package/dist/engine/feature-entity-handlers.js +5 -2
- package/dist/engine/field-access.d.ts +1 -1
- package/dist/engine/field-access.js +7 -10
- package/dist/engine/find-entity.js +3 -3
- package/dist/engine/form-derivations.js +3 -3
- package/dist/engine/index.d.ts +3 -3
- package/dist/engine/index.js +2 -2
- package/dist/engine/named-filter-roles.d.ts +3 -0
- package/dist/engine/named-filter-roles.js +15 -0
- package/dist/engine/pipeline.js +0 -1
- package/dist/engine/project-app-schema-for-roles.js +17 -2
- package/dist/engine/qualified-name.js +0 -1
- package/dist/engine/registry-facade.js +1 -2
- package/dist/engine/registry-state.d.ts +1 -1
- package/dist/engine/registry-state.js +5 -2
- package/dist/engine/registry-validate.js +2 -1
- package/dist/engine/resolve-named-list-filters.js +5 -2
- package/dist/engine/schema-builder.js +9 -11
- package/dist/engine/screen-helpers.d.ts +12 -0
- package/dist/engine/screen-helpers.js +17 -1
- package/dist/engine/soft-delete-cleanup.js +3 -5
- package/dist/engine/state-machine.js +0 -1
- package/dist/engine/steps/_database-clock.d.ts +2 -0
- package/dist/engine/steps/_database-clock.js +6 -0
- package/dist/engine/steps/compute.js +1 -1
- package/dist/engine/steps/retry.js +5 -1
- package/dist/engine/steps/return.js +0 -1
- package/dist/engine/steps/wait-for-event.js +2 -1
- package/dist/engine/steps/wait.js +2 -1
- package/dist/engine/system-user.d.ts +2 -2
- package/dist/engine/system-user.js +2 -2
- package/dist/engine/types/handlers.d.ts +1 -1
- package/dist/engine/types/handlers.js +1 -1
- package/dist/engine/types/screen.d.ts +1 -1
- package/dist/engine/types/screen.js +1 -1
- package/dist/engine/webhook-contracts.d.ts +2 -3
- package/dist/engine/webhook-contracts.js +2 -25
- package/dist/engine/webhook-events.js +48 -29
- package/dist/engine/webhook-payload-strictness.d.ts +7 -0
- package/dist/engine/webhook-payload-strictness.js +53 -0
- package/dist/env/_zod-introspect.d.ts +1 -0
- package/dist/env/dry-run.d.ts +1 -1
- package/dist/env/dry-run.js +1 -1
- package/dist/env/field-meta.d.ts +4 -0
- package/dist/env/field-meta.js +67 -0
- package/dist/env/field-rules.d.ts +9 -0
- package/dist/env/field-rules.js +46 -0
- package/dist/env/index.d.ts +3 -3
- package/dist/env/index.js +16 -71
- package/dist/env/internals.d.ts +3 -0
- package/dist/env/internals.js +1 -2
- package/dist/env/required-env.d.ts +3 -1
- package/dist/env/required-env.js +5 -2
- package/dist/errors/reasons.d.ts +1 -0
- package/dist/errors/reasons.js +4 -0
- package/dist/errors/serialize.js +2 -2
- package/dist/errors/write-error-info.js +0 -2
- package/dist/es-ops/operations-schema.js +18 -7
- package/dist/event-store/admin-api.js +3 -3
- package/dist/event-store/event-store.js +0 -3
- package/dist/event-store/index.d.ts +1 -0
- package/dist/event-store/index.js +1 -0
- package/dist/event-store/transfer.js +1 -1
- package/dist/files/assert-file-refs-belong-to-tenant.d.ts +2 -1
- package/dist/files/assert-file-refs-belong-to-tenant.js +15 -13
- package/dist/files/bind-pending-file-refs.d.ts +3 -1
- package/dist/files/bind-pending-file-refs.js +54 -27
- package/dist/files/copy-pending-file-refs-to-tenant.js +7 -3
- package/dist/files/create-file-ref.d.ts +4 -1
- package/dist/files/create-file-ref.js +14 -3
- package/dist/files/default-file-guard.js +4 -1
- package/dist/files/file-claim.d.ts +6 -0
- package/dist/files/file-claim.js +17 -0
- package/dist/files/file-field-slots.d.ts +2 -0
- package/dist/files/file-field-slots.js +28 -0
- package/dist/files/file-ref-entity.d.ts +3 -0
- package/dist/files/file-ref-entity.js +2 -0
- package/dist/files/file-ref-table.d.ts +3 -0
- package/dist/files/file-routes.d.ts +4 -1
- package/dist/files/file-routes.js +80 -16
- package/dist/files/in-memory-provider.d.ts +1 -1
- package/dist/files/in-memory-provider.js +2 -1
- package/dist/files/index.d.ts +1 -1
- package/dist/files/index.js +1 -1
- package/dist/files/invalid-file-ref-error.d.ts +2 -0
- package/dist/files/invalid-file-ref-error.js +15 -0
- package/dist/files/local-provider.js +9 -2
- package/dist/files/provider-resolver.js +1 -1
- package/dist/files/rebind-file-ref.d.ts +3 -2
- package/dist/files/rebind-file-ref.js +24 -18
- package/dist/files/resolve-file-handles.d.ts +13 -0
- package/dist/files/resolve-file-handles.js +57 -0
- package/dist/files/storage-tracking.d.ts +1 -1
- package/dist/files/storage-tracking.js +5 -2
- package/dist/files/sweep-stale-pending-file-refs.js +10 -4
- package/dist/files/types.d.ts +4 -0
- package/dist/files/types.js +10 -0
- package/dist/files/upload-field-resolution.d.ts +1 -0
- package/dist/files/upload-field-resolution.js +16 -2
- package/dist/files/upload-ledger.js +1 -1
- package/dist/i18n/required-surface-guidance-keys.d.ts +3 -0
- package/dist/i18n/required-surface-guidance-keys.js +9 -0
- package/dist/i18n/required-surface-keys.js +21 -5
- package/dist/internal/boot-rule-table-expectations.d.ts +2 -0
- package/dist/internal/boot-rule-table-expectations.js +29 -0
- package/dist/internal/row-level-security.d.ts +1 -0
- package/dist/internal/row-level-security.js +1 -0
- package/dist/internal/testing.d.ts +1 -0
- package/dist/internal/testing.js +1 -0
- package/dist/jobs/index.d.ts +1 -0
- package/dist/jobs/index.js +1 -0
- package/dist/jobs/job-load-events.d.ts +10 -0
- package/dist/jobs/job-load-events.js +12 -0
- package/dist/jobs/job-runner-context.js +6 -158
- package/dist/jobs/job-runner-dispatch.d.ts +7 -0
- package/dist/jobs/job-runner-dispatch.js +57 -0
- package/dist/jobs/job-runner-event-triggers.js +18 -9
- package/dist/jobs/job-runner-execution.js +5 -2
- package/dist/jobs/job-runner-facets.d.ts +48 -0
- package/dist/jobs/job-runner-facets.js +156 -0
- package/dist/jobs/job-runner-gates.js +19 -11
- package/dist/jobs/job-runner-helpers.d.ts +5 -1
- package/dist/jobs/job-runner-helpers.js +18 -3
- package/dist/jobs/job-runner-scope.d.ts +1 -0
- package/dist/jobs/job-runner-scope.js +2 -0
- package/dist/jobs/job-runner-tenant-cap-lock.d.ts +2 -0
- package/dist/jobs/job-runner-tenant-cap-lock.js +30 -0
- package/dist/jobs/job-runner-types.d.ts +1 -0
- package/dist/jobs/job-runner.js +39 -70
- package/dist/jobs/obliterate-job-queues.d.ts +6 -0
- package/dist/jobs/obliterate-job-queues.js +23 -0
- package/dist/lifecycle/lifecycle.js +1 -1
- package/dist/migrations/event-header-scrub.d.ts +11 -0
- package/dist/migrations/event-header-scrub.js +33 -0
- package/dist/migrations/event-payload-scrub.d.ts +1 -1
- package/dist/migrations/event-payload-scrub.js +36 -4
- package/dist/migrations/index.d.ts +1 -0
- package/dist/migrations/index.js +2 -0
- package/dist/migrations/kumiko-drift.d.ts +5 -2
- package/dist/migrations/kumiko-drift.js +51 -14
- package/dist/migrations/pending-rebuilds.js +4 -5
- package/dist/observability/sensitive-filter.js +0 -12
- package/dist/pipeline/aggregate-type-removal.js +17 -4
- package/dist/pipeline/context-services.d.ts +2 -0
- package/dist/pipeline/context-services.js +5 -2
- package/dist/pipeline/dispatch-batch.js +4 -3
- package/dist/pipeline/dispatch-context-helpers.d.ts +11 -0
- package/dist/pipeline/dispatch-context-helpers.js +58 -0
- package/dist/pipeline/dispatch-nested-write.d.ts +7 -0
- package/dist/pipeline/dispatch-nested-write.js +119 -0
- package/dist/pipeline/dispatch-query.js +10 -3
- package/dist/pipeline/dispatch-scope.js +4 -3
- package/dist/pipeline/dispatch-shared.d.ts +2 -6
- package/dist/pipeline/dispatch-shared.js +6 -38
- package/dist/pipeline/dispatch-write.d.ts +0 -1
- package/dist/pipeline/dispatch-write.js +3 -302
- package/dist/pipeline/dispatcher-utils.js +6 -0
- package/dist/pipeline/effective-system-scope.d.ts +3 -0
- package/dist/pipeline/effective-system-scope.js +22 -0
- package/dist/pipeline/event-dispatcher-delivery.d.ts +1 -0
- package/dist/pipeline/event-dispatcher-delivery.js +20 -9
- package/dist/pipeline/event-dispatcher.d.ts +6 -1
- package/dist/pipeline/event-dispatcher.js +6 -7
- package/dist/pipeline/handler-context-auth.d.ts +3 -2
- package/dist/pipeline/handler-context-auth.js +3 -4
- package/dist/pipeline/handler-context-db.js +11 -4
- package/dist/pipeline/handler-context-dispatch.js +2 -2
- package/dist/pipeline/handler-context-events.d.ts +8 -3
- package/dist/pipeline/handler-context-events.js +20 -65
- package/dist/pipeline/handler-context-member-resolution.js +16 -8
- package/dist/pipeline/handler-context-notify.d.ts +1 -0
- package/dist/pipeline/handler-context-notify.js +2 -0
- package/dist/pipeline/handler-context-phase-denials.js +3 -2
- package/dist/pipeline/handler-context-projection.d.ts +3 -0
- package/dist/pipeline/handler-context-projection.js +39 -0
- package/dist/pipeline/handler-context-scope.d.ts +1 -1
- package/dist/pipeline/handler-context-scope.js +14 -2
- package/dist/pipeline/index.d.ts +1 -1
- package/dist/pipeline/index.js +1 -1
- package/dist/pipeline/irreversible-operation-gate.js +36 -10
- package/dist/pipeline/lifecycle-pipeline.d.ts +1 -0
- package/dist/pipeline/lifecycle-pipeline.js +7 -4
- package/dist/pipeline/member-reader.js +4 -2
- package/dist/pipeline/msp-rebuild.js +1 -1
- package/dist/pipeline/nested-write-parent-guard.d.ts +5 -0
- package/dist/pipeline/nested-write-parent-guard.js +81 -0
- package/dist/pipeline/projection-rebuild.d.ts +2 -0
- package/dist/pipeline/projection-rebuild.js +16 -7
- package/dist/pipeline/projection-state.js +4 -6
- package/dist/pipeline/system-hooks.js +36 -6
- package/dist/pipeline/write-result-masking.js +31 -3
- package/dist/pipeline/write-transition-guard.d.ts +7 -0
- package/dist/pipeline/write-transition-guard.js +95 -0
- package/dist/schema-cli/shared.d.ts +2 -0
- package/dist/schema-cli/shared.js +4 -2
- package/dist/schema-cli/validate-command.js +43 -28
- package/dist/search/meilisearch-adapter-internals.d.ts +2 -0
- package/dist/search/meilisearch-adapter-internals.js +5 -0
- package/dist/search/meilisearch-adapter.d.ts +1 -0
- package/dist/search/meilisearch-adapter.js +17 -11
- package/dist/search/reindex-entity.d.ts +2 -0
- package/dist/search/reindex-entity.js +32 -4
- package/dist/search/reindex-tenants-search.js +20 -4
- package/dist/time/tz-context.js +1 -1
- package/dist/ui-types/card-column-roles.d.ts +6 -0
- package/dist/ui-types/card-column-roles.js +21 -3
- package/dist/ui-types/index.d.ts +3 -3
- package/dist/ui-types/index.js +2 -2
- package/dist/utils/ids.js +0 -1
- package/dist/utils/index.d.ts +1 -0
- package/dist/utils/index.js +1 -0
- package/dist/utils/return-path-limit.d.ts +1 -0
- package/dist/utils/return-path-limit.js +1 -0
- package/package.json +5 -3
- package/presets/biome-app.json +39 -21
- package/presets/biome-plugins/admin-api.grit +10 -0
- package/presets/biome-plugins/error-reasons.grit +53 -0
- package/presets/biome-plugins/es-literal-writes-tests.grit +18 -0
- package/presets/biome-plugins/es-literal-writes.grit +22 -0
- package/presets/biome-plugins/i18n-locale-terminology-de.grit +15 -0
- package/presets/biome-plugins/i18n-locale-terminology-romance.grit +10 -0
- package/presets/biome-plugins/no-create-test-dispatcher.grit +5 -0
- package/presets/biome-plugins/no-css-properties-type.grit +7 -0
- package/presets/biome-plugins/no-date-api.grit +11 -0
- package/presets/biome-plugins/no-direct-fetch.grit +16 -0
- package/presets/biome-plugins/no-direct-fs.grit +16 -0
- package/presets/biome-plugins/no-external-font-cdn-css.grit +9 -0
- package/presets/biome-plugins/no-external-font-cdn.grit +12 -0
- package/presets/biome-plugins/no-raw-hooks.grit +10 -0
- package/presets/biome-plugins/no-same-folder-barrel-import.grit +11 -0
- package/presets/biome-plugins/no-screen-container-classes.grit +7 -0
- package/presets/biome-plugins/no-skipped-or-retried-tests.grit +34 -0
- package/presets/biome-plugins/no-temporal-polyfill-require.grit +10 -0
- package/presets/biome-plugins/raw-html-in-web.grit +40 -0
- package/presets/biome-plugins/raw-ui-in-app.grit +142 -0
- package/presets/biome-plugins/restricted-event-store-symbols.grit +18 -0
- package/presets/biome-plugins/test-title.grit +20 -0
- package/presets/biome-plugins/unsafe-json-parse.grit +12 -0
- package/presets/biome-rules.json +467 -0
- package/src/changes.json +366 -0
- package/dist/engine/minor-units.d.ts +0 -2
- package/dist/engine/minor-units.js +0 -8
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/reasons.d.ts
CHANGED
|
@@ -14,6 +14,7 @@ export declare const FrameworkReasons: {
|
|
|
14
14
|
readonly publicIntakeRequired: "public_intake_required";
|
|
15
15
|
readonly irreversibleOperationRequiresHighRisk: "irreversible_operation_requires_high_risk";
|
|
16
16
|
readonly instructionFieldWriteRequiresHighRisk: "instruction_field_write_requires_high_risk";
|
|
17
|
+
readonly irreversibleOperationWithoutEntryHandler: "irreversible_operation_without_entry_handler";
|
|
17
18
|
readonly subjectErased: "subject_erased";
|
|
18
19
|
readonly fileRejected: "file_rejected";
|
|
19
20
|
readonly fileViolatesBindTarget: "file_violates_bind_target";
|
package/dist/errors/reasons.js
CHANGED
|
@@ -65,6 +65,10 @@ export const FrameworkReasons = {
|
|
|
65
65
|
// delegation via ctx.dispatch.write/writeAs from a lower-risk handler does not
|
|
66
66
|
// inherit the gate.
|
|
67
67
|
instructionFieldWriteRequiresHighRisk: "instruction_field_write_requires_high_risk",
|
|
68
|
+
// AccessDeniedError: a job or consumer without a directly dispatched entry handler performs an
|
|
69
|
+
// irreversible operation but declared no irreversibleWithoutEntryHandler exception.
|
|
70
|
+
// details.handler names the job or consumer, details.gate the gate that refused.
|
|
71
|
+
irreversibleOperationWithoutEntryHandler: "irreversible_operation_without_entry_handler",
|
|
68
72
|
// ConflictError: a write touched a personal-data field of a data subject whose
|
|
69
73
|
// key was erased (crypto-shredding); the subject can no longer receive data.
|
|
70
74
|
subjectErased: "subject_erased",
|
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";
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
// The event store's own tenant-transfer primitive: the ONE place allowed to
|
|
2
2
|
// move a stream across the tenant boundary (enforced by
|
|
3
|
-
//
|
|
3
|
+
// the es-literal-writes plugin allowlist). Each move leaves an audit event in
|
|
4
4
|
// the destination tenant.
|
|
5
5
|
//
|
|
6
6
|
// Runs entirely on the caller-supplied DbRunner, so the move rides whatever
|
|
@@ -1,8 +1,9 @@
|
|
|
1
1
|
import type { SaveContext } from "@cosmicdrift/kumiko-types/hooks";
|
|
2
|
-
import type { Registry } from "../engine/types/index.ts";
|
|
2
|
+
import type { Registry, SessionUser } from "../engine/types/index.ts";
|
|
3
3
|
import type { FileRefRows } from "./load-save-file-refs.ts";
|
|
4
4
|
export declare function assertFileRefsBelongToTenant(args: {
|
|
5
5
|
readonly registry: Registry;
|
|
6
6
|
readonly result: SaveContext;
|
|
7
|
+
readonly user: SessionUser;
|
|
7
8
|
readonly fileRefRows: FileRefRows;
|
|
8
9
|
}): void;
|
|
@@ -1,7 +1,7 @@
|
|
|
1
|
-
import {
|
|
2
|
-
import { assertRowFitsFileField } from "./bind-pending-file-refs.js";
|
|
1
|
+
import { assertRowFitsFileField, isOwnUpload } from "./bind-pending-file-refs.js";
|
|
3
2
|
import { fileRefIdsBySubField, fileRefIdsInField, holdsFileRefs, resolveFileSubField, } from "./file-field-slots.js";
|
|
4
3
|
import { FILE_REF_ENTITY_NAME } from "./file-ref-entity.js";
|
|
4
|
+
import { invalidFileRefError } from "./invalid-file-ref-error.js";
|
|
5
5
|
// A file field only stores an id, and the file routes authorize by tenant at
|
|
6
6
|
// read time: without this check a writer could name another tenant's fileRef
|
|
7
7
|
// and make the record point at it. Only newly written values are checked (all
|
|
@@ -41,8 +41,15 @@ function assertNewIdsFitSubFields(fieldDef, previous, changes, fileRefRows) {
|
|
|
41
41
|
}
|
|
42
42
|
}
|
|
43
43
|
}
|
|
44
|
+
// A pending upload (no record yet) is usable by the uploader or by whoever proved the claim of
|
|
45
|
+
// its handle; a visitor-owned upload is nobody's by user id, so a bare id never suffices.
|
|
46
|
+
function mayUseRow(row, user, claimedFileRefIds) {
|
|
47
|
+
const isPending = row["entityId"] === null || row["entityId"] === undefined;
|
|
48
|
+
return !isPending || isOwnUpload(row, user) || claimedFileRefIds.has(String(row["id"]));
|
|
49
|
+
}
|
|
44
50
|
export function assertFileRefsBelongToTenant(args) {
|
|
45
|
-
const { registry, result, fileRefRows } = args;
|
|
51
|
+
const { registry, result, user, fileRefRows } = args;
|
|
52
|
+
const claimedFileRefIds = new Set(result.claimedFileRefIds);
|
|
46
53
|
// skip: saves of unregistered aggregates (custom executors) declare no file fields
|
|
47
54
|
if (result.entityName === undefined)
|
|
48
55
|
return;
|
|
@@ -71,17 +78,12 @@ export function assertFileRefsBelongToTenant(args) {
|
|
|
71
78
|
if (alreadyHeld.has(fileRefId))
|
|
72
79
|
continue;
|
|
73
80
|
const row = fileRefRows.get(fileRefId);
|
|
74
|
-
if (row !== undefined &&
|
|
81
|
+
if (row !== undefined &&
|
|
82
|
+
!isBoundToOtherRecord(row, result.entityName, recordId) &&
|
|
83
|
+
mayUseRow(row, user, claimedFileRefIds)) {
|
|
75
84
|
continue;
|
|
76
|
-
|
|
77
|
-
|
|
78
|
-
{
|
|
79
|
-
path: fieldName,
|
|
80
|
-
code: "invalid_element",
|
|
81
|
-
i18nKey: "errors.validation.invalid_element",
|
|
82
|
-
},
|
|
83
|
-
],
|
|
84
|
-
});
|
|
85
|
+
}
|
|
86
|
+
throw invalidFileRefError(fieldName);
|
|
85
87
|
}
|
|
86
88
|
assertNewIdsFitSubFields(fieldDef, result.previous[fieldName], result.changes[fieldName], fileRefRows);
|
|
87
89
|
}
|
|
@@ -4,6 +4,7 @@ import type { TenantDb } from "../db/tenant-db.ts";
|
|
|
4
4
|
import type { Registry, SessionUser } from "../engine/types/index.ts";
|
|
5
5
|
import { type FileRefRows } from "./load-save-file-refs.ts";
|
|
6
6
|
export { fileRefIdsOf } from "./file-field-slots.ts";
|
|
7
|
+
export declare function isOwnUpload(row: Readonly<Record<string, unknown>>, user: SessionUser): boolean;
|
|
7
8
|
type FileRefRow = Readonly<Record<string, unknown>>;
|
|
8
9
|
export declare function bindPendingFileRefs(args: {
|
|
9
10
|
readonly registry: Registry;
|
|
@@ -36,7 +37,8 @@ export declare function assertRowFitsFileField(row: FileRefRow, fieldDef: AnyFil
|
|
|
36
37
|
export type BindPendingFileRefOutcome = "bound" | "not-pending" | "version-conflict";
|
|
37
38
|
/**
|
|
38
39
|
* Binds one of the caller's own pending uploads to a record from a custom handler, with the
|
|
39
|
-
* same ownership predicate as the save pipeline. Anonymous callers never own an upload
|
|
40
|
+
* same ownership predicate as the save pipeline. Anonymous callers never own an upload by user
|
|
41
|
+
* id: they pass the handle from the upload response as `fileRefId`.
|
|
40
42
|
*
|
|
41
43
|
* The helper checks the upload, not the target: the caller must already be authorized to write
|
|
42
44
|
* `entityId` itself (for example a record the handler just wrote); `canWriteRecord` is not checked.
|
|
@@ -1,35 +1,40 @@
|
|
|
1
|
-
import { isUuid } from "@cosmicdrift/kumiko-types/identifiers";
|
|
1
|
+
import { isUuid, parseFileHandle } from "@cosmicdrift/kumiko-types/identifiers";
|
|
2
2
|
import { isAnonymousSessionUser } from "../engine/system-user.js";
|
|
3
3
|
import { FrameworkReasons, InternalError, reraiseAsKumikoError, UnprocessableError, } from "../errors/index.js";
|
|
4
4
|
import { getFileRefExecutor } from "./create-file-ref.js";
|
|
5
|
+
import { fileClaimMatches } from "./file-claim.js";
|
|
5
6
|
import { fileRefIdsInField, holdsFileRefs } from "./file-field-slots.js";
|
|
6
7
|
import { FILE_REF_ENTITY_NAME } from "./file-ref-entity.js";
|
|
8
|
+
import { invalidFileRefError } from "./invalid-file-ref-error.js";
|
|
7
9
|
import { loadFileRefRows } from "./load-save-file-refs.js";
|
|
8
10
|
import { validateFile } from "./types.js";
|
|
9
11
|
import { resolveAttachedField } from "./upload-field-resolution.js";
|
|
10
12
|
export { fileRefIdsOf } from "./file-field-slots.js";
|
|
11
|
-
function isPendingUploadFor(row, entityName, fieldName
|
|
12
|
-
|
|
13
|
-
|
|
14
|
-
|
|
15
|
-
|
|
16
|
-
|
|
17
|
-
|
|
18
|
-
row["insertedById"] === user.id);
|
|
13
|
+
function isPendingUploadFor(row, entityName, fieldName) {
|
|
14
|
+
return (row["entityId"] === null && row["entityType"] === entityName && row["fieldName"] === fieldName);
|
|
15
|
+
}
|
|
16
|
+
// Every anonymous visitor shares one user id, so insertedById cannot tell their uploads apart:
|
|
17
|
+
// an anonymous upload is owned by whoever holds its claim, never by user id.
|
|
18
|
+
export function isOwnUpload(row, user) {
|
|
19
|
+
return !isAnonymousSessionUser(user) && row["insertedById"] === user.id;
|
|
19
20
|
}
|
|
20
21
|
function streamVersionOf(row) {
|
|
21
22
|
return typeof row["version"] === "number" ? row["version"] : undefined;
|
|
22
23
|
}
|
|
23
24
|
async function bindPendingRow(args) {
|
|
24
|
-
const { row, fileRefId, entityName, fieldName, entityId, bindTo, user, db } = args;
|
|
25
|
-
if (!isPendingUploadFor(row, entityName, fieldName
|
|
25
|
+
const { row, fileRefId, entityName, fieldName, entityId, bindTo, user, db, claimed } = args;
|
|
26
|
+
if (!isPendingUploadFor(row, entityName, fieldName))
|
|
27
|
+
return { kind: "not-pending" };
|
|
28
|
+
if (!claimed && !isOwnUpload(row, user))
|
|
26
29
|
return { kind: "not-pending" };
|
|
27
30
|
const bound = await getFileRefExecutor().update({
|
|
28
31
|
id: fileRefId,
|
|
29
32
|
version: streamVersionOf(row),
|
|
30
|
-
changes:
|
|
31
|
-
|
|
32
|
-
|
|
33
|
+
changes: {
|
|
34
|
+
entityId,
|
|
35
|
+
...(bindTo !== undefined && { entityType: bindTo.entityName, fieldName: bindTo.fieldName }),
|
|
36
|
+
...(claimed && { claimHash: null }),
|
|
37
|
+
},
|
|
33
38
|
}, user, db);
|
|
34
39
|
return bound.isSuccess ? { kind: "bound" } : { kind: "failed", error: bound.error };
|
|
35
40
|
}
|
|
@@ -46,6 +51,7 @@ export async function bindPendingFileRefs(args) {
|
|
|
46
51
|
if (result.entityName === undefined)
|
|
47
52
|
return;
|
|
48
53
|
const entityName = result.entityName;
|
|
54
|
+
const claimedFileRefIds = new Set(result.claimedFileRefIds);
|
|
49
55
|
const entity = registry.getEntity(entityName);
|
|
50
56
|
// skip: saves of unregistered aggregates (custom executors) declare no file fields
|
|
51
57
|
if (entity === undefined)
|
|
@@ -62,6 +68,7 @@ export async function bindPendingFileRefs(args) {
|
|
|
62
68
|
const row = fileRefRows.get(fileRefId);
|
|
63
69
|
if (row === undefined)
|
|
64
70
|
continue;
|
|
71
|
+
const claimed = claimedFileRefIds.has(fileRefId);
|
|
65
72
|
const outcome = await bindPendingRow({
|
|
66
73
|
row,
|
|
67
74
|
fileRefId,
|
|
@@ -70,27 +77,41 @@ export async function bindPendingFileRefs(args) {
|
|
|
70
77
|
entityId: String(result.id),
|
|
71
78
|
user,
|
|
72
79
|
db,
|
|
80
|
+
claimed,
|
|
73
81
|
});
|
|
82
|
+
// A proven claim must end in a bind; staying silent would store the id of a file that
|
|
83
|
+
// remains pending with a live claim.
|
|
84
|
+
if (claimed && outcome.kind === "not-pending")
|
|
85
|
+
throw invalidFileRefError(fieldName);
|
|
74
86
|
if (outcome.kind === "failed")
|
|
75
87
|
throw reraiseAsKumikoError(outcome.error);
|
|
76
88
|
}
|
|
77
89
|
}
|
|
78
90
|
}
|
|
91
|
+
// `fileRefId` is a bare id (the caller must own the upload) or a handle (the claim must match).
|
|
79
92
|
async function loadPendingRow(lookup) {
|
|
80
93
|
const { fileRefId, entityName, fieldName, user, db } = lookup;
|
|
81
|
-
|
|
94
|
+
const handle = parseFileHandle(fileRefId);
|
|
95
|
+
const id = handle?.id ?? fileRefId;
|
|
96
|
+
if (!isUuid(id))
|
|
82
97
|
return undefined;
|
|
83
|
-
const row = (await loadFileRefRows(db, [
|
|
84
|
-
|
|
85
|
-
|
|
86
|
-
|
|
98
|
+
const row = (await loadFileRefRows(db, [id], user.tenantId)).get(id);
|
|
99
|
+
if (row === undefined || !isPendingUploadFor(row, entityName, fieldName))
|
|
100
|
+
return undefined;
|
|
101
|
+
if (handle !== null) {
|
|
102
|
+
return fileClaimMatches(row["claimHash"], handle.claim)
|
|
103
|
+
? { id, row, claimed: true }
|
|
104
|
+
: undefined;
|
|
105
|
+
}
|
|
106
|
+
return isOwnUpload(row, user) ? { id, row, claimed: false } : undefined;
|
|
87
107
|
}
|
|
88
108
|
// fileName is left out on purpose: it is personal data and may be encrypted; read it through
|
|
89
109
|
// the fileRef executor's detail when it is needed.
|
|
90
110
|
export async function loadPendingFileRef(lookup) {
|
|
91
|
-
const
|
|
92
|
-
if (
|
|
111
|
+
const pending = await loadPendingRow(lookup);
|
|
112
|
+
if (pending === undefined)
|
|
93
113
|
return undefined;
|
|
114
|
+
const { row } = pending;
|
|
94
115
|
const { storageKey, mimeType, size } = row;
|
|
95
116
|
const version = streamVersionOf(row);
|
|
96
117
|
if (typeof storageKey !== "string" ||
|
|
@@ -99,7 +120,7 @@ export async function loadPendingFileRef(lookup) {
|
|
|
99
120
|
version === undefined) {
|
|
100
121
|
return undefined;
|
|
101
122
|
}
|
|
102
|
-
return { id:
|
|
123
|
+
return { id: pending.id, storageKey, mimeType, size, version };
|
|
103
124
|
}
|
|
104
125
|
// The pending upload was checked against the form field it came in through; a different target
|
|
105
126
|
// field may be stricter. Metadata only (bytes are not re-read): the extension comes from the
|
|
@@ -134,7 +155,8 @@ export function assertRowFitsFileField(row, fieldDef) {
|
|
|
134
155
|
const CONCURRENT_BIND_ERROR_CODES = ["version_conflict", "unique_violation"];
|
|
135
156
|
/**
|
|
136
157
|
* Binds one of the caller's own pending uploads to a record from a custom handler, with the
|
|
137
|
-
* same ownership predicate as the save pipeline. Anonymous callers never own an upload
|
|
158
|
+
* same ownership predicate as the save pipeline. Anonymous callers never own an upload by user
|
|
159
|
+
* id: they pass the handle from the upload response as `fileRefId`.
|
|
138
160
|
*
|
|
139
161
|
* The helper checks the upload, not the target: the caller must already be authorized to write
|
|
140
162
|
* `entityId` itself (for example a record the handler just wrote); `canWriteRecord` is not checked.
|
|
@@ -149,13 +171,18 @@ const CONCURRENT_BIND_ERROR_CODES = ["version_conflict", "unique_violation"];
|
|
|
149
171
|
* winner has committed); anything else throws.
|
|
150
172
|
*/
|
|
151
173
|
export async function bindPendingFileRef(args) {
|
|
152
|
-
const
|
|
174
|
+
const pending = await loadPendingRow(args);
|
|
153
175
|
// Without a stream version the update would run unversioned and could overwrite a concurrent bind.
|
|
154
|
-
if (
|
|
176
|
+
if (pending === undefined || streamVersionOf(pending.row) === undefined)
|
|
155
177
|
return "not-pending";
|
|
156
178
|
if (args.bindTo !== undefined)
|
|
157
|
-
assertRowFitsBindTarget(args.registry, args.bindTo, row);
|
|
158
|
-
const outcome = await bindPendingRow({
|
|
179
|
+
assertRowFitsBindTarget(args.registry, args.bindTo, pending.row);
|
|
180
|
+
const outcome = await bindPendingRow({
|
|
181
|
+
...args,
|
|
182
|
+
fileRefId: pending.id,
|
|
183
|
+
row: pending.row,
|
|
184
|
+
claimed: pending.claimed,
|
|
185
|
+
});
|
|
159
186
|
switch (outcome.kind) {
|
|
160
187
|
case "bound":
|
|
161
188
|
return "bound";
|
|
@@ -1,3 +1,4 @@
|
|
|
1
|
+
import { parseFileHandle } from "@cosmicdrift/kumiko-types/identifiers";
|
|
1
2
|
import { FrameworkReasons, InternalError, reraiseAsKumikoError, UnprocessableError, writeFailure, } from "../errors/index.js";
|
|
2
3
|
import { bindPendingFileRef, loadPendingFileRef } from "./bind-pending-file-refs.js";
|
|
3
4
|
import { getFileRefExecutor } from "./create-file-ref.js";
|
|
@@ -33,11 +34,11 @@ export async function copyPendingFileRefsToTenant(args) {
|
|
|
33
34
|
if (pending === undefined)
|
|
34
35
|
return fileNotPending(fileRefId);
|
|
35
36
|
// Read through the executor so an encrypted file name arrives as plain text.
|
|
36
|
-
const detail = await executor.detail({ id:
|
|
37
|
+
const detail = await executor.detail({ id: pending.id }, source.user, source.db);
|
|
37
38
|
if (detail === null)
|
|
38
39
|
return fileNotPending(fileRefId);
|
|
39
40
|
uploads.push({
|
|
40
|
-
id:
|
|
41
|
+
id: pending.id,
|
|
41
42
|
storageKey: pending.storageKey,
|
|
42
43
|
mimeType: pending.mimeType,
|
|
43
44
|
fileName: detail.fileName,
|
|
@@ -83,5 +84,8 @@ async function bindInPlace(source, target, fileIds) {
|
|
|
83
84
|
if (outcome !== "bound")
|
|
84
85
|
return fileNotPending(fileRefId);
|
|
85
86
|
}
|
|
86
|
-
return {
|
|
87
|
+
return {
|
|
88
|
+
isSuccess: true,
|
|
89
|
+
data: fileIds.map((fileRefId) => parseFileHandle(fileRefId)?.id ?? fileRefId),
|
|
90
|
+
};
|
|
87
91
|
}
|
|
@@ -14,6 +14,7 @@ declare function buildFileRefExecutor(): import("@cosmicdrift/kumiko-types/event
|
|
|
14
14
|
readonly isDeleted?: boolean | undefined;
|
|
15
15
|
readonly deletedAt?: Temporal.Instant | null | undefined;
|
|
16
16
|
readonly deletedById?: string | null | undefined;
|
|
17
|
+
readonly claimHash: string | null;
|
|
17
18
|
readonly entityId: string | null;
|
|
18
19
|
readonly entityType: string | null;
|
|
19
20
|
readonly fieldName: string | null;
|
|
@@ -73,6 +74,8 @@ export type UploadBytesOutcome = {
|
|
|
73
74
|
export type StoreFileOutcome = {
|
|
74
75
|
readonly kind: "created";
|
|
75
76
|
readonly fileRef: CreatedFileRef;
|
|
77
|
+
/** `<id>.<claim>`, only for anonymous uploads: the one proof of owning the pending file. */
|
|
78
|
+
readonly handle?: string;
|
|
76
79
|
} | {
|
|
77
80
|
readonly kind: "rejected";
|
|
78
81
|
readonly error: string;
|
|
@@ -83,7 +86,7 @@ export type StoreFileOutcome = {
|
|
|
83
86
|
readonly failure: WriteFailure;
|
|
84
87
|
};
|
|
85
88
|
export declare function writeAcceptedFileBytes(deps: Pick<StoreFileDeps, "user" | "registry" | "attachTargets" | "defaultMaxUploadSize" | "writeBytes">, input: StoreFileInput): Promise<UploadBytesOutcome>;
|
|
86
|
-
export declare function createFileRefRow(deps: Pick<StoreFileDeps, "user" | "tenantDb">, uploaded: UploadedFileBytes): Promise<{
|
|
89
|
+
export declare function createFileRefRow(deps: Pick<StoreFileDeps, "user" | "tenantDb">, uploaded: UploadedFileBytes, claimHash?: string): Promise<{
|
|
87
90
|
readonly fileRef: CreatedFileRef;
|
|
88
91
|
} | {
|
|
89
92
|
readonly failure: WriteFailure;
|