@cosmicdrift/kumiko-framework 0.413.1 → 0.414.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/AGENTS.md +5 -2
- package/agents/api/framework-db.md +14 -3
- package/agents/api/framework-engine.md +63 -13
- package/agents/api/framework-event-store.md +14 -0
- package/agents/api/framework-ui-types.md +149 -21
- package/agents/api/renderer-web.md +93 -9
- package/agents/api/testing-helpers.md +3 -2
- package/agents/api/testing-stack.md +3 -0
- package/agents/api/types.md +205 -14
- package/agents/api.md +7 -7
- package/agents/boot-rules.md +63 -9
- package/agents/examples/api-docs.md +2 -6
- package/agents/examples/auth-mfa.md +57 -10
- package/agents/examples/chat-channels.md +2 -0
- package/agents/examples/currencies-global.md +1 -0
- package/agents/examples/env-composition.md +7 -11
- package/agents/examples/managed-pages.md +90 -1
- package/agents/examples/pwa-shell.md +210 -0
- package/agents/examples/rate-limiting.md +3 -3
- package/agents/examples/record-detail-layout.md +1537 -67
- package/agents/examples/workflow-engine.md +16 -12
- package/agents/examples.md +1 -0
- package/agents/features-index.md +4 -2
- package/agents/features.md +22 -7
- package/agents/widgets.md +19 -1
- package/dist/api/api-constants.d.ts +1 -0
- package/dist/api/api-constants.js +4 -0
- package/dist/api/auth-middleware.js +4 -3
- package/dist/api/auth-routes-shared.js +2 -1
- package/dist/api/entity-read-access.d.ts +1 -0
- package/dist/api/entity-read-access.js +18 -0
- package/dist/api/export/export-route.d.ts +6 -1
- package/dist/api/export/export-route.js +27 -1
- package/dist/api/export/export-rows.js +19 -3
- package/dist/api/routes.d.ts +2 -0
- package/dist/api/routes.js +9 -1
- package/dist/api/server-extra-routes.js +2 -1
- package/dist/api/server-feature-http-routes.d.ts +9 -0
- package/dist/api/server-feature-http-routes.js +109 -0
- package/dist/api/server-middleware.js +2 -19
- package/dist/api/server-pat-rate-limit-guard.d.ts +3 -0
- package/dist/api/server-pat-rate-limit-guard.js +19 -0
- package/dist/api/server-rate-limit-wiring.d.ts +10 -0
- package/dist/api/server-rate-limit-wiring.js +37 -0
- package/dist/api/server-routes.d.ts +4 -12
- package/dist/api/server-routes.js +12 -171
- package/dist/api/server-schema-route.d.ts +3 -0
- package/dist/api/server-schema-route.js +58 -0
- package/dist/api/server-wiring.js +2 -37
- package/dist/api/server.js +3 -1
- package/dist/compliance/override-schema.js +5 -5
- package/dist/compliance/sub-processors.js +10 -1
- package/dist/crypto/index.d.ts +1 -1
- package/dist/crypto/index.js +1 -1
- package/dist/crypto/pii-field-encryption.d.ts +2 -0
- package/dist/crypto/pii-field-encryption.js +16 -1
- package/dist/db/apply-entity-event.js +4 -0
- package/dist/db/bun-sql-connection-codes.d.ts +1 -0
- package/dist/db/bun-sql-connection-codes.js +7 -0
- package/dist/db/collect-table-metas.js +4 -1
- package/dist/db/config-seed.js +1 -1
- package/dist/db/derived-field-sql.js +15 -13
- package/dist/db/derived-related-sql.d.ts +2 -2
- package/dist/db/derived-related-sql.js +4 -2
- package/dist/db/dialect.d.ts +3 -0
- package/dist/db/dialect.js +1 -3
- package/dist/db/driver-row-coercion.js +2 -2
- package/dist/db/driver-value-preparation.js +1 -1
- package/dist/db/eagerload.js +15 -12
- package/dist/db/entity-table-meta.d.ts +2 -0
- package/dist/db/entity-table-meta.js +7 -0
- package/dist/db/event-store-executor-context.js +13 -8
- package/dist/db/event-store-executor-read-aggregate-currencies.js +2 -2
- package/dist/db/event-store-executor-read-aggregate.js +2 -2
- package/dist/db/event-store-executor-read-filter.d.ts +4 -0
- package/dist/db/event-store-executor-read-filter.js +28 -11
- package/dist/db/event-store-executor-read-search.d.ts +1 -0
- package/dist/db/event-store-executor-read-search.js +6 -6
- package/dist/db/event-store-executor-read-sort.js +3 -3
- package/dist/db/event-store-executor-read-where.js +14 -5
- package/dist/db/event-store-executor-read.js +7 -7
- package/dist/db/event-store-executor-write.js +50 -95
- package/dist/db/executor-managed-tables.js +4 -1
- package/dist/db/index.d.ts +4 -2
- package/dist/db/index.js +4 -2
- package/dist/db/known-table-names.d.ts +1 -0
- package/dist/db/known-table-names.js +7 -5
- package/dist/db/list-aggregate-labels.d.ts +1 -0
- package/dist/db/list-aggregate-labels.js +9 -1
- package/dist/db/migrate-generator.js +23 -4
- package/dist/db/migrate-rls-diff.d.ts +1 -0
- package/dist/db/migrate-rls-diff.js +15 -1
- package/dist/db/migrate-runner.js +2 -2
- package/dist/db/money.d.ts +1 -1
- package/dist/db/money.js +1 -4
- package/dist/db/parent-ref-clause.d.ts +6 -2
- package/dist/db/parent-ref-clause.js +76 -23
- package/dist/db/parent-ref-global-hosts.d.ts +20 -0
- package/dist/db/parent-ref-global-hosts.js +47 -0
- package/dist/db/production-schema-command-hint.d.ts +1 -0
- package/dist/db/production-schema-command-hint.js +3 -0
- package/dist/db/queries/backfill-pii.js +55 -29
- package/dist/db/queries/ddl.js +13 -2
- package/dist/db/queries/event-store-open-streams.d.ts +15 -0
- package/dist/db/queries/event-store-open-streams.js +33 -0
- package/dist/db/queries/event-store-payload-scrub.d.ts +5 -0
- package/dist/db/queries/event-store-payload-scrub.js +11 -0
- package/dist/db/queries/event-store.js +0 -1
- package/dist/db/queries/raw-sql.js +0 -1
- package/dist/db/queries/rebuild-rls-guard.d.ts +2 -1
- package/dist/db/queries/rebuild-rls-guard.js +24 -11
- package/dist/db/queries/rls-boot-catalog.d.ts +1 -0
- package/dist/db/queries/rls-boot-catalog.js +13 -8
- package/dist/db/queries/rls-shape.d.ts +2 -1
- package/dist/db/queries/rls-shape.js +10 -0
- package/dist/db/queries/session-advisory-lock.js +2 -1
- package/dist/db/queries/test-stack.js +7 -7
- package/dist/db/query.js +16 -11
- package/dist/db/rebuild-marker.js +11 -2
- package/dist/db/render-rls-ddl.d.ts +2 -0
- package/dist/db/render-rls-ddl.js +16 -11
- package/dist/db/replay-migration-sql.js +1 -1
- package/dist/db/row-level-security-boot-check.js +18 -5
- package/dist/db/row-level-security-connection.js +25 -12
- package/dist/db/row-level-security-scope.d.ts +2 -1
- package/dist/db/row-level-security-scope.js +9 -5
- package/dist/db/sql-identifier.d.ts +1 -0
- package/dist/db/sql-identifier.js +3 -0
- package/dist/db/system-tenant-read-db.d.ts +5 -0
- package/dist/db/system-tenant-read-db.js +28 -0
- package/dist/db/table-builder.d.ts +3 -1
- package/dist/db/table-builder.js +18 -8
- package/dist/db/table-info.d.ts +1 -2
- package/dist/db/table-introspection.d.ts +3 -0
- package/dist/db/table-introspection.js +6 -0
- package/dist/db/table-push.d.ts +1 -0
- package/dist/db/table-push.js +7 -1
- package/dist/db/tenant-db-runner.d.ts +3 -0
- package/dist/db/tenant-db-runner.js +19 -1
- package/dist/db/transaction-serialization.d.ts +1 -0
- package/dist/db/transaction-serialization.js +20 -3
- package/dist/db/where-clause.js +11 -2
- package/dist/db/write-ownership-failures.d.ts +25 -0
- package/dist/db/write-ownership-failures.js +82 -0
- package/dist/engine/boot-validator/boot-check.js +7 -1
- package/dist/engine/boot-validator/boot-phases-app.js +5 -5
- package/dist/engine/boot-validator/boot-phases.js +3 -2
- package/dist/engine/boot-validator/boot-rules.d.ts +293 -26
- package/dist/engine/boot-validator/boot-rules.js +4 -0
- package/dist/engine/boot-validator/bundled-lists-table.js +2 -2
- package/dist/engine/boot-validator/card-meta-overflow.js +1 -0
- package/dist/engine/boot-validator/config-deps.d.ts +0 -1
- package/dist/engine/boot-validator/config-deps.js +0 -28
- package/dist/engine/boot-validator/config-key-rules.d.ts +0 -15
- package/dist/engine/boot-validator/config-key-rules.js +0 -15
- package/dist/engine/boot-validator/dashboard-screen-target.d.ts +22 -0
- package/dist/engine/boot-validator/dashboard-screen-target.js +20 -0
- package/dist/engine/boot-validator/dashboard-stat-navigate.d.ts +1 -0
- package/dist/engine/boot-validator/dashboard-stat-navigate.js +25 -17
- package/dist/engine/boot-validator/definition-webhook-events-rules.d.ts +5 -0
- package/dist/engine/boot-validator/definition-webhook-events-rules.js +5 -0
- package/dist/engine/boot-validator/derived-sql-fields.js +1 -2
- package/dist/engine/boot-validator/entity-declaration-rules.d.ts +5 -0
- package/dist/engine/boot-validator/entity-declaration-rules.js +5 -0
- package/dist/engine/boot-validator/entity-list-screens.d.ts +1 -0
- package/dist/engine/boot-validator/entity-list-screens.js +33 -6
- package/dist/engine/boot-validator/entity-structure-rules.d.ts +5 -0
- package/dist/engine/boot-validator/entity-structure-rules.js +5 -0
- package/dist/engine/boot-validator/list-column-layout.js +10 -6
- package/dist/engine/boot-validator/list-row-guidance-rules.d.ts +67 -0
- package/dist/engine/boot-validator/list-row-guidance-rules.js +67 -0
- package/dist/engine/boot-validator/list-row-guidance.d.ts +20 -0
- package/dist/engine/boot-validator/list-row-guidance.js +129 -0
- package/dist/engine/boot-validator/list-sort-summary-rules.d.ts +42 -0
- package/dist/engine/boot-validator/list-sort-summary-rules.js +42 -0
- package/dist/engine/boot-validator/list-sort-summary.d.ts +5 -0
- package/dist/engine/boot-validator/list-sort-summary.js +149 -0
- package/dist/engine/boot-validator/list-table-options.js +15 -1
- package/dist/engine/boot-validator/list-table-rules.d.ts +10 -5
- package/dist/engine/boot-validator/list-table-rules.js +10 -5
- package/dist/engine/boot-validator/list-toolbar-options.d.ts +10 -0
- package/dist/engine/boot-validator/list-toolbar-options.js +31 -0
- package/dist/engine/boot-validator/named-filter-rules.d.ts +32 -2
- package/dist/engine/boot-validator/named-filter-rules.js +32 -2
- package/dist/engine/boot-validator/ownership.js +10 -1
- package/dist/engine/boot-validator/parent-ref.js +87 -50
- package/dist/engine/boot-validator/projection-list-screens.d.ts +1 -0
- package/dist/engine/boot-validator/projection-list-screens.js +31 -1
- package/dist/engine/boot-validator/query-output-columns.js +62 -9
- package/dist/engine/boot-validator/query-output-guidance.d.ts +7 -0
- package/dist/engine/boot-validator/query-output-guidance.js +39 -0
- package/dist/engine/boot-validator/query-refs.js +24 -1
- package/dist/engine/boot-validator/row-decoration.d.ts +11 -0
- package/dist/engine/boot-validator/row-decoration.js +16 -0
- package/dist/engine/boot-validator/screens-dashboard-links.d.ts +10 -0
- package/dist/engine/boot-validator/screens-dashboard-links.js +36 -0
- package/dist/engine/boot-validator/screens-dashboard-narrow.d.ts +4 -0
- package/dist/engine/boot-validator/screens-dashboard-narrow.js +211 -0
- package/dist/engine/boot-validator/screens-dashboard-rules.d.ts +84 -4
- package/dist/engine/boot-validator/screens-dashboard-rules.js +84 -4
- package/dist/engine/boot-validator/screens-dashboard.js +29 -7
- package/dist/engine/boot-validator/screens-kind-entity-list.js +32 -27
- package/dist/engine/boot-validator/screens-kind-projection-detail-guidance.d.ts +3 -0
- package/dist/engine/boot-validator/screens-kind-projection-detail-guidance.js +46 -0
- package/dist/engine/boot-validator/screens-kind-projection-detail-rules.d.ts +20 -0
- package/dist/engine/boot-validator/screens-kind-projection-detail-rules.js +20 -0
- package/dist/engine/boot-validator/screens-kind-projection-detail.js +2 -0
- package/dist/engine/boot-validator/screens-kind-projection-list.js +4 -0
- package/dist/engine/boot-validator/screens-kind-rules.d.ts +25 -0
- package/dist/engine/boot-validator/screens-kind-rules.js +25 -0
- package/dist/engine/boot-validator/screens-lists.d.ts +8 -2
- package/dist/engine/boot-validator/screens-lists.js +19 -3
- package/dist/engine/boot-validator/screens.js +1 -1
- package/dist/engine/boot-validator/sort-nulls.d.ts +2 -0
- package/dist/engine/boot-validator/sort-nulls.js +15 -0
- package/dist/engine/boot-validator/zod-shape.d.ts +2 -1
- package/dist/engine/boot-validator/zod-shape.js +19 -1
- package/dist/engine/build-app-schema.js +4 -0
- package/dist/engine/config-helpers.d.ts +1 -2
- package/dist/engine/config-helpers.js +6 -7
- package/dist/engine/define-feature.js +1 -0
- package/dist/engine/define-handler.d.ts +1 -0
- package/dist/engine/define-handler.js +4 -2
- package/dist/engine/definition-violations.js +2 -2
- package/dist/engine/entity-handlers.js +3 -8
- package/dist/engine/entity-list-runtime-options.js +9 -8
- package/dist/engine/factories.d.ts +2 -0
- package/dist/engine/feature-config-events-jobs.js +1 -0
- package/dist/engine/feature-entity-handlers.js +5 -2
- package/dist/engine/field-access.d.ts +1 -1
- package/dist/engine/field-access.js +7 -10
- package/dist/engine/find-entity.js +3 -3
- package/dist/engine/form-derivations.js +3 -3
- package/dist/engine/index.d.ts +3 -3
- package/dist/engine/index.js +2 -2
- package/dist/engine/named-filter-roles.d.ts +3 -0
- package/dist/engine/named-filter-roles.js +23 -0
- package/dist/engine/pipeline.js +0 -1
- package/dist/engine/project-app-schema-for-roles.js +17 -2
- package/dist/engine/qualified-name.js +0 -1
- package/dist/engine/registry-facade.js +1 -2
- package/dist/engine/registry-state.d.ts +1 -1
- package/dist/engine/registry-state.js +5 -2
- package/dist/engine/registry-validate.js +2 -1
- package/dist/engine/resolve-named-list-filters.js +5 -2
- package/dist/engine/schema-builder.js +6 -10
- package/dist/engine/screen-helpers.d.ts +12 -0
- package/dist/engine/screen-helpers.js +17 -1
- package/dist/engine/soft-delete-cleanup.js +1 -5
- package/dist/engine/state-machine.js +0 -1
- package/dist/engine/steps/_database-clock.d.ts +2 -0
- package/dist/engine/steps/_database-clock.js +6 -0
- package/dist/engine/steps/compute.js +1 -1
- package/dist/engine/steps/retry.js +5 -1
- package/dist/engine/steps/return.js +0 -1
- package/dist/engine/steps/wait-for-event.js +2 -1
- package/dist/engine/steps/wait.js +2 -1
- package/dist/engine/system-user.d.ts +2 -2
- package/dist/engine/system-user.js +2 -2
- package/dist/engine/types/handlers.d.ts +1 -1
- package/dist/engine/types/handlers.js +1 -1
- package/dist/engine/types/screen.d.ts +1 -1
- package/dist/engine/types/screen.js +1 -1
- package/dist/engine/webhook-contracts.d.ts +2 -3
- package/dist/engine/webhook-contracts.js +2 -25
- package/dist/engine/webhook-events.js +48 -29
- package/dist/engine/webhook-payload-strictness.d.ts +7 -0
- package/dist/engine/webhook-payload-strictness.js +53 -0
- package/dist/env/_zod-introspect.d.ts +1 -0
- package/dist/env/dry-run.d.ts +1 -1
- package/dist/env/dry-run.js +1 -1
- package/dist/env/field-meta.d.ts +4 -0
- package/dist/env/field-meta.js +67 -0
- package/dist/env/field-rules.d.ts +9 -0
- package/dist/env/field-rules.js +46 -0
- package/dist/env/index.d.ts +3 -3
- package/dist/env/index.js +16 -71
- package/dist/env/internals.d.ts +3 -0
- package/dist/env/internals.js +1 -2
- package/dist/env/required-env.d.ts +3 -1
- package/dist/env/required-env.js +5 -2
- package/dist/errors/serialize.js +2 -2
- package/dist/errors/write-error-info.js +0 -2
- package/dist/es-ops/operations-schema.js +18 -7
- package/dist/event-store/admin-api.js +3 -3
- package/dist/event-store/event-store.js +0 -3
- package/dist/event-store/index.d.ts +1 -0
- package/dist/event-store/index.js +1 -0
- package/dist/event-store/transfer.js +1 -1
- package/dist/files/assert-file-refs-belong-to-tenant.d.ts +2 -1
- package/dist/files/assert-file-refs-belong-to-tenant.js +15 -13
- package/dist/files/bind-pending-file-refs.d.ts +3 -1
- package/dist/files/bind-pending-file-refs.js +54 -27
- package/dist/files/copy-pending-file-refs-to-tenant.js +7 -3
- package/dist/files/create-file-ref.d.ts +4 -1
- package/dist/files/create-file-ref.js +14 -3
- package/dist/files/default-file-guard.js +4 -1
- package/dist/files/file-claim.d.ts +6 -0
- package/dist/files/file-claim.js +17 -0
- package/dist/files/file-field-slots.d.ts +2 -0
- package/dist/files/file-field-slots.js +28 -0
- package/dist/files/file-ref-entity.d.ts +3 -0
- package/dist/files/file-ref-entity.js +2 -0
- package/dist/files/file-ref-table.d.ts +3 -0
- package/dist/files/file-routes.d.ts +4 -1
- package/dist/files/file-routes.js +80 -16
- package/dist/files/in-memory-provider.d.ts +1 -1
- package/dist/files/in-memory-provider.js +2 -1
- package/dist/files/index.d.ts +1 -1
- package/dist/files/index.js +1 -1
- package/dist/files/invalid-file-ref-error.d.ts +2 -0
- package/dist/files/invalid-file-ref-error.js +15 -0
- package/dist/files/local-provider.js +9 -2
- package/dist/files/provider-resolver.js +1 -1
- package/dist/files/rebind-file-ref.d.ts +3 -2
- package/dist/files/rebind-file-ref.js +24 -18
- package/dist/files/resolve-file-handles.d.ts +13 -0
- package/dist/files/resolve-file-handles.js +57 -0
- package/dist/files/storage-tracking.d.ts +1 -1
- package/dist/files/storage-tracking.js +5 -2
- package/dist/files/sweep-stale-pending-file-refs.js +10 -4
- package/dist/files/types.d.ts +4 -0
- package/dist/files/types.js +10 -0
- package/dist/files/upload-field-resolution.d.ts +1 -0
- package/dist/files/upload-field-resolution.js +16 -2
- package/dist/files/upload-ledger.js +1 -1
- package/dist/i18n/required-surface-guidance-keys.d.ts +3 -0
- package/dist/i18n/required-surface-guidance-keys.js +9 -0
- package/dist/i18n/required-surface-keys.js +19 -4
- package/dist/internal/boot-rule-table-expectations.d.ts +2 -0
- package/dist/internal/boot-rule-table-expectations.js +29 -0
- package/dist/internal/row-level-security.d.ts +1 -0
- package/dist/internal/row-level-security.js +1 -0
- package/dist/internal/testing.d.ts +1 -0
- package/dist/internal/testing.js +1 -0
- package/dist/jobs/index.d.ts +1 -0
- package/dist/jobs/index.js +1 -0
- package/dist/jobs/job-load-events.d.ts +10 -0
- package/dist/jobs/job-load-events.js +12 -0
- package/dist/jobs/job-runner-context.js +6 -158
- package/dist/jobs/job-runner-dispatch.d.ts +7 -0
- package/dist/jobs/job-runner-dispatch.js +57 -0
- package/dist/jobs/job-runner-event-triggers.js +18 -9
- package/dist/jobs/job-runner-execution.js +2 -2
- package/dist/jobs/job-runner-facets.d.ts +48 -0
- package/dist/jobs/job-runner-facets.js +156 -0
- package/dist/jobs/job-runner-gates.js +19 -11
- package/dist/jobs/job-runner-helpers.d.ts +5 -1
- package/dist/jobs/job-runner-helpers.js +18 -3
- package/dist/jobs/job-runner-scope.d.ts +1 -0
- package/dist/jobs/job-runner-scope.js +2 -0
- package/dist/jobs/job-runner-tenant-cap-lock.d.ts +2 -0
- package/dist/jobs/job-runner-tenant-cap-lock.js +30 -0
- package/dist/jobs/job-runner.js +31 -70
- package/dist/jobs/obliterate-job-queues.d.ts +6 -0
- package/dist/jobs/obliterate-job-queues.js +23 -0
- package/dist/lifecycle/lifecycle.js +1 -1
- package/dist/migrations/event-header-scrub.d.ts +11 -0
- package/dist/migrations/event-header-scrub.js +33 -0
- package/dist/migrations/event-payload-scrub.d.ts +1 -1
- package/dist/migrations/event-payload-scrub.js +36 -4
- package/dist/migrations/index.d.ts +1 -0
- package/dist/migrations/index.js +2 -0
- package/dist/migrations/kumiko-drift.d.ts +5 -2
- package/dist/migrations/kumiko-drift.js +51 -14
- package/dist/migrations/pending-rebuilds.js +4 -5
- package/dist/observability/sensitive-filter.js +0 -12
- package/dist/pipeline/aggregate-type-removal.js +17 -4
- package/dist/pipeline/context-services.d.ts +2 -0
- package/dist/pipeline/context-services.js +5 -2
- package/dist/pipeline/dispatch-batch.js +4 -3
- package/dist/pipeline/dispatch-context-helpers.d.ts +11 -0
- package/dist/pipeline/dispatch-context-helpers.js +58 -0
- package/dist/pipeline/dispatch-nested-write.d.ts +7 -0
- package/dist/pipeline/dispatch-nested-write.js +119 -0
- package/dist/pipeline/dispatch-query.js +10 -3
- package/dist/pipeline/dispatch-scope.js +4 -3
- package/dist/pipeline/dispatch-shared.d.ts +2 -6
- package/dist/pipeline/dispatch-shared.js +6 -38
- package/dist/pipeline/dispatch-write.d.ts +0 -1
- package/dist/pipeline/dispatch-write.js +3 -302
- package/dist/pipeline/dispatcher-utils.js +6 -0
- package/dist/pipeline/effective-system-scope.d.ts +3 -0
- package/dist/pipeline/effective-system-scope.js +22 -0
- package/dist/pipeline/event-dispatcher-delivery.d.ts +1 -0
- package/dist/pipeline/event-dispatcher-delivery.js +17 -9
- package/dist/pipeline/event-dispatcher.d.ts +4 -1
- package/dist/pipeline/event-dispatcher.js +6 -7
- package/dist/pipeline/handler-context-auth.d.ts +3 -2
- package/dist/pipeline/handler-context-auth.js +3 -4
- package/dist/pipeline/handler-context-db.js +11 -4
- package/dist/pipeline/handler-context-dispatch.js +2 -2
- package/dist/pipeline/handler-context-events.d.ts +8 -3
- package/dist/pipeline/handler-context-events.js +20 -65
- package/dist/pipeline/handler-context-member-resolution.js +16 -8
- package/dist/pipeline/handler-context-notify.d.ts +1 -0
- package/dist/pipeline/handler-context-notify.js +2 -0
- package/dist/pipeline/handler-context-phase-denials.js +3 -2
- package/dist/pipeline/handler-context-projection.d.ts +3 -0
- package/dist/pipeline/handler-context-projection.js +39 -0
- package/dist/pipeline/handler-context-scope.d.ts +1 -1
- package/dist/pipeline/handler-context-scope.js +14 -2
- package/dist/pipeline/index.d.ts +1 -1
- package/dist/pipeline/index.js +1 -1
- package/dist/pipeline/lifecycle-pipeline.d.ts +1 -0
- package/dist/pipeline/lifecycle-pipeline.js +7 -4
- package/dist/pipeline/member-reader.js +4 -2
- package/dist/pipeline/msp-rebuild.js +1 -1
- package/dist/pipeline/nested-write-parent-guard.d.ts +5 -0
- package/dist/pipeline/nested-write-parent-guard.js +81 -0
- package/dist/pipeline/projection-rebuild.d.ts +2 -0
- package/dist/pipeline/projection-rebuild.js +16 -7
- package/dist/pipeline/projection-state.js +4 -6
- package/dist/pipeline/system-hooks.js +36 -6
- package/dist/pipeline/write-result-masking.js +31 -3
- package/dist/pipeline/write-transition-guard.d.ts +7 -0
- package/dist/pipeline/write-transition-guard.js +95 -0
- package/dist/schema-cli/shared.d.ts +2 -0
- package/dist/schema-cli/shared.js +4 -2
- package/dist/schema-cli/validate-command.js +43 -28
- package/dist/search/meilisearch-adapter.js +14 -9
- package/dist/search/reindex-entity.d.ts +2 -0
- package/dist/search/reindex-entity.js +32 -4
- package/dist/search/reindex-tenants-search.js +20 -4
- package/dist/time/tz-context.js +1 -1
- package/dist/ui-types/card-column-roles.d.ts +4 -0
- package/dist/ui-types/card-column-roles.js +6 -3
- package/dist/ui-types/index.d.ts +2 -2
- package/dist/ui-types/index.js +1 -1
- package/dist/utils/ids.js +0 -1
- package/dist/utils/index.d.ts +1 -0
- package/dist/utils/index.js +1 -0
- package/dist/utils/return-path-limit.d.ts +1 -0
- package/dist/utils/return-path-limit.js +1 -0
- package/package.json +5 -3
- package/presets/biome-app.json +39 -21
- package/presets/biome-plugins/admin-api.grit +10 -0
- package/presets/biome-plugins/error-reasons.grit +53 -0
- package/presets/biome-plugins/es-literal-writes-tests.grit +18 -0
- package/presets/biome-plugins/es-literal-writes.grit +22 -0
- package/presets/biome-plugins/i18n-locale-terminology-de.grit +15 -0
- package/presets/biome-plugins/i18n-locale-terminology-romance.grit +10 -0
- package/presets/biome-plugins/no-create-test-dispatcher.grit +5 -0
- package/presets/biome-plugins/no-css-properties-type.grit +7 -0
- package/presets/biome-plugins/no-date-api.grit +9 -0
- package/presets/biome-plugins/no-direct-fetch.grit +16 -0
- package/presets/biome-plugins/no-direct-fs.grit +16 -0
- package/presets/biome-plugins/no-external-font-cdn-css.grit +9 -0
- package/presets/biome-plugins/no-external-font-cdn.grit +12 -0
- package/presets/biome-plugins/no-raw-hooks.grit +10 -0
- package/presets/biome-plugins/no-same-folder-barrel-import.grit +11 -0
- package/presets/biome-plugins/no-screen-container-classes.grit +7 -0
- package/presets/biome-plugins/no-skipped-or-retried-tests.grit +34 -0
- package/presets/biome-plugins/no-temporal-polyfill-require.grit +10 -0
- package/presets/biome-plugins/raw-html-in-web.grit +40 -0
- package/presets/biome-plugins/raw-ui-in-app.grit +142 -0
- package/presets/biome-plugins/restricted-event-store-symbols.grit +18 -0
- package/presets/biome-plugins/test-title.grit +20 -0
- package/presets/biome-plugins/unsafe-json-parse.grit +6 -0
- package/presets/biome-rules.json +465 -0
- package/src/changes.json +309 -0
- package/dist/engine/minor-units.d.ts +0 -2
- package/dist/engine/minor-units.js +0 -8
|
@@ -3,6 +3,7 @@
|
|
|
3
3
|
//
|
|
4
4
|
// Factored out of test-files so any package can opt in (samples, downstream
|
|
5
5
|
// feature tests) without re-inventing a Map-backed mock.
|
|
6
|
+
import { FileObjectMissingError } from "./types.js";
|
|
6
7
|
export function createInMemoryFileProvider() {
|
|
7
8
|
const store = new Map();
|
|
8
9
|
return {
|
|
@@ -31,7 +32,7 @@ export function createInMemoryFileProvider() {
|
|
|
31
32
|
async read(key) {
|
|
32
33
|
const entry = store.get(key);
|
|
33
34
|
if (!entry)
|
|
34
|
-
throw new
|
|
35
|
+
throw new FileObjectMissingError(key, `in-memory file not found: ${key}`);
|
|
35
36
|
return new Uint8Array(entry.data);
|
|
36
37
|
},
|
|
37
38
|
readStream(key) {
|
package/dist/files/index.d.ts
CHANGED
|
@@ -26,7 +26,7 @@ export type { FileRefOwner, RebindFileRefContext, RebindFileRefOutcome, } from "
|
|
|
26
26
|
export { rebindFileRef } from "./rebind-file-ref.ts";
|
|
27
27
|
export { filesStorageTrackingFeature, tenantStorageUsageTable, transferTenantStorageUsage, } from "./storage-tracking.ts";
|
|
28
28
|
export type { FileStorageProvider, SignedUrlOptions, } from "./types.ts";
|
|
29
|
-
export { assertSafeStorageKey, buildStorageKey, normalizeMimeType, sniffMimeType, tenantExportPrefix, tenantStoragePrefixes, validateFile, } from "./types.ts";
|
|
29
|
+
export { assertSafeStorageKey, buildStorageKey, FileObjectMissingError, normalizeMimeType, sniffMimeType, tenantExportPrefix, tenantStoragePrefixes, validateFile, } from "./types.ts";
|
|
30
30
|
export { fileUploadLedgerTable, withUploadLedger, } from "./upload-ledger.ts";
|
|
31
31
|
export type { ZipEntry } from "./zip-stream.ts";
|
|
32
32
|
export { createZipStream } from "./zip-stream.ts";
|
package/dist/files/index.js
CHANGED
|
@@ -18,6 +18,6 @@ export { createLocalProvider } from "./local-provider.js";
|
|
|
18
18
|
export { createFileProviderForTenant, isFileProviderPlugin, } from "./provider-resolver.js";
|
|
19
19
|
export { rebindFileRef } from "./rebind-file-ref.js";
|
|
20
20
|
export { filesStorageTrackingFeature, tenantStorageUsageTable, transferTenantStorageUsage, } from "./storage-tracking.js";
|
|
21
|
-
export { assertSafeStorageKey, buildStorageKey, normalizeMimeType, sniffMimeType, tenantExportPrefix, tenantStoragePrefixes, validateFile, } from "./types.js";
|
|
21
|
+
export { assertSafeStorageKey, buildStorageKey, FileObjectMissingError, normalizeMimeType, sniffMimeType, tenantExportPrefix, tenantStoragePrefixes, validateFile, } from "./types.js";
|
|
22
22
|
export { fileUploadLedgerTable, withUploadLedger, } from "./upload-ledger.js";
|
|
23
23
|
export { createZipStream } from "./zip-stream.js";
|
|
@@ -0,0 +1,15 @@
|
|
|
1
|
+
import { ValidationError } from "../errors/index.js";
|
|
2
|
+
// One error for every way a file field can name a ref the writer may not use (missing, foreign
|
|
3
|
+
// tenant, another record's file, someone else's pending upload, wrong claim), so the cause
|
|
4
|
+
// cannot be probed.
|
|
5
|
+
export function invalidFileRefError(fieldName) {
|
|
6
|
+
return new ValidationError({
|
|
7
|
+
fields: [
|
|
8
|
+
{
|
|
9
|
+
path: fieldName,
|
|
10
|
+
code: "invalid_element",
|
|
11
|
+
i18nKey: "errors.validation.invalid_element",
|
|
12
|
+
},
|
|
13
|
+
],
|
|
14
|
+
});
|
|
15
|
+
}
|
|
@@ -3,7 +3,7 @@ import { mkdir, readdir, readFile, rename, rm, stat, unlink, writeFile } from "n
|
|
|
3
3
|
import { dirname, join, relative, resolve, sep } from "node:path";
|
|
4
4
|
import { pipeline } from "node:stream/promises";
|
|
5
5
|
import { errorCodeOf } from "@cosmicdrift/kumiko-types/type-guards";
|
|
6
|
-
import { assertSafeStorageKey } from "./types.js";
|
|
6
|
+
import { assertSafeStorageKey, FileObjectMissingError } from "./types.js";
|
|
7
7
|
// Local-filesystem backend — intended for dev + tests. Production deploys
|
|
8
8
|
// pick an object-store provider (S3/R2/…). mimeType is ignored here; the
|
|
9
9
|
// filesystem tracks no metadata beyond what the caller stores on FileRef.
|
|
@@ -55,7 +55,14 @@ export function createLocalProvider(basePath) {
|
|
|
55
55
|
},
|
|
56
56
|
async read(key) {
|
|
57
57
|
const filePath = resolveContainedPath(key);
|
|
58
|
-
|
|
58
|
+
try {
|
|
59
|
+
return await readFile(filePath);
|
|
60
|
+
}
|
|
61
|
+
catch (e) {
|
|
62
|
+
if (errorCodeOf(e) === "ENOENT")
|
|
63
|
+
throw new FileObjectMissingError(key);
|
|
64
|
+
throw e;
|
|
65
|
+
}
|
|
59
66
|
},
|
|
60
67
|
readStream(key) {
|
|
61
68
|
// node:fs createReadStream is an AsyncIterable<Buffer>; Buffer extends Uint8Array. This
|
|
@@ -98,7 +98,7 @@ export function makeFileProviderResolver(deps) {
|
|
|
98
98
|
deps.cacheSync?.onResync(() => cache.clear());
|
|
99
99
|
const resolveProvider = (tenantId) => {
|
|
100
100
|
const cached = cache.get(tenantId);
|
|
101
|
-
if (cached)
|
|
101
|
+
if (cached !== undefined)
|
|
102
102
|
return cached;
|
|
103
103
|
const built = (async () => {
|
|
104
104
|
if (!deps.registry || !deps.configAccessorFactory || !deps.db) {
|
|
@@ -18,12 +18,13 @@ export type RebindFileRefOutcome = "rebound" | "not-found" | "moved" | "version-
|
|
|
18
18
|
* file uploaded elsewhere (an upload record, a mail attachment). Server code only; pending uploads
|
|
19
19
|
* go through bindPendingFileRef.
|
|
20
20
|
*
|
|
21
|
-
* Only files of the caller's tenant are found ("not-found" otherwise,
|
|
21
|
+
* Only files of the caller's tenant that the caller may read are found ("not-found" otherwise,
|
|
22
|
+
* as for unknown ids; the system user reads every file of its tenant). The
|
|
22
23
|
* file must still sit at `from`; "moved" means it does not (any more), for example because a
|
|
23
24
|
* parallel rebind took it first. A file already at `to` answers "rebound" without a write. The
|
|
24
25
|
* target must be a registered file field whose accept/maxSize the file fits (InternalError /
|
|
25
26
|
* UnprocessableError). Unless the caller is the framework system user, the caller must be able
|
|
26
|
-
* to
|
|
27
|
+
* to write both the source record and field (it must not be locked, and an
|
|
27
28
|
* entity without update handler leaves the move to the system user) and the target record and
|
|
28
29
|
* field (AccessDeniedError, RecordLockedError); the system user skips these checks, and only the
|
|
29
30
|
* target record has to exist (NotFoundError). The update is checked against the file's stream
|
|
@@ -52,6 +52,15 @@ async function loadRow(ctx, fileRefId) {
|
|
|
52
52
|
version,
|
|
53
53
|
};
|
|
54
54
|
}
|
|
55
|
+
function callerCheckContextOf(ctx) {
|
|
56
|
+
const { dispatch } = ctx;
|
|
57
|
+
if (dispatch === undefined) {
|
|
58
|
+
throw new InternalError({
|
|
59
|
+
message: "rebindFileRef: a caller other than the system user needs ctx.dispatch.query",
|
|
60
|
+
});
|
|
61
|
+
}
|
|
62
|
+
return { ...ctx, dispatch };
|
|
63
|
+
}
|
|
55
64
|
function isOwnedBy(fileRef, owner) {
|
|
56
65
|
return (fileRef.entityType === owner.entityType &&
|
|
57
66
|
fileRef.entityId === owner.entityId &&
|
|
@@ -67,14 +76,10 @@ async function lockSourceRow(ctx, from) {
|
|
|
67
76
|
return;
|
|
68
77
|
await selectRowForUpdateById(tenantDbRunner(ctx.db), tableName, from.entityId);
|
|
69
78
|
}
|
|
70
|
-
// A caller other than the system job must be able to
|
|
71
|
-
//
|
|
72
|
-
//
|
|
73
|
-
|
|
74
|
-
async function assertCallerMayMove(ctx, fileRef, from, to) {
|
|
75
|
-
if (!(await canCallerReadFileRef(ctx, fileRef))) {
|
|
76
|
-
throw new AccessDeniedError({ message: `rebindFileRef: file ${fileRef.id} is not readable` });
|
|
77
|
-
}
|
|
79
|
+
// A caller other than the system job must be able to write both records as a save of them would:
|
|
80
|
+
// the source it takes the file from (unlocked, and with an update handler the caller passes;
|
|
81
|
+
// without one only the system job may move the file), and the target field it puts the file into.
|
|
82
|
+
async function assertCallerMayMove(ctx, from, to) {
|
|
78
83
|
const canWriteRecord = createRecordWriteCheck({
|
|
79
84
|
registry: ctx.registry,
|
|
80
85
|
canReadRecord: createRecordReadCheck(ctx.registry, (qn, payload) => ctx.dispatch.query(qn, payload)),
|
|
@@ -118,12 +123,13 @@ async function assertTargetRecordExists(ctx, to) {
|
|
|
118
123
|
* file uploaded elsewhere (an upload record, a mail attachment). Server code only; pending uploads
|
|
119
124
|
* go through bindPendingFileRef.
|
|
120
125
|
*
|
|
121
|
-
* Only files of the caller's tenant are found ("not-found" otherwise,
|
|
126
|
+
* Only files of the caller's tenant that the caller may read are found ("not-found" otherwise,
|
|
127
|
+
* as for unknown ids; the system user reads every file of its tenant). The
|
|
122
128
|
* file must still sit at `from`; "moved" means it does not (any more), for example because a
|
|
123
129
|
* parallel rebind took it first. A file already at `to` answers "rebound" without a write. The
|
|
124
130
|
* target must be a registered file field whose accept/maxSize the file fits (InternalError /
|
|
125
131
|
* UnprocessableError). Unless the caller is the framework system user, the caller must be able
|
|
126
|
-
* to
|
|
132
|
+
* to write both the source record and field (it must not be locked, and an
|
|
127
133
|
* entity without update handler leaves the move to the system user) and the target record and
|
|
128
134
|
* field (AccessDeniedError, RecordLockedError); the system user skips these checks, and only the
|
|
129
135
|
* target record has to exist (NotFoundError). The update is checked against the file's stream
|
|
@@ -140,22 +146,22 @@ export async function rebindFileRef(ctx, args) {
|
|
|
140
146
|
if (loaded === undefined)
|
|
141
147
|
return "not-found";
|
|
142
148
|
const { fileRef, version } = loaded;
|
|
149
|
+
const callerCheck = isFrameworkSystemUser(ctx.user) ? undefined : callerCheckContextOf(ctx);
|
|
150
|
+
// Before the ownership short-circuits: "moved" and "rebound" would tell a caller who may not
|
|
151
|
+
// read the file that it exists and where it sits.
|
|
152
|
+
if (callerCheck !== undefined && !(await canCallerReadFileRef(callerCheck, fileRef))) {
|
|
153
|
+
return "not-found";
|
|
154
|
+
}
|
|
143
155
|
if (isOwnedBy(fileRef, to))
|
|
144
156
|
return "rebound";
|
|
145
157
|
if (!isOwnedBy(fileRef, from))
|
|
146
158
|
return "moved";
|
|
147
159
|
assertRowFitsBindTarget(ctx.registry, { entityName: to.entityType, fieldName: to.fieldName }, fileRef);
|
|
148
|
-
if (
|
|
160
|
+
if (callerCheck === undefined) {
|
|
149
161
|
await assertTargetRecordExists(ctx, to);
|
|
150
162
|
}
|
|
151
163
|
else {
|
|
152
|
-
|
|
153
|
-
if (dispatch === undefined) {
|
|
154
|
-
throw new InternalError({
|
|
155
|
-
message: "rebindFileRef: a caller other than the system user needs ctx.dispatch.query",
|
|
156
|
-
});
|
|
157
|
-
}
|
|
158
|
-
await assertCallerMayMove({ ...ctx, dispatch }, fileRef, from, to);
|
|
164
|
+
await assertCallerMayMove(callerCheck, from, to);
|
|
159
165
|
}
|
|
160
166
|
const moved = await getFileRefExecutor().update({
|
|
161
167
|
id: fileRefId,
|
|
@@ -0,0 +1,13 @@
|
|
|
1
|
+
import type { FieldDefinition } from "@cosmicdrift/kumiko-types/fields";
|
|
2
|
+
import type { TenantDb } from "../db/tenant-db.ts";
|
|
3
|
+
import type { SessionUser } from "../engine/types/index.ts";
|
|
4
|
+
import { type WriteFailure } from "../errors/index.ts";
|
|
5
|
+
export type ResolvedFileHandles = {
|
|
6
|
+
readonly values: Readonly<Record<string, unknown>>;
|
|
7
|
+
readonly claimedFileRefIds: readonly string[];
|
|
8
|
+
} | {
|
|
9
|
+
readonly failure: WriteFailure;
|
|
10
|
+
};
|
|
11
|
+
export declare function resolveFileHandles({ fields }: {
|
|
12
|
+
readonly fields: Readonly<Record<string, FieldDefinition>>;
|
|
13
|
+
}, entityName: string, values: Readonly<Record<string, unknown>>, db: TenantDb, user: Pick<SessionUser, "tenantId">): Promise<ResolvedFileHandles>;
|
|
@@ -0,0 +1,57 @@
|
|
|
1
|
+
import { parseFileHandle } from "@cosmicdrift/kumiko-types/identifiers";
|
|
2
|
+
import { writeFailure } from "../errors/index.js";
|
|
3
|
+
import { fileClaimMatches } from "./file-claim.js";
|
|
4
|
+
import { holdsFileRefs, mapFileRefSlots } from "./file-field-slots.js";
|
|
5
|
+
import { invalidFileRefError } from "./invalid-file-ref-error.js";
|
|
6
|
+
function handlesNamedBy(fields, values) {
|
|
7
|
+
const found = [];
|
|
8
|
+
for (const [fieldName, fieldDef] of Object.entries(fields)) {
|
|
9
|
+
if (!holdsFileRefs(fieldDef) || !(fieldName in values))
|
|
10
|
+
continue;
|
|
11
|
+
mapFileRefSlots(fieldDef, values[fieldName], (entry) => {
|
|
12
|
+
const handle = parseFileHandle(entry);
|
|
13
|
+
if (handle !== null)
|
|
14
|
+
found.push({ fieldName, ...handle });
|
|
15
|
+
return entry;
|
|
16
|
+
});
|
|
17
|
+
}
|
|
18
|
+
return found;
|
|
19
|
+
}
|
|
20
|
+
// Swaps every file handle a write names for the bare fileRef id after checking its claim, so
|
|
21
|
+
// neither the claim nor the handle reaches a hook, the event or the table. A handle only proves
|
|
22
|
+
// ownership of a pending upload; a pending row with a wrong claim, a missing row or one of
|
|
23
|
+
// another tenant, or an upload made for another field fails like an unknown id. A bound row passes through as its bare id.
|
|
24
|
+
export async function resolveFileHandles({ fields }, entityName, values, db, user) {
|
|
25
|
+
const handles = handlesNamedBy(fields, values);
|
|
26
|
+
// skip: without handles there is nothing to resolve and no row to read
|
|
27
|
+
if (handles.length === 0)
|
|
28
|
+
return { values, claimedFileRefIds: [] };
|
|
29
|
+
// Loaded on demand: file_refs is built from an entity definition that needs the engine, which
|
|
30
|
+
// imports the executor this module is part of.
|
|
31
|
+
const { loadFileRefRows } = await import("./load-save-file-refs.js");
|
|
32
|
+
const rows = await loadFileRefRows(db, [...new Set(handles.map((h) => h.id))], user.tenantId);
|
|
33
|
+
const claimedFileRefIds = new Set();
|
|
34
|
+
for (const handle of handles) {
|
|
35
|
+
const row = rows.get(handle.id);
|
|
36
|
+
if (row === undefined)
|
|
37
|
+
return { failure: writeFailure(invalidFileRefError(handle.fieldName)) };
|
|
38
|
+
// A bound row needs no claim: the handle is just resubmitted next to its record, and
|
|
39
|
+
// assertFileRefsBelongToTenant judges it like a bare id (same record passes, another fails).
|
|
40
|
+
if (row["entityId"] !== null && row["entityId"] !== undefined)
|
|
41
|
+
continue;
|
|
42
|
+
// The claim is bound to the field the upload came in through: a handle issued for one field
|
|
43
|
+
// must not carry the file into another entity or field.
|
|
44
|
+
const isIssuedForThisField = row["entityType"] === entityName && row["fieldName"] === handle.fieldName;
|
|
45
|
+
if (!isIssuedForThisField || !fileClaimMatches(row["claimHash"], handle.claim)) {
|
|
46
|
+
return { failure: writeFailure(invalidFileRefError(handle.fieldName)) };
|
|
47
|
+
}
|
|
48
|
+
claimedFileRefIds.add(handle.id);
|
|
49
|
+
}
|
|
50
|
+
const resolved = { ...values };
|
|
51
|
+
for (const [fieldName, fieldDef] of Object.entries(fields)) {
|
|
52
|
+
if (!holdsFileRefs(fieldDef) || !(fieldName in values))
|
|
53
|
+
continue;
|
|
54
|
+
resolved[fieldName] = mapFileRefSlots(fieldDef, values[fieldName], (entry) => parseFileHandle(entry)?.id ?? entry);
|
|
55
|
+
}
|
|
56
|
+
return { values: resolved, claimedFileRefIds: [...claimedFileRefIds] };
|
|
57
|
+
}
|
|
@@ -7,7 +7,7 @@ export declare function fileRefStorageDelta(event: {
|
|
|
7
7
|
readonly bytes: number;
|
|
8
8
|
readonly files: number;
|
|
9
9
|
} | null;
|
|
10
|
-
export declare const tenantStorageUsageTable: import("@cosmicdrift/kumiko-types/
|
|
10
|
+
export declare const tenantStorageUsageTable: import("@cosmicdrift/kumiko-types/schema-table-types").SchemaTable;
|
|
11
11
|
export declare const filesStorageTrackingFeature: import("@cosmicdrift/kumiko-types/feature").FeatureDefinition & {
|
|
12
12
|
readonly exports: void;
|
|
13
13
|
};
|
|
@@ -15,6 +15,7 @@ import { entityEventName } from "../db/index.js";
|
|
|
15
15
|
import { toPostgresArrayLiteral } from "../db/queries/postgres-array-literal.js";
|
|
16
16
|
import { executeRawQueryRead } from "../db/queries/raw-sql.js";
|
|
17
17
|
import { incrementCounter } from "../db/query.js";
|
|
18
|
+
import { withExecutorManagedWrites } from "../db/tenant-db.js";
|
|
18
19
|
import { defineFeature, qn, toKebab } from "../engine/index.js";
|
|
19
20
|
import { selectConsumerCursorForUpdate } from "../pipeline/event-dispatcher-delivery.js";
|
|
20
21
|
import { SHARED_INSTANCE_SENTINEL } from "../pipeline/index.js";
|
|
@@ -169,14 +170,16 @@ export async function transferTenantStorageUsage(args) {
|
|
|
169
170
|
// skip: the moved fileRefs carry no applied storage share
|
|
170
171
|
if (bytes === 0 && files === 0)
|
|
171
172
|
return;
|
|
173
|
+
// read_* tables take writes only through an executor-managed runner, like the MSP apply above.
|
|
174
|
+
const managed = withExecutorManagedWrites(db);
|
|
172
175
|
// Source: insert-values stay 0/0 (same guard as the DELETED handler above)
|
|
173
176
|
// — the row this subtracts from is expected to already exist (the MSP
|
|
174
177
|
// already applied the create against it), and if it somehow doesn't, this
|
|
175
178
|
// must not conjure a negative balance out of thin air.
|
|
176
|
-
await incrementCounter(
|
|
179
|
+
await incrementCounter(managed, tenantStorageUsageTable, { tenantId: sourceTenantId, totalBytes: 0, fileCount: 0 }, { totalBytes: -bytes, fileCount: -files }, { set: { lastUpdatedAt: sql `now()` } });
|
|
177
180
|
// Destination: insert-values ARE the transferred amount (same as CREATED/
|
|
178
181
|
// RESTORED above) — a tenant claiming its first-ever fileRef must start
|
|
179
182
|
// its counter row at the transferred total, not at 0 with an increment
|
|
180
183
|
// that only fires once a row already exists.
|
|
181
|
-
await incrementCounter(
|
|
184
|
+
await incrementCounter(managed, tenantStorageUsageTable, { tenantId: destinationTenantId, totalBytes: bytes, fileCount: files }, { totalBytes: bytes, fileCount: files }, { set: { lastUpdatedAt: sql `now()` } });
|
|
182
185
|
}
|
|
@@ -3,10 +3,11 @@ import { createSystemUser, SYSTEM_USER_ID } from "../engine/system-user.js";
|
|
|
3
3
|
import { getFileRefExecutor } from "./create-file-ref.js";
|
|
4
4
|
import { fileRefsTable } from "./file-ref-table.js";
|
|
5
5
|
export const STALE_PENDING_FILE_REF_SWEEP_BATCH = 500;
|
|
6
|
-
// A pending upload names its target field (entityType set) but no record yet.
|
|
7
|
-
// target field (inbox, dropzone) and files the system generated are kept on
|
|
6
|
+
// A pending upload names its target field (entityType set, filtered in SQL) but no record yet.
|
|
7
|
+
// Uploads without a target field (inbox, dropzone) and files the system generated are kept on
|
|
8
|
+
// purpose. The system filter stays in memory: SQL `<>` would also drop rows with a NULL inserter.
|
|
8
9
|
function isStalePendingUpload(row) {
|
|
9
|
-
return row.
|
|
10
|
+
return row.insertedById !== SYSTEM_USER_ID;
|
|
10
11
|
}
|
|
11
12
|
// Soft-deletes pending uploads whose record never came, through the fileRef executor, so the
|
|
12
13
|
// soft-delete cleanup later removes their bytes like those of any deleted file.
|
|
@@ -21,6 +22,7 @@ export async function sweepStalePendingFileRefs(args) {
|
|
|
21
22
|
for (;;) {
|
|
22
23
|
const rows = await selectMany(db, fileRefsTable, {
|
|
23
24
|
entityId: null,
|
|
25
|
+
entityType: { ne: null },
|
|
24
26
|
isDeleted: false,
|
|
25
27
|
insertedAt: { lt: cutoff },
|
|
26
28
|
...(cursor !== undefined && { id: { gt: cursor } }),
|
|
@@ -35,7 +37,11 @@ export async function sweepStalePendingFileRefs(args) {
|
|
|
35
37
|
return swept;
|
|
36
38
|
cursor = lastRow.id;
|
|
37
39
|
for (const row of rows.filter(isStalePendingUpload)) {
|
|
38
|
-
|
|
40
|
+
// A form save may bind the upload after the page was read; the delete then fails instead of
|
|
41
|
+
// soft-deleting a file a record now references.
|
|
42
|
+
const removed = await executor.delete({ id: row.id }, user, db, {
|
|
43
|
+
expect: { entityId: null, isDeleted: false },
|
|
44
|
+
});
|
|
39
45
|
if (removed.isSuccess) {
|
|
40
46
|
swept++;
|
|
41
47
|
continue;
|
package/dist/files/types.d.ts
CHANGED
|
@@ -6,6 +6,10 @@ export type FileMetadata = {
|
|
|
6
6
|
readonly size: number;
|
|
7
7
|
};
|
|
8
8
|
export type { FileStorageProvider, SignedUrlOptions, WriteStreamOptions, } from "@cosmicdrift/kumiko-types/file-storage-provider-types";
|
|
9
|
+
export declare class FileObjectMissingError extends Error {
|
|
10
|
+
readonly storageKey: string;
|
|
11
|
+
constructor(storageKey: string, message?: string);
|
|
12
|
+
}
|
|
9
13
|
export type FileValidationOptions = {
|
|
10
14
|
/** "10mb"-style string or a byte count. */
|
|
11
15
|
readonly maxSize?: string | number | undefined;
|
package/dist/files/types.js
CHANGED
|
@@ -2,6 +2,16 @@ import { readZipEntryNames } from "./zip-entry-names.js";
|
|
|
2
2
|
// Lives here (not in file-ref-entity.ts) so engine code can name the entity without importing
|
|
3
3
|
// a module that calls createEntity at load time.
|
|
4
4
|
export const FILE_REF_ENTITY_NAME = "fileRef";
|
|
5
|
+
// Providers throw this when read() finds no object for a key, so callers can tell a permanently
|
|
6
|
+
// missing object from transient storage errors.
|
|
7
|
+
export class FileObjectMissingError extends Error {
|
|
8
|
+
storageKey;
|
|
9
|
+
constructor(storageKey, message = `file object not found: ${storageKey}`) {
|
|
10
|
+
super(message);
|
|
11
|
+
this.storageKey = storageKey;
|
|
12
|
+
this.name = "FileObjectMissingError";
|
|
13
|
+
}
|
|
14
|
+
}
|
|
5
15
|
export function parseMaxSize(maxSize) {
|
|
6
16
|
const match = maxSize.match(/^(\d+)(kb|mb|gb)$/i);
|
|
7
17
|
if (!match)
|
|
@@ -24,4 +24,5 @@ type UploadFieldResolution = AttachedFieldResolution | {
|
|
|
24
24
|
export declare function resolveUploadField(registry: Registry | undefined, input: UploadTarget, attachTargets: AttachTargets | undefined): UploadFieldResolution;
|
|
25
25
|
export declare function registryHasAnonymousUploadField(registry: Registry | undefined): boolean;
|
|
26
26
|
export declare function isAnonymousPendingUploadAllowed(registry: Registry | undefined, target: UploadTarget): boolean;
|
|
27
|
+
export declare function resolveMaxAnonymousUploadBytes(registry: Registry | undefined, defaultMaxSize: string): number;
|
|
27
28
|
export {};
|
|
@@ -1,6 +1,7 @@
|
|
|
1
1
|
import { isFileField } from "../engine/field-helpers.js";
|
|
2
2
|
import { isActionFormScreenQn, resolveActionFormFileField } from "./action-form-upload.js";
|
|
3
3
|
import { resolveFileSubField } from "./file-field-slots.js";
|
|
4
|
+
import { parseMaxSize } from "./types.js";
|
|
4
5
|
function findAttachEntity(registry, entityType, attachTargets) {
|
|
5
6
|
return (registry?.getEntity(entityType) ??
|
|
6
7
|
(attachTargets === "entities-and-read-models"
|
|
@@ -84,8 +85,8 @@ export function registryHasAnonymousUploadField(registry) {
|
|
|
84
85
|
anonymousUploadRegistries.set(registry, found);
|
|
85
86
|
return found;
|
|
86
87
|
}
|
|
87
|
-
// Anonymous
|
|
88
|
-
//
|
|
88
|
+
// Anonymous uploads stay pending (no record, no action form) and only into an opted-in field;
|
|
89
|
+
// the upload response hands the visitor the claim handle that later binds the file.
|
|
89
90
|
export function isAnonymousPendingUploadAllowed(registry, target) {
|
|
90
91
|
if (target.entityId !== undefined || target.actionForm !== undefined)
|
|
91
92
|
return false;
|
|
@@ -94,3 +95,16 @@ export function isAnonymousPendingUploadAllowed(registry, target) {
|
|
|
94
95
|
isFileField(resolution.fieldDef) &&
|
|
95
96
|
resolution.fieldDef.anonymousUpload === true);
|
|
96
97
|
}
|
|
98
|
+
// The anonymous body cap: the largest opted-in field, not the registry-wide largest, so a
|
|
99
|
+
// visitor cannot make the server buffer a body only an authenticated field would accept.
|
|
100
|
+
export function resolveMaxAnonymousUploadBytes(registry, defaultMaxSize) {
|
|
101
|
+
let maxBytes = 0;
|
|
102
|
+
for (const entity of registry?.getAllEntities().values() ?? []) {
|
|
103
|
+
for (const fieldDef of Object.values(entity.fields)) {
|
|
104
|
+
if (isFileField(fieldDef) && fieldDef.anonymousUpload === true) {
|
|
105
|
+
maxBytes = Math.max(maxBytes, parseMaxSize(fieldDef.maxSize ?? defaultMaxSize));
|
|
106
|
+
}
|
|
107
|
+
}
|
|
108
|
+
}
|
|
109
|
+
return maxBytes;
|
|
110
|
+
}
|
|
@@ -43,7 +43,7 @@ export function createFileUploadLedger(db, tenantId, now = () => Temporal.Now.in
|
|
|
43
43
|
};
|
|
44
44
|
}
|
|
45
45
|
export function withUploadLedger(resolver, db, now) {
|
|
46
|
-
return Object.assign(resolver, {
|
|
46
|
+
return Object.assign((tenantId) => resolver(tenantId), {
|
|
47
47
|
uploadLedgerFor: (tenantId) => createFileUploadLedger(db, tenantId, now),
|
|
48
48
|
});
|
|
49
49
|
}
|
|
@@ -0,0 +1,3 @@
|
|
|
1
|
+
import type { ProjectionDetailScreenDefinition, RowAction } from "../engine/types/screen.ts";
|
|
2
|
+
/** i18n references of the banner/steps blocks; `pushKey` filters out literal texts. */
|
|
3
|
+
export declare function pushDetailGuidanceKeys(detail: ProjectionDetailScreenDefinition, pushKey: (value: string | undefined) => void, pushRowActionKeys: (action: RowAction) => void): void;
|
|
@@ -0,0 +1,9 @@
|
|
|
1
|
+
/** i18n references of the banner/steps blocks; `pushKey` filters out literal texts. */
|
|
2
|
+
export function pushDetailGuidanceKeys(detail, pushKey, pushRowActionKeys) {
|
|
3
|
+
pushKey(detail.steps?.title);
|
|
4
|
+
pushKey(detail.steps?.emptyLabel);
|
|
5
|
+
for (const action of detail.banner?.actions ?? [])
|
|
6
|
+
pushRowActionKeys(action);
|
|
7
|
+
for (const action of detail.steps?.actions ?? [])
|
|
8
|
+
pushRowActionKeys(action);
|
|
9
|
+
}
|
|
@@ -1,5 +1,6 @@
|
|
|
1
1
|
import { isExplicitDotFormKey } from "../engine/i18n-key.js";
|
|
2
2
|
import { isExtensionEditSection, isWriteFormEditSection, normalizeListColumn, sectionFieldSpecs, } from "../engine/screen-helpers.js";
|
|
3
|
+
import { pushDetailGuidanceKeys } from "./required-surface-guidance-keys.js";
|
|
3
4
|
/** Pseudo-entity for actionForm field labels (renderer action-form-shim). */
|
|
4
5
|
export const ACTION_FORM_ENTITY = "__action-form__";
|
|
5
6
|
/** Pseudo-entity for configEdit field labels (renderer config-edit-shim). */
|
|
@@ -131,8 +132,13 @@ function pushDashboardPanelKeys(out, panel) {
|
|
|
131
132
|
if (panel.kind === "custom")
|
|
132
133
|
return;
|
|
133
134
|
pushKey(out, panel.label);
|
|
134
|
-
if (panel.kind === "chart" || panel.kind === "stat-group")
|
|
135
|
+
if (panel.kind === "chart" || panel.kind === "stat-group" || panel.kind === "list") {
|
|
135
136
|
pushKey(out, panel.subtitle);
|
|
137
|
+
}
|
|
138
|
+
if (panel.kind === "list")
|
|
139
|
+
pushKey(out, panel.footerLink?.label);
|
|
140
|
+
if (panel.kind === "stat-group")
|
|
141
|
+
pushKey(out, panel.link?.label);
|
|
136
142
|
if (panel.kind === "text")
|
|
137
143
|
pushDashboardTextBlockKeys(out, panel);
|
|
138
144
|
if (panel.kind === "chart") {
|
|
@@ -158,20 +164,24 @@ function pushDashboardChildLabelKeys(out, panel) {
|
|
|
158
164
|
const normalized = normalizeListColumn(col);
|
|
159
165
|
if (normalized.label !== undefined)
|
|
160
166
|
pushKey(out, normalized.label);
|
|
167
|
+
pushKey(out, normalized.hint?.emptyLabel);
|
|
161
168
|
}
|
|
162
169
|
}
|
|
163
170
|
}
|
|
171
|
+
function pushDashboardTextKey(out, text) {
|
|
172
|
+
pushKey(out, typeof text === "string" ? text : text.i18nKey);
|
|
173
|
+
}
|
|
164
174
|
function pushDashboardTextBlockKeys(out, panel) {
|
|
165
|
-
for (const block of panel.blocks) {
|
|
175
|
+
for (const block of [...(panel.blocks ?? []), ...(panel.narrowBlocks ?? [])]) {
|
|
166
176
|
// skip: code is shown verbatim, not translated
|
|
167
177
|
if (block.kind === "code")
|
|
168
178
|
continue;
|
|
169
179
|
if (block.kind === "list") {
|
|
170
180
|
for (const item of block.items)
|
|
171
|
-
|
|
181
|
+
pushDashboardTextKey(out, item);
|
|
172
182
|
}
|
|
173
183
|
else {
|
|
174
|
-
|
|
184
|
+
pushDashboardTextKey(out, block.text);
|
|
175
185
|
}
|
|
176
186
|
}
|
|
177
187
|
}
|
|
@@ -249,6 +259,10 @@ function pushFieldLabelOrOverrideKey(ctx, labelEntity, fieldName, fieldLabels, t
|
|
|
249
259
|
ctx.out.add(fieldLabelKey(ctx.featureName, labelEntity, fieldName));
|
|
250
260
|
}
|
|
251
261
|
function pushListChromeKeys(out, list) {
|
|
262
|
+
for (const col of list.columns)
|
|
263
|
+
pushKey(out, normalizeListColumn(col).hint?.emptyLabel);
|
|
264
|
+
for (const option of list.sortOptions ?? [])
|
|
265
|
+
pushKey(out, option.label);
|
|
252
266
|
pushKey(out, list.createLabel);
|
|
253
267
|
pushKey(out, list.searchPlaceholder);
|
|
254
268
|
pushKey(out, list.description);
|
|
@@ -388,6 +402,7 @@ function pushWriteFormSectionKeys(ctx, section) {
|
|
|
388
402
|
function collectProjectionDetailKeys(ctx, detail) {
|
|
389
403
|
for (const metric of detail.metrics ?? [])
|
|
390
404
|
pushKey(ctx.out, metric.label);
|
|
405
|
+
pushDetailGuidanceKeys(detail, (value) => pushKey(ctx.out, value), (action) => pushRowActionKeys(ctx.out, action));
|
|
391
406
|
for (const section of detail.layout.sections) {
|
|
392
407
|
if (isExtensionEditSection(section)) {
|
|
393
408
|
pushKey(ctx.out, section.title);
|
|
@@ -0,0 +1,29 @@
|
|
|
1
|
+
// @runtime test
|
|
2
|
+
import { bootRuleDocLink } from "../engine/boot-validator/boot-rule.js";
|
|
3
|
+
const RULE_ID_PATTERN = /^[a-z0-9]+(-[a-z0-9]+)*\/[a-z0-9]+(-[a-z0-9]+)*$/;
|
|
4
|
+
function findDuplicates(values) {
|
|
5
|
+
return values.filter((value, index) => values.indexOf(value) !== index);
|
|
6
|
+
}
|
|
7
|
+
export function bootRuleTableViolations(table) {
|
|
8
|
+
const rules = Object.values(table);
|
|
9
|
+
const ids = rules.map((rule) => rule.id);
|
|
10
|
+
const violations = [];
|
|
11
|
+
for (const id of findDuplicates(ids))
|
|
12
|
+
violations.push(`duplicate id: ${id}`);
|
|
13
|
+
for (const id of ids) {
|
|
14
|
+
if (!RULE_ID_PATTERN.test(id))
|
|
15
|
+
violations.push(`id is not <area>/<kebab>: ${id}`);
|
|
16
|
+
if (id.startsWith("unclassified/"))
|
|
17
|
+
violations.push(`id is unclassified: ${id}`);
|
|
18
|
+
}
|
|
19
|
+
for (const anchor of findDuplicates(ids.flatMap((id) => bootRuleDocLink(id) ?? []))) {
|
|
20
|
+
violations.push(`duplicate doc anchor: ${anchor}`);
|
|
21
|
+
}
|
|
22
|
+
for (const rule of rules) {
|
|
23
|
+
if (rule.summary.trim() === "")
|
|
24
|
+
violations.push(`empty summary: ${rule.id}`);
|
|
25
|
+
if (rule.fix.trim() === "")
|
|
26
|
+
violations.push(`empty fix: ${rule.id}`);
|
|
27
|
+
}
|
|
28
|
+
return violations;
|
|
29
|
+
}
|
|
@@ -2,3 +2,4 @@ export { tenantScopedSecrets } from "../api/tenant-scoped-secrets.ts";
|
|
|
2
2
|
export { isRowLevelSecurityViolation } from "../db/pg-error.ts";
|
|
3
3
|
export { DEFAULT_ROW_LEVEL_SECURITY_MODE } from "../db/render-rls-ddl.ts";
|
|
4
4
|
export { appHookScopedRunner, runInRowLevelSecurityScope, runInSystemRowLevelSecurityScope, systemScopedRunner, tenantRowLevelSecurityScope, } from "../db/row-level-security-scope.ts";
|
|
5
|
+
export { systemTenantReadDb, systemTenantReadRunner, systemTenantWriteRunner, } from "../db/system-tenant-read-db.ts";
|
|
@@ -2,3 +2,4 @@ export { tenantScopedSecrets } from "../api/tenant-scoped-secrets.js";
|
|
|
2
2
|
export { isRowLevelSecurityViolation } from "../db/pg-error.js";
|
|
3
3
|
export { DEFAULT_ROW_LEVEL_SECURITY_MODE } from "../db/render-rls-ddl.js";
|
|
4
4
|
export { appHookScopedRunner, runInRowLevelSecurityScope, runInSystemRowLevelSecurityScope, systemScopedRunner, tenantRowLevelSecurityScope, } from "../db/row-level-security-scope.js";
|
|
5
|
+
export { systemTenantReadDb, systemTenantReadRunner, systemTenantWriteRunner, } from "../db/system-tenant-read-db.js";
|
|
@@ -7,6 +7,7 @@ export { resetEventPiiCatalogForTests } from "../crypto/event-pii.ts";
|
|
|
7
7
|
export { resetPiiSubjectKmsForTests } from "../crypto/pii-field-encryption.ts";
|
|
8
8
|
export { resetEntityFieldEncryptionCacheForTests } from "../db/entity-field-encryption.ts";
|
|
9
9
|
export { type ExecutorManagedEntitySource, executorManagedEntitySourceOf, } from "../db/executor-managed-tables.ts";
|
|
10
|
+
export { bootRuleTableViolations } from "./boot-rule-table-expectations.ts";
|
|
10
11
|
export declare function withExecutorManagedWritesForTests(db: TenantDb): ExecutorManagedTenantDb;
|
|
11
12
|
export declare function withExecutorManagedWritesForTests(db: DbRunner): ExecutorManagedRunner;
|
|
12
13
|
export declare function withExecutorManagedWritesForTests(db: AnyDb): ExecutorManagedTenantDb | ExecutorManagedRunner;
|
package/dist/internal/testing.js
CHANGED
|
@@ -5,6 +5,7 @@ export { resetEventPiiCatalogForTests } from "../crypto/event-pii.js";
|
|
|
5
5
|
export { resetPiiSubjectKmsForTests } from "../crypto/pii-field-encryption.js";
|
|
6
6
|
export { resetEntityFieldEncryptionCacheForTests } from "../db/entity-field-encryption.js";
|
|
7
7
|
export { executorManagedEntitySourceOf, } from "../db/executor-managed-tables.js";
|
|
8
|
+
export { bootRuleTableViolations } from "./boot-rule-table-expectations.js";
|
|
8
9
|
export function withExecutorManagedWritesForTests(db) {
|
|
9
10
|
if (isBoundTenantDb(db)) {
|
|
10
11
|
const options = { db: withExecutorManagedWrites(tenantDbRunner(db)), tenantId: db.tenantId };
|
package/dist/jobs/index.d.ts
CHANGED
|
@@ -1,3 +1,4 @@
|
|
|
1
1
|
export type { JobDroppedMeta, JobLogEntry, JobMeta, JobOutcomeMeta, JobQueuedMeta, JobRunner, JobRunnerOptions, } from "./job-runner.ts";
|
|
2
2
|
export { createJobRunner, serializeJobSubject } from "./job-runner.ts";
|
|
3
3
|
export { DEFAULT_MAINTENANCE_WINDOW, MAINTENANCE_WINDOW_ENV, type MaintenanceWindow, maintenanceWindowFromEnv, } from "./maintenance-window.ts";
|
|
4
|
+
export { type ObliterateJobQueuesOptions, obliterateJobQueues } from "./obliterate-job-queues.ts";
|
package/dist/jobs/index.js
CHANGED
|
@@ -0,0 +1,10 @@
|
|
|
1
|
+
import type { TenantDb } from "../db/tenant-db.ts";
|
|
2
|
+
import type { HandlerEvents, Registry } from "../engine/types/index.ts";
|
|
3
|
+
type JobLoadEventsInput = {
|
|
4
|
+
readonly registry: Registry;
|
|
5
|
+
readonly jobDb: TenantDb | undefined;
|
|
6
|
+
readonly tenantId: string;
|
|
7
|
+
readonly jobName: string;
|
|
8
|
+
};
|
|
9
|
+
export declare function createJobLoadEvents(input: JobLoadEventsInput): HandlerEvents["load"];
|
|
10
|
+
export {};
|
|
@@ -0,0 +1,12 @@
|
|
|
1
|
+
import { tenantDbRunner } from "../db/tenant-db-runner.js";
|
|
2
|
+
import { InternalError } from "../errors/index.js";
|
|
3
|
+
import { loadUpcastedAggregate } from "../pipeline/handler-context-events.js";
|
|
4
|
+
export function createJobLoadEvents(input) {
|
|
5
|
+
const { registry, jobDb, tenantId, jobName } = input;
|
|
6
|
+
return async (aggregateId, options) => {
|
|
7
|
+
if (jobDb === undefined) {
|
|
8
|
+
throw new InternalError({ message: `Job ${jobName}: ctx.events.load needs a tenant db` });
|
|
9
|
+
}
|
|
10
|
+
return loadUpcastedAggregate({ db: tenantDbRunner(jobDb), registry, tenantId }, aggregateId, options);
|
|
11
|
+
};
|
|
12
|
+
}
|