@ddd-ts-kit/testing 0.0.0-stage → 0.1.1
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/README.md +549 -2
- package/dist/builders/buildable.d.ts +7 -0
- package/dist/builders/buildable.d.ts.map +1 -0
- package/dist/builders/buildable.js +2 -0
- package/dist/builders/buildable.js.map +1 -0
- package/dist/builders/builder.d.ts +33 -0
- package/dist/builders/builder.d.ts.map +1 -0
- package/dist/builders/builder.js +66 -0
- package/dist/builders/builder.js.map +1 -0
- package/dist/builders/defaults.d.ts +6 -0
- package/dist/builders/defaults.d.ts.map +1 -0
- package/dist/builders/defaults.js +2 -0
- package/dist/builders/defaults.js.map +1 -0
- package/dist/builders/define-builder.d.ts +14 -0
- package/dist/builders/define-builder.d.ts.map +1 -0
- package/dist/builders/define-builder.js +10 -0
- package/dist/builders/define-builder.js.map +1 -0
- package/dist/builders/generic-builder.d.ts +16 -0
- package/dist/builders/generic-builder.d.ts.map +1 -0
- package/dist/builders/generic-builder.js +23 -0
- package/dist/builders/generic-builder.js.map +1 -0
- package/dist/builders/is-resolvable.d.ts +3 -0
- package/dist/builders/is-resolvable.d.ts.map +1 -0
- package/dist/builders/is-resolvable.js +5 -0
- package/dist/builders/is-resolvable.js.map +1 -0
- package/dist/builders/lazy.d.ts +4 -0
- package/dist/builders/lazy.d.ts.map +1 -0
- package/dist/builders/lazy.js +15 -0
- package/dist/builders/lazy.js.map +1 -0
- package/dist/builders/resolvable.d.ts +6 -0
- package/dist/builders/resolvable.d.ts.map +1 -0
- package/dist/builders/resolvable.js +2 -0
- package/dist/builders/resolvable.js.map +1 -0
- package/dist/builders/resolve.d.ts +4 -0
- package/dist/builders/resolve.d.ts.map +1 -0
- package/dist/builders/resolve.js +7 -0
- package/dist/builders/resolve.js.map +1 -0
- package/dist/builders/sequence.d.ts +10 -0
- package/dist/builders/sequence.d.ts.map +1 -0
- package/dist/builders/sequence.js +14 -0
- package/dist/builders/sequence.js.map +1 -0
- package/dist/contracts/awaitable.d.ts +2 -0
- package/dist/contracts/awaitable.d.ts.map +1 -0
- package/dist/contracts/awaitable.js +2 -0
- package/dist/contracts/awaitable.js.map +1 -0
- package/dist/contracts/cache-contract.d.ts +13 -0
- package/dist/contracts/cache-contract.d.ts.map +1 -0
- package/dist/contracts/cache-contract.js +81 -0
- package/dist/contracts/cache-contract.js.map +1 -0
- package/dist/contracts/contract-runner.d.ts +16 -0
- package/dist/contracts/contract-runner.d.ts.map +1 -0
- package/dist/contracts/contract-runner.js +2 -0
- package/dist/contracts/contract-runner.js.map +1 -0
- package/dist/contracts/contract-suite.d.ts +23 -0
- package/dist/contracts/contract-suite.d.ts.map +1 -0
- package/dist/contracts/contract-suite.js +39 -0
- package/dist/contracts/contract-suite.js.map +1 -0
- package/dist/contracts/criteria/criteria-case.d.ts +11 -0
- package/dist/contracts/criteria/criteria-case.d.ts.map +1 -0
- package/dist/contracts/criteria/criteria-case.js +2 -0
- package/dist/contracts/criteria/criteria-case.js.map +1 -0
- package/dist/contracts/criteria/criteria-contract-definition.d.ts +5 -0
- package/dist/contracts/criteria/criteria-contract-definition.d.ts.map +1 -0
- package/dist/contracts/criteria/criteria-contract-definition.js +20 -0
- package/dist/contracts/criteria/criteria-contract-definition.js.map +1 -0
- package/dist/contracts/criteria/criteria-contract-row.d.ts +15 -0
- package/dist/contracts/criteria/criteria-contract-row.d.ts.map +1 -0
- package/dist/contracts/criteria/criteria-contract-row.js +2 -0
- package/dist/contracts/criteria/criteria-contract-row.js.map +1 -0
- package/dist/contracts/criteria/criteria-contract-rows.d.ts +9 -0
- package/dist/contracts/criteria/criteria-contract-rows.d.ts.map +1 -0
- package/dist/contracts/criteria/criteria-contract-rows.js +55 -0
- package/dist/contracts/criteria/criteria-contract-rows.js.map +1 -0
- package/dist/contracts/criteria/group-cases.d.ts +4 -0
- package/dist/contracts/criteria/group-cases.d.ts.map +1 -0
- package/dist/contracts/criteria/group-cases.js +96 -0
- package/dist/contracts/criteria/group-cases.js.map +1 -0
- package/dist/contracts/criteria/operator-cases.d.ts +4 -0
- package/dist/contracts/criteria/operator-cases.d.ts.map +1 -0
- package/dist/contracts/criteria/operator-cases.js +122 -0
- package/dist/contracts/criteria/operator-cases.js.map +1 -0
- package/dist/contracts/criteria/scope-cases.d.ts +4 -0
- package/dist/contracts/criteria/scope-cases.d.ts.map +1 -0
- package/dist/contracts/criteria/scope-cases.js +73 -0
- package/dist/contracts/criteria/scope-cases.js.map +1 -0
- package/dist/contracts/criteria/sort-cases.d.ts +4 -0
- package/dist/contracts/criteria/sort-cases.d.ts.map +1 -0
- package/dist/contracts/criteria/sort-cases.js +54 -0
- package/dist/contracts/criteria/sort-cases.js.map +1 -0
- package/dist/contracts/criteria-contract.d.ts +20 -0
- package/dist/contracts/criteria-contract.d.ts.map +1 -0
- package/dist/contracts/criteria-contract.js +94 -0
- package/dist/contracts/criteria-contract.js.map +1 -0
- package/dist/contracts/event-bus-contract.d.ts +23 -0
- package/dist/contracts/event-bus-contract.d.ts.map +1 -0
- package/dist/contracts/event-bus-contract.js +122 -0
- package/dist/contracts/event-bus-contract.js.map +1 -0
- package/dist/contracts/failure-of.d.ts +3 -0
- package/dist/contracts/failure-of.d.ts.map +1 -0
- package/dist/contracts/failure-of.js +12 -0
- package/dist/contracts/failure-of.js.map +1 -0
- package/dist/contracts/full-envelope.d.ts +4 -0
- package/dist/contracts/full-envelope.d.ts.map +1 -0
- package/dist/contracts/full-envelope.js +12 -0
- package/dist/contracts/full-envelope.js.map +1 -0
- package/dist/contracts/job-scheduler-contract.d.ts +21 -0
- package/dist/contracts/job-scheduler-contract.d.ts.map +1 -0
- package/dist/contracts/job-scheduler-contract.js +181 -0
- package/dist/contracts/job-scheduler-contract.js.map +1 -0
- package/dist/contracts/lock-contract.d.ts +13 -0
- package/dist/contracts/lock-contract.d.ts.map +1 -0
- package/dist/contracts/lock-contract.js +90 -0
- package/dist/contracts/lock-contract.js.map +1 -0
- package/dist/contracts/logger/create-logger.d.ts +6 -0
- package/dist/contracts/logger/create-logger.d.ts.map +1 -0
- package/dist/contracts/logger/create-logger.js +2 -0
- package/dist/contracts/logger/create-logger.js.map +1 -0
- package/dist/contracts/logger/error-outline-of.d.ts +12 -0
- package/dist/contracts/logger/error-outline-of.d.ts.map +1 -0
- package/dist/contracts/logger/error-outline-of.js +27 -0
- package/dist/contracts/logger/error-outline-of.js.map +1 -0
- package/dist/contracts/logger/logged-line.d.ts +9 -0
- package/dist/contracts/logger/logged-line.d.ts.map +1 -0
- package/dist/contracts/logger/logged-line.js +2 -0
- package/dist/contracts/logger/logged-line.js.map +1 -0
- package/dist/contracts/logger/logger-contract-setup.d.ts +11 -0
- package/dist/contracts/logger/logger-contract-setup.d.ts.map +1 -0
- package/dist/contracts/logger/logger-contract-setup.js +2 -0
- package/dist/contracts/logger/logger-contract-setup.js.map +1 -0
- package/dist/contracts/logger/logger-entries-suite.d.ts +19 -0
- package/dist/contracts/logger/logger-entries-suite.d.ts.map +1 -0
- package/dist/contracts/logger/logger-entries-suite.js +177 -0
- package/dist/contracts/logger/logger-entries-suite.js.map +1 -0
- package/dist/contracts/logger/logger-shutdown-suite.d.ts +15 -0
- package/dist/contracts/logger/logger-shutdown-suite.d.ts.map +1 -0
- package/dist/contracts/logger/logger-shutdown-suite.js +98 -0
- package/dist/contracts/logger/logger-shutdown-suite.js.map +1 -0
- package/dist/contracts/logger/logger-under-contract.d.ts +9 -0
- package/dist/contracts/logger/logger-under-contract.d.ts.map +1 -0
- package/dist/contracts/logger/logger-under-contract.js +2 -0
- package/dist/contracts/logger/logger-under-contract.js.map +1 -0
- package/dist/contracts/logger/unreadable-total.d.ts +5 -0
- package/dist/contracts/logger/unreadable-total.d.ts.map +1 -0
- package/dist/contracts/logger/unreadable-total.js +9 -0
- package/dist/contracts/logger/unreadable-total.js.map +1 -0
- package/dist/contracts/logger-contract.d.ts +14 -0
- package/dist/contracts/logger-contract.d.ts.map +1 -0
- package/dist/contracts/logger-contract.js +12 -0
- package/dist/contracts/logger-contract.js.map +1 -0
- package/dist/contracts/outbox-store-contract.d.ts +36 -0
- package/dist/contracts/outbox-store-contract.d.ts.map +1 -0
- package/dist/contracts/outbox-store-contract.js +148 -0
- package/dist/contracts/outbox-store-contract.js.map +1 -0
- package/dist/contracts/processed-event-store-contract.d.ts +11 -0
- package/dist/contracts/processed-event-store-contract.d.ts.map +1 -0
- package/dist/contracts/processed-event-store-contract.js +40 -0
- package/dist/contracts/processed-event-store-contract.js.map +1 -0
- package/dist/contracts/rate-limiter-contract.d.ts +13 -0
- package/dist/contracts/rate-limiter-contract.d.ts.map +1 -0
- package/dist/contracts/rate-limiter-contract.js +86 -0
- package/dist/contracts/rate-limiter-contract.js.map +1 -0
- package/dist/contracts/read-model/everything.d.ts +5 -0
- package/dist/contracts/read-model/everything.d.ts.map +1 -0
- package/dist/contracts/read-model/everything.js +3 -0
- package/dist/contracts/read-model/everything.js.map +1 -0
- package/dist/contracts/read-model/read-model-store-suite.d.ts +14 -0
- package/dist/contracts/read-model/read-model-store-suite.d.ts.map +1 -0
- package/dist/contracts/read-model/read-model-store-suite.js +23 -0
- package/dist/contracts/read-model/read-model-store-suite.js.map +1 -0
- package/dist/contracts/read-model/read-model-store-under-contract.d.ts +11 -0
- package/dist/contracts/read-model/read-model-store-under-contract.d.ts.map +1 -0
- package/dist/contracts/read-model/read-model-store-under-contract.js +2 -0
- package/dist/contracts/read-model/read-model-store-under-contract.js.map +1 -0
- package/dist/contracts/read-model/rebuild-suite.d.ts +14 -0
- package/dist/contracts/read-model/rebuild-suite.d.ts.map +1 -0
- package/dist/contracts/read-model/rebuild-suite.js +116 -0
- package/dist/contracts/read-model/rebuild-suite.js.map +1 -0
- package/dist/contracts/read-model/row-of.d.ts +4 -0
- package/dist/contracts/read-model/row-of.d.ts.map +1 -0
- package/dist/contracts/read-model/row-of.js +10 -0
- package/dist/contracts/read-model/row-of.js.map +1 -0
- package/dist/contracts/read-model/rows-suite.d.ts +11 -0
- package/dist/contracts/read-model/rows-suite.d.ts.map +1 -0
- package/dist/contracts/read-model/rows-suite.js +122 -0
- package/dist/contracts/read-model/rows-suite.js.map +1 -0
- package/dist/contracts/read-model/source-of-truth.d.ts +17 -0
- package/dist/contracts/read-model/source-of-truth.d.ts.map +1 -0
- package/dist/contracts/read-model/source-of-truth.js +36 -0
- package/dist/contracts/read-model/source-of-truth.js.map +1 -0
- package/dist/contracts/read-model/stamped-at.d.ts +4 -0
- package/dist/contracts/read-model/stamped-at.d.ts.map +1 -0
- package/dist/contracts/read-model/stamped-at.js +5 -0
- package/dist/contracts/read-model/stamped-at.js.map +1 -0
- package/dist/contracts/read-model-store-contract.d.ts +15 -0
- package/dist/contracts/read-model-store-contract.d.ts.map +1 -0
- package/dist/contracts/read-model-store-contract.js +13 -0
- package/dist/contracts/read-model-store-contract.js.map +1 -0
- package/dist/contracts/repository-contract.d.ts +18 -0
- package/dist/contracts/repository-contract.d.ts.map +1 -0
- package/dist/contracts/repository-contract.js +103 -0
- package/dist/contracts/repository-contract.js.map +1 -0
- package/dist/contracts/unit-of-work/after-commit-suite.d.ts +12 -0
- package/dist/contracts/unit-of-work/after-commit-suite.d.ts.map +1 -0
- package/dist/contracts/unit-of-work/after-commit-suite.js +79 -0
- package/dist/contracts/unit-of-work/after-commit-suite.js.map +1 -0
- package/dist/contracts/unit-of-work/dispatch-suite.d.ts +14 -0
- package/dist/contracts/unit-of-work/dispatch-suite.d.ts.map +1 -0
- package/dist/contracts/unit-of-work/dispatch-suite.js +171 -0
- package/dist/contracts/unit-of-work/dispatch-suite.js.map +1 -0
- package/dist/contracts/unit-of-work/failure-suite.d.ts +17 -0
- package/dist/contracts/unit-of-work/failure-suite.d.ts.map +1 -0
- package/dist/contracts/unit-of-work/failure-suite.js +114 -0
- package/dist/contracts/unit-of-work/failure-suite.js.map +1 -0
- package/dist/contracts/unit-of-work/parcel.d.ts +11 -0
- package/dist/contracts/unit-of-work/parcel.d.ts.map +1 -0
- package/dist/contracts/unit-of-work/parcel.js +22 -0
- package/dist/contracts/unit-of-work/parcel.js.map +1 -0
- package/dist/contracts/unit-of-work/parcels.d.ts +10 -0
- package/dist/contracts/unit-of-work/parcels.d.ts.map +1 -0
- package/dist/contracts/unit-of-work/parcels.js +14 -0
- package/dist/contracts/unit-of-work/parcels.js.map +1 -0
- package/dist/contracts/unit-of-work/shipping-bench.d.ts +25 -0
- package/dist/contracts/unit-of-work/shipping-bench.d.ts.map +1 -0
- package/dist/contracts/unit-of-work/shipping-bench.js +58 -0
- package/dist/contracts/unit-of-work/shipping-bench.js.map +1 -0
- package/dist/contracts/unit-of-work/unit-of-work-under-contract.d.ts +22 -0
- package/dist/contracts/unit-of-work/unit-of-work-under-contract.d.ts.map +1 -0
- package/dist/contracts/unit-of-work/unit-of-work-under-contract.js +2 -0
- package/dist/contracts/unit-of-work/unit-of-work-under-contract.js.map +1 -0
- package/dist/contracts/unit-of-work-contract.d.ts +19 -0
- package/dist/contracts/unit-of-work-contract.d.ts.map +1 -0
- package/dist/contracts/unit-of-work-contract.js +19 -0
- package/dist/contracts/unit-of-work-contract.js.map +1 -0
- package/dist/contracts.d.ts +27 -0
- package/dist/contracts.d.ts.map +1 -0
- package/dist/contracts.js +17 -0
- package/dist/contracts.js.map +1 -0
- package/dist/coverage/affected-contexts.d.ts +7 -0
- package/dist/coverage/affected-contexts.d.ts.map +1 -0
- package/dist/coverage/affected-contexts.js +15 -0
- package/dist/coverage/affected-contexts.js.map +1 -0
- package/dist/coverage/contexts-in.d.ts +3 -0
- package/dist/coverage/contexts-in.d.ts.map +1 -0
- package/dist/coverage/contexts-in.js +13 -0
- package/dist/coverage/contexts-in.js.map +1 -0
- package/dist/coverage/coverage-layer.d.ts +4 -0
- package/dist/coverage/coverage-layer.d.ts.map +1 -0
- package/dist/coverage/coverage-layer.js +2 -0
- package/dist/coverage/coverage-layer.js.map +1 -0
- package/dist/coverage/coverage-rates.d.ts +8 -0
- package/dist/coverage/coverage-rates.d.ts.map +1 -0
- package/dist/coverage/coverage-rates.js +2 -0
- package/dist/coverage/coverage-rates.js.map +1 -0
- package/dist/coverage/governed-coverage.d.ts +23 -0
- package/dist/coverage/governed-coverage.d.ts.map +1 -0
- package/dist/coverage/governed-coverage.js +27 -0
- package/dist/coverage/governed-coverage.js.map +1 -0
- package/dist/coverage/governed-jest-coverage.d.ts +18 -0
- package/dist/coverage/governed-jest-coverage.d.ts.map +1 -0
- package/dist/coverage/governed-jest-coverage.js +23 -0
- package/dist/coverage/governed-jest-coverage.js.map +1 -0
- package/dist/coverage/governed-settings.d.ts +13 -0
- package/dist/coverage/governed-settings.d.ts.map +1 -0
- package/dist/coverage/governed-settings.js +49 -0
- package/dist/coverage/governed-settings.js.map +1 -0
- package/dist/coverage/held-layers.d.ts +17 -0
- package/dist/coverage/held-layers.d.ts.map +1 -0
- package/dist/coverage/held-layers.js +30 -0
- package/dist/coverage/held-layers.js.map +1 -0
- package/dist/coverage/measured-files.d.ts +4 -0
- package/dist/coverage/measured-files.d.ts.map +1 -0
- package/dist/coverage/measured-files.js +7 -0
- package/dist/coverage/measured-files.js.map +1 -0
- package/dist/coverage/measured-layers.d.ts +8 -0
- package/dist/coverage/measured-layers.d.ts.map +1 -0
- package/dist/coverage/measured-layers.js +14 -0
- package/dist/coverage/measured-layers.js.map +1 -0
- package/dist/coverage/reference-coverage.d.ts +33 -0
- package/dist/coverage/reference-coverage.d.ts.map +1 -0
- package/dist/coverage/reference-coverage.js +13 -0
- package/dist/coverage/reference-coverage.js.map +1 -0
- package/dist/coverage/unaffected-contexts.d.ts +10 -0
- package/dist/coverage/unaffected-contexts.d.ts.map +1 -0
- package/dist/coverage/unaffected-contexts.js +23 -0
- package/dist/coverage/unaffected-contexts.js.map +1 -0
- package/dist/coverage.d.ts +7 -0
- package/dist/coverage.d.ts.map +1 -0
- package/dist/coverage.js +5 -0
- package/dist/coverage.js.map +1 -0
- package/dist/e2e/collect-events.d.ts +9 -0
- package/dist/e2e/collect-events.d.ts.map +1 -0
- package/dist/e2e/collect-events.js +9 -0
- package/dist/e2e/collect-events.js.map +1 -0
- package/dist/e2e/create-http-client.d.ts +4 -0
- package/dist/e2e/create-http-client.d.ts.map +1 -0
- package/dist/e2e/create-http-client.js +7 -0
- package/dist/e2e/create-http-client.js.map +1 -0
- package/dist/e2e/database-reset.d.ts +8 -0
- package/dist/e2e/database-reset.d.ts.map +1 -0
- package/dist/e2e/database-reset.js +2 -0
- package/dist/e2e/database-reset.js.map +1 -0
- package/dist/e2e/event-recorder.d.ts +12 -0
- package/dist/e2e/event-recorder.d.ts.map +1 -0
- package/dist/e2e/event-recorder.js +2 -0
- package/dist/e2e/event-recorder.js.map +1 -0
- package/dist/e2e/event-type.d.ts +5 -0
- package/dist/e2e/event-type.d.ts.map +1 -0
- package/dist/e2e/event-type.js +2 -0
- package/dist/e2e/event-type.js.map +1 -0
- package/dist/e2e/eventually.d.ts +13 -0
- package/dist/e2e/eventually.d.ts.map +1 -0
- package/dist/e2e/eventually.js +27 -0
- package/dist/e2e/eventually.js.map +1 -0
- package/dist/e2e/expect-problem.d.ts +13 -0
- package/dist/e2e/expect-problem.d.ts.map +1 -0
- package/dist/e2e/expect-problem.js +27 -0
- package/dist/e2e/expect-problem.js.map +1 -0
- package/dist/e2e/expect-status.d.ts +7 -0
- package/dist/e2e/expect-status.d.ts.map +1 -0
- package/dist/e2e/expect-status.js +18 -0
- package/dist/e2e/expect-status.js.map +1 -0
- package/dist/e2e/fetch-client.d.ts +18 -0
- package/dist/e2e/fetch-client.d.ts.map +1 -0
- package/dist/e2e/fetch-client.js +56 -0
- package/dist/e2e/fetch-client.js.map +1 -0
- package/dist/e2e/http-client.d.ts +17 -0
- package/dist/e2e/http-client.d.ts.map +1 -0
- package/dist/e2e/http-client.js +2 -0
- package/dist/e2e/http-client.js.map +1 -0
- package/dist/e2e/http-headers.d.ts +2 -0
- package/dist/e2e/http-headers.d.ts.map +1 -0
- package/dist/e2e/http-headers.js +2 -0
- package/dist/e2e/http-headers.js.map +1 -0
- package/dist/e2e/http-response.d.ts +9 -0
- package/dist/e2e/http-response.d.ts.map +1 -0
- package/dist/e2e/http-response.js +2 -0
- package/dist/e2e/http-response.js.map +1 -0
- package/dist/e2e/listen-on-random-port.d.ts +13 -0
- package/dist/e2e/listen-on-random-port.d.ts.map +1 -0
- package/dist/e2e/listen-on-random-port.js +21 -0
- package/dist/e2e/listen-on-random-port.js.map +1 -0
- package/dist/e2e/lower-cased.d.ts +3 -0
- package/dist/e2e/lower-cased.d.ts.map +1 -0
- package/dist/e2e/lower-cased.js +6 -0
- package/dist/e2e/lower-cased.js.map +1 -0
- package/dist/e2e/request-options.d.ts +6 -0
- package/dist/e2e/request-options.d.ts.map +1 -0
- package/dist/e2e/request-options.js +2 -0
- package/dist/e2e/request-options.js.map +1 -0
- package/dist/e2e/running-server.d.ts +6 -0
- package/dist/e2e/running-server.d.ts.map +1 -0
- package/dist/e2e/running-server.js +2 -0
- package/dist/e2e/running-server.js.map +1 -0
- package/dist/e2e/start-test-server.d.ts +18 -0
- package/dist/e2e/start-test-server.d.ts.map +1 -0
- package/dist/e2e/start-test-server.js +14 -0
- package/dist/e2e/start-test-server.js.map +1 -0
- package/dist/e2e/subscribed-recorder.d.ts +17 -0
- package/dist/e2e/subscribed-recorder.d.ts.map +1 -0
- package/dist/e2e/subscribed-recorder.js +45 -0
- package/dist/e2e/subscribed-recorder.js.map +1 -0
- package/dist/e2e/without-trailing-slashes.d.ts +3 -0
- package/dist/e2e/without-trailing-slashes.d.ts.map +1 -0
- package/dist/e2e/without-trailing-slashes.js +9 -0
- package/dist/e2e/without-trailing-slashes.js.map +1 -0
- package/dist/e2e.d.ts +16 -0
- package/dist/e2e.d.ts.map +1 -0
- package/dist/e2e.js +8 -0
- package/dist/e2e.js.map +1 -0
- package/dist/execution/a-session.d.ts +4 -0
- package/dist/execution/a-session.d.ts.map +1 -0
- package/dist/execution/a-session.js +7 -0
- package/dist/execution/a-session.js.map +1 -0
- package/dist/execution/a-test-user.d.ts +4 -0
- package/dist/execution/a-test-user.d.ts.map +1 -0
- package/dist/execution/a-test-user.js +9 -0
- package/dist/execution/a-test-user.js.map +1 -0
- package/dist/execution/an-execution-context.d.ts +4 -0
- package/dist/execution/an-execution-context.d.ts.map +1 -0
- package/dist/execution/an-execution-context.js +7 -0
- package/dist/execution/an-execution-context.js.map +1 -0
- package/dist/execution/execution-context-builder.d.ts +37 -0
- package/dist/execution/execution-context-builder.d.ts.map +1 -0
- package/dist/execution/execution-context-builder.js +67 -0
- package/dist/execution/execution-context-builder.js.map +1 -0
- package/dist/execution/scoped.d.ts +8 -0
- package/dist/execution/scoped.d.ts.map +1 -0
- package/dist/execution/scoped.js +9 -0
- package/dist/execution/scoped.js.map +1 -0
- package/dist/execution/session-builder.d.ts +37 -0
- package/dist/execution/session-builder.d.ts.map +1 -0
- package/dist/execution/session-builder.js +71 -0
- package/dist/execution/session-builder.js.map +1 -0
- package/dist/faker/create-data-generator.d.ts +15 -0
- package/dist/faker/create-data-generator.d.ts.map +1 -0
- package/dist/faker/create-data-generator.js +24 -0
- package/dist/faker/create-data-generator.js.map +1 -0
- package/dist/faker/current-data-generator.d.ts +9 -0
- package/dist/faker/current-data-generator.d.ts.map +1 -0
- package/dist/faker/current-data-generator.js +16 -0
- package/dist/faker/current-data-generator.js.map +1 -0
- package/dist/faker/data-generator.d.ts +9 -0
- package/dist/faker/data-generator.d.ts.map +1 -0
- package/dist/faker/data-generator.js +2 -0
- package/dist/faker/data-generator.js.map +1 -0
- package/dist/faker/generated.d.ts +8 -0
- package/dist/faker/generated.d.ts.map +1 -0
- package/dist/faker/generated.js +10 -0
- package/dist/faker/generated.js.map +1 -0
- package/dist/faker/replay-hint.d.ts +2 -0
- package/dist/faker/replay-hint.d.ts.map +1 -0
- package/dist/faker/replay-hint.js +4 -0
- package/dist/faker/replay-hint.js.map +1 -0
- package/dist/faker/report-seed-on-failure.d.ts +11 -0
- package/dist/faker/report-seed-on-failure.d.ts.map +1 -0
- package/dist/faker/report-seed-on-failure.js +12 -0
- package/dist/faker/report-seed-on-failure.js.map +1 -0
- package/dist/faker.d.ts +7 -0
- package/dist/faker.d.ts.map +1 -0
- package/dist/faker.js +6 -0
- package/dist/faker.js.map +1 -0
- package/dist/harness/create-test-buses.d.ts +49 -0
- package/dist/harness/create-test-buses.d.ts.map +1 -0
- package/dist/harness/create-test-buses.js +35 -0
- package/dist/harness/create-test-buses.js.map +1 -0
- package/dist/index.d.ts +27 -0
- package/dist/index.d.ts.map +1 -0
- package/dist/index.js +19 -0
- package/dist/index.js.map +1 -0
- package/dist/repositories/in-memory-repository.d.ts +30 -0
- package/dist/repositories/in-memory-repository.d.ts.map +1 -0
- package/dist/repositories/in-memory-repository.js +58 -0
- package/dist/repositories/in-memory-repository.js.map +1 -0
- package/dist/repositories/snapshot-codec.d.ts +6 -0
- package/dist/repositories/snapshot-codec.d.ts.map +1 -0
- package/dist/repositories/snapshot-codec.js +2 -0
- package/dist/repositories/snapshot-codec.js.map +1 -0
- package/dist/repositories/snapshots.d.ts +5 -0
- package/dist/repositories/snapshots.d.ts.map +1 -0
- package/dist/repositories/snapshots.js +9 -0
- package/dist/repositories/snapshots.js.map +1 -0
- package/dist/scenarios/act.d.ts +5 -0
- package/dist/scenarios/act.d.ts.map +1 -0
- package/dist/scenarios/act.js +21 -0
- package/dist/scenarios/act.js.map +1 -0
- package/dist/scenarios/async-outcome.d.ts +5 -0
- package/dist/scenarios/async-outcome.d.ts.map +1 -0
- package/dist/scenarios/async-outcome.js +2 -0
- package/dist/scenarios/async-outcome.js.map +1 -0
- package/dist/scenarios/async-scenario.d.ts +5 -0
- package/dist/scenarios/async-scenario.d.ts.map +1 -0
- package/dist/scenarios/async-scenario.js +2 -0
- package/dist/scenarios/async-scenario.js.map +1 -0
- package/dist/scenarios/deferred-outcome.d.ts +18 -0
- package/dist/scenarios/deferred-outcome.d.ts.map +1 -0
- package/dist/scenarios/deferred-outcome.js +34 -0
- package/dist/scenarios/deferred-outcome.js.map +1 -0
- package/dist/scenarios/describe-event.d.ts +3 -0
- package/dist/scenarios/describe-event.d.ts.map +1 -0
- package/dist/scenarios/describe-event.js +6 -0
- package/dist/scenarios/describe-event.js.map +1 -0
- package/dist/scenarios/error-class.d.ts +2 -0
- package/dist/scenarios/error-class.d.ts.map +1 -0
- package/dist/scenarios/error-class.js +2 -0
- package/dist/scenarios/error-class.js.map +1 -0
- package/dist/scenarios/event-matcher.d.ts +11 -0
- package/dist/scenarios/event-matcher.d.ts.map +1 -0
- package/dist/scenarios/event-matcher.js +2 -0
- package/dist/scenarios/event-matcher.js.map +1 -0
- package/dist/scenarios/event-mismatches.d.ts +5 -0
- package/dist/scenarios/event-mismatches.d.ts.map +1 -0
- package/dist/scenarios/event-mismatches.js +33 -0
- package/dist/scenarios/event-mismatches.js.map +1 -0
- package/dist/scenarios/event-source.d.ts +6 -0
- package/dist/scenarios/event-source.d.ts.map +1 -0
- package/dist/scenarios/event-source.js +2 -0
- package/dist/scenarios/event-source.js.map +1 -0
- package/dist/scenarios/given.d.ts +9 -0
- package/dist/scenarios/given.d.ts.map +1 -0
- package/dist/scenarios/given.js +10 -0
- package/dist/scenarios/given.js.map +1 -0
- package/dist/scenarios/immediate-outcome.d.ts +18 -0
- package/dist/scenarios/immediate-outcome.d.ts.map +1 -0
- package/dist/scenarios/immediate-outcome.js +147 -0
- package/dist/scenarios/immediate-outcome.js.map +1 -0
- package/dist/scenarios/is-promise-like.d.ts +2 -0
- package/dist/scenarios/is-promise-like.d.ts.map +1 -0
- package/dist/scenarios/is-promise-like.js +4 -0
- package/dist/scenarios/is-promise-like.js.map +1 -0
- package/dist/scenarios/outcome.d.ts +17 -0
- package/dist/scenarios/outcome.d.ts.map +1 -0
- package/dist/scenarios/outcome.js +2 -0
- package/dist/scenarios/outcome.js.map +1 -0
- package/dist/scenarios/recorded.d.ts +10 -0
- package/dist/scenarios/recorded.d.ts.map +1 -0
- package/dist/scenarios/recorded.js +2 -0
- package/dist/scenarios/recorded.js.map +1 -0
- package/dist/scenarios/scenario.d.ts +18 -0
- package/dist/scenarios/scenario.d.ts.map +1 -0
- package/dist/scenarios/scenario.js +17 -0
- package/dist/scenarios/scenario.js.map +1 -0
- package/dist/scenarios/show.d.ts +3 -0
- package/dist/scenarios/show.d.ts.map +1 -0
- package/dist/scenarios/show.js +6 -0
- package/dist/scenarios/show.js.map +1 -0
- package/dist/secrecy/expect-no-secret.d.ts +9 -0
- package/dist/secrecy/expect-no-secret.d.ts.map +1 -0
- package/dist/secrecy/expect-no-secret.js +55 -0
- package/dist/secrecy/expect-no-secret.js.map +1 -0
- package/dist/vitest/compiler-script.d.ts +3 -0
- package/dist/vitest/compiler-script.d.ts.map +1 -0
- package/dist/vitest/compiler-script.js +18 -0
- package/dist/vitest/compiler-script.js.map +1 -0
- package/dist/vitest/decorator-compiler.d.ts +21 -0
- package/dist/vitest/decorator-compiler.d.ts.map +1 -0
- package/dist/vitest/decorator-compiler.js +112 -0
- package/dist/vitest/decorator-compiler.js.map +1 -0
- package/dist/vitest/decorator-coverage.d.ts +27 -0
- package/dist/vitest/decorator-coverage.d.ts.map +1 -0
- package/dist/vitest/decorator-coverage.js +41 -0
- package/dist/vitest/decorator-coverage.js.map +1 -0
- package/dist/vitest/decorators.d.ts +41 -0
- package/dist/vitest/decorators.d.ts.map +1 -0
- package/dist/vitest/decorators.js +49 -0
- package/dist/vitest/decorators.js.map +1 -0
- package/dist/vitest/is-record.d.ts +2 -0
- package/dist/vitest/is-record.d.ts.map +1 -0
- package/dist/vitest/is-record.js +4 -0
- package/dist/vitest/is-record.js.map +1 -0
- package/dist/vitest/project-options.d.ts +3 -0
- package/dist/vitest/project-options.d.ts.map +1 -0
- package/dist/vitest/project-options.js +2 -0
- package/dist/vitest/project-options.js.map +1 -0
- package/dist/vitest/single-file-project.d.ts +3 -0
- package/dist/vitest/single-file-project.d.ts.map +1 -0
- package/dist/vitest/single-file-project.js +26 -0
- package/dist/vitest/single-file-project.js.map +1 -0
- package/dist/vitest/source-map-of.d.ts +3 -0
- package/dist/vitest/source-map-of.d.ts.map +1 -0
- package/dist/vitest/source-map-of.js +14 -0
- package/dist/vitest/source-map-of.js.map +1 -0
- package/dist/vitest.d.ts +3 -0
- package/dist/vitest.d.ts.map +1 -0
- package/dist/vitest.js +3 -0
- package/dist/vitest.js.map +1 -0
- package/package.json +62 -4
|
@@ -0,0 +1,79 @@
|
|
|
1
|
+
import { SaveAfterCommitError } from '@ddd-ts-kit/kernel';
|
|
2
|
+
import { ContractSuite } from '../contract-suite.js';
|
|
3
|
+
import { Parcel } from './parcel.js';
|
|
4
|
+
import { ShippingBench } from './shipping-bench.js';
|
|
5
|
+
class CacheDown extends Error {
|
|
6
|
+
}
|
|
7
|
+
/** The `after-commit` phase: after the commit, never without it, and never in the way of the caller. */
|
|
8
|
+
export class AfterCommitSuite extends ContractSuite {
|
|
9
|
+
tests() {
|
|
10
|
+
this.afterEach(async () => {
|
|
11
|
+
await this.subject.close?.();
|
|
12
|
+
});
|
|
13
|
+
this.runsOnceCommitted();
|
|
14
|
+
this.isolatesFailures();
|
|
15
|
+
this.refusesToSave();
|
|
16
|
+
}
|
|
17
|
+
runsOnceCommitted() {
|
|
18
|
+
this.it('runs the after-commit handlers once the rows are committed, visible from outside the transaction', async () => {
|
|
19
|
+
const bench = new ShippingBench(this.subject);
|
|
20
|
+
const isolated = this.subject.committedIds !== undefined;
|
|
21
|
+
bench.on('before-commit', async (event) => {
|
|
22
|
+
if (isolated) {
|
|
23
|
+
bench.journal.push(`before ${event.aggregateId}: outside sees ${await this.seenFromOutside()}`);
|
|
24
|
+
}
|
|
25
|
+
});
|
|
26
|
+
bench.on('after-commit', async (event) => {
|
|
27
|
+
bench.journal.push(`after ${event.aggregateId}: outside sees ${await this.seenFromOutside()}`);
|
|
28
|
+
});
|
|
29
|
+
this.expect(await bench.run(async () => (await bench.parcels.save(Parcel.register('p1')), 'answer'))).toBe('answer');
|
|
30
|
+
const before = isolated ? ['before p1: outside sees nothing'] : [];
|
|
31
|
+
this.expect(bench.journal).toEqual([...before, 'after p1: outside sees p1']);
|
|
32
|
+
});
|
|
33
|
+
}
|
|
34
|
+
/** What another connection sees where the subject has one; what the unit of work sees otherwise. */
|
|
35
|
+
async seenFromOutside() {
|
|
36
|
+
const ids = await (this.subject.committedIds?.() ?? this.subject.ids());
|
|
37
|
+
return ids.length === 0 ? 'nothing' : ids.join(',');
|
|
38
|
+
}
|
|
39
|
+
isolatesFailures() {
|
|
40
|
+
this.it('reports the after-commit handler that fails, runs the others and answers the caller', async () => {
|
|
41
|
+
const bench = new ShippingBench(this.subject);
|
|
42
|
+
const failure = new CacheDown();
|
|
43
|
+
bench.on('after-commit', async (event) => {
|
|
44
|
+
if (event.aggregateId === 'p1') {
|
|
45
|
+
throw failure;
|
|
46
|
+
}
|
|
47
|
+
});
|
|
48
|
+
bench.note('after-commit', 'committed');
|
|
49
|
+
this.expect(await bench.run(async () => (await bench.register('p1', 'p2'), 'answer'))).toBe('answer');
|
|
50
|
+
this.expect(bench.journal).toEqual(['saved p1', 'saved p2', 'committed p1', 'committed p2']);
|
|
51
|
+
this.expect(await this.subject.ids()).toEqual(['p1', 'p2']);
|
|
52
|
+
this.expect(bench.reporter.reports.map(({ error, report }) => [error === failure, report.operation])).toEqual([
|
|
53
|
+
[true, `after-commit ${Parcel.REGISTERED}`],
|
|
54
|
+
]);
|
|
55
|
+
this.expect(bench.logger.entries.map(({ level, fields }) => [level, fields['domainEvent'], fields['errorType']])).toEqual([['error', Parcel.REGISTERED, 'CacheDown']]);
|
|
56
|
+
});
|
|
57
|
+
}
|
|
58
|
+
refusesToSave() {
|
|
59
|
+
this.it('refuses the save of an after-commit handler before it writes, and runs the unit of work it opens apart', async () => {
|
|
60
|
+
const bench = new ShippingBench(this.subject);
|
|
61
|
+
bench.on('after-commit', async (event) => {
|
|
62
|
+
if (event.aggregateId === 'p1') {
|
|
63
|
+
await bench.parcels.save(Parcel.register('p2'));
|
|
64
|
+
}
|
|
65
|
+
});
|
|
66
|
+
bench.on('after-commit', async (event) => {
|
|
67
|
+
if (event.aggregateId === 'p1') {
|
|
68
|
+
await bench.run(() => bench.register('p3'));
|
|
69
|
+
}
|
|
70
|
+
});
|
|
71
|
+
bench.note('before-commit', 'handling');
|
|
72
|
+
await bench.run(() => bench.register('p1'));
|
|
73
|
+
this.expect(bench.reporter.reports.map(({ error }) => error instanceof SaveAfterCommitError)).toEqual([true]);
|
|
74
|
+
this.expect(bench.journal).toEqual(['saved p1', 'handling p1', 'saved p3', 'handling p3']);
|
|
75
|
+
this.expect(await this.subject.ids()).toEqual(['p1', 'p3']);
|
|
76
|
+
});
|
|
77
|
+
}
|
|
78
|
+
}
|
|
79
|
+
//# sourceMappingURL=after-commit-suite.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"after-commit-suite.js","sourceRoot":"","sources":["../../../src/contracts/unit-of-work/after-commit-suite.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,14 @@
|
|
|
1
|
+
import { ContractSuite } from '../contract-suite.js';
|
|
2
|
+
import type { UnitOfWorkUnderContract } from './unit-of-work-under-contract.js';
|
|
3
|
+
/** When the domain events of a unit of work reach their handlers. */
|
|
4
|
+
export declare class DispatchSuite extends ContractSuite<UnitOfWorkUnderContract> {
|
|
5
|
+
protected tests(): void;
|
|
6
|
+
private dispatchesAtTheEnd;
|
|
7
|
+
private queuesWhatHandlersRecord;
|
|
8
|
+
private joinsANestedRun;
|
|
9
|
+
private keepsParallelUnitsApart;
|
|
10
|
+
private servesTheCommandBus;
|
|
11
|
+
private registeringBus;
|
|
12
|
+
private dispatchesAtOnceOutside;
|
|
13
|
+
}
|
|
14
|
+
//# sourceMappingURL=dispatch-suite.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"dispatch-suite.d.ts","sourceRoot":"","sources":["../../../src/contracts/unit-of-work/dispatch-suite.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAGrD,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,kCAAkC,CAAC;AAQhF,qEAAqE;AACrE,qBAAa,aAAc,SAAQ,aAAa,CAAC,uBAAuB,CAAC;IACvE,SAAS,CAAC,KAAK,IAAI,IAAI,CAWtB;IAED,OAAO,CAAC,kBAAkB;IAmC1B,OAAO,CAAC,wBAAwB;IA8BhC,OAAO,CAAC,eAAe;IA4BvB,OAAO,CAAC,uBAAuB;IA+B/B,OAAO,CAAC,mBAAmB;IA+B3B,OAAO,CAAC,cAAc;IAetB,OAAO,CAAC,uBAAuB;CAoBhC"}
|
|
@@ -0,0 +1,171 @@
|
|
|
1
|
+
import { AsyncLocalStorage } from 'node:async_hooks';
|
|
2
|
+
import { Command, InMemoryCommandBus, unitOfWorkMiddleware } from '@ddd-ts-kit/kernel';
|
|
3
|
+
import { ContractSuite } from '../contract-suite.js';
|
|
4
|
+
import { Parcel } from './parcel.js';
|
|
5
|
+
import { ShippingBench } from './shipping-bench.js';
|
|
6
|
+
class RegisterParcels extends Command {
|
|
7
|
+
ids;
|
|
8
|
+
constructor(ids) {
|
|
9
|
+
super();
|
|
10
|
+
this.ids = ids;
|
|
11
|
+
}
|
|
12
|
+
}
|
|
13
|
+
/** When the domain events of a unit of work reach their handlers. */
|
|
14
|
+
export class DispatchSuite extends ContractSuite {
|
|
15
|
+
tests() {
|
|
16
|
+
this.afterEach(async () => {
|
|
17
|
+
await this.subject.close?.();
|
|
18
|
+
});
|
|
19
|
+
this.dispatchesAtTheEnd();
|
|
20
|
+
this.queuesWhatHandlersRecord();
|
|
21
|
+
this.joinsANestedRun();
|
|
22
|
+
this.keepsParallelUnitsApart();
|
|
23
|
+
this.servesTheCommandBus();
|
|
24
|
+
this.dispatchesAtOnceOutside();
|
|
25
|
+
}
|
|
26
|
+
dispatchesAtTheEnd() {
|
|
27
|
+
this.it('dispatches nothing before the work returned: every handler sees every save', async () => {
|
|
28
|
+
const bench = new ShippingBench(this.subject);
|
|
29
|
+
bench.on('before-commit', async (event) => {
|
|
30
|
+
bench.journal.push(`${event.aggregateId} sees ${(await this.subject.ids()).join(',')}`);
|
|
31
|
+
});
|
|
32
|
+
await bench.run(() => bench.register('p1', 'p2'));
|
|
33
|
+
this.expect(bench.journal).toEqual(['saved p1', 'saved p2', 'p1 sees p1,p2', 'p2 sees p1,p2']);
|
|
34
|
+
});
|
|
35
|
+
this.it('dispatches in the order of recording across the saves', async () => {
|
|
36
|
+
const bench = new ShippingBench(this.subject);
|
|
37
|
+
const note = async (event) => void bench.journal.push(`${event.name} ${event.aggregateId}`);
|
|
38
|
+
bench.on('before-commit', note);
|
|
39
|
+
bench.on('before-commit', note, Parcel.WEIGHED);
|
|
40
|
+
await bench.run(async () => {
|
|
41
|
+
await bench.parcels.save(Parcel.register('p1').weigh());
|
|
42
|
+
await bench.parcels.save(Parcel.register('p2'));
|
|
43
|
+
});
|
|
44
|
+
this.expect(bench.journal).toEqual([
|
|
45
|
+
`${Parcel.REGISTERED} p1`,
|
|
46
|
+
`${Parcel.WEIGHED} p1`,
|
|
47
|
+
`${Parcel.REGISTERED} p2`,
|
|
48
|
+
]);
|
|
49
|
+
});
|
|
50
|
+
}
|
|
51
|
+
queuesWhatHandlersRecord() {
|
|
52
|
+
this.it('dispatches what a handler saved after the events already waiting, once, in the same transaction', async () => {
|
|
53
|
+
const bench = new ShippingBench(this.subject);
|
|
54
|
+
bench.on('before-commit', async (event) => {
|
|
55
|
+
bench.journal.push(`handling ${event.aggregateId}`);
|
|
56
|
+
if (event.aggregateId === 'p1') {
|
|
57
|
+
await bench.register('p3');
|
|
58
|
+
}
|
|
59
|
+
});
|
|
60
|
+
await bench.run(() => bench.register('p1', 'p2'));
|
|
61
|
+
this.expect(bench.journal).toEqual([
|
|
62
|
+
'saved p1',
|
|
63
|
+
'saved p2',
|
|
64
|
+
'handling p1',
|
|
65
|
+
'saved p3',
|
|
66
|
+
'handling p2',
|
|
67
|
+
'handling p3',
|
|
68
|
+
]);
|
|
69
|
+
this.expect(await this.subject.ids()).toEqual(['p1', 'p2', 'p3']);
|
|
70
|
+
});
|
|
71
|
+
}
|
|
72
|
+
joinsANestedRun() {
|
|
73
|
+
this.it('joins the unit of work in progress on a nested run: one dispatch, at the end of the outermost', async () => {
|
|
74
|
+
const bench = new ShippingBench(this.subject);
|
|
75
|
+
bench.note('before-commit', 'handling');
|
|
76
|
+
bench.note('after-commit', 'committed');
|
|
77
|
+
await bench.run(async () => {
|
|
78
|
+
await bench.run(() => bench.register('p1'));
|
|
79
|
+
bench.journal.push('inner run over');
|
|
80
|
+
await bench.register('p2');
|
|
81
|
+
});
|
|
82
|
+
this.expect(bench.journal).toEqual([
|
|
83
|
+
'saved p1',
|
|
84
|
+
'inner run over',
|
|
85
|
+
'saved p2',
|
|
86
|
+
'handling p1',
|
|
87
|
+
'handling p2',
|
|
88
|
+
'committed p1',
|
|
89
|
+
'committed p2',
|
|
90
|
+
]);
|
|
91
|
+
});
|
|
92
|
+
}
|
|
93
|
+
keepsParallelUnitsApart() {
|
|
94
|
+
this.it('keeps two units of work running side by side apart: each dispatches its own events', async () => {
|
|
95
|
+
const bench = new ShippingBench(this.subject);
|
|
96
|
+
const lane = new AsyncLocalStorage();
|
|
97
|
+
bench.on('before-commit', async (event) => void bench.journal.push(`${lane.getStore() ?? 'none'} dispatches ${event.aggregateId}`));
|
|
98
|
+
const slowThenFast = (name, ms) => async () => {
|
|
99
|
+
await bench.parcels.save(Parcel.register(`${name}1`));
|
|
100
|
+
await pause(ms);
|
|
101
|
+
await bench.parcels.save(Parcel.register(`${name}2`));
|
|
102
|
+
await pause(ms);
|
|
103
|
+
};
|
|
104
|
+
await Promise.all([
|
|
105
|
+
lane.run('a', () => bench.run(slowThenFast('a', 12))),
|
|
106
|
+
lane.run('b', () => bench.run(slowThenFast('b', 3))),
|
|
107
|
+
]);
|
|
108
|
+
this.expect([...bench.journal].sort()).toEqual([
|
|
109
|
+
'a dispatches a1',
|
|
110
|
+
'a dispatches a2',
|
|
111
|
+
'b dispatches b1',
|
|
112
|
+
'b dispatches b2',
|
|
113
|
+
]);
|
|
114
|
+
});
|
|
115
|
+
}
|
|
116
|
+
servesTheCommandBus() {
|
|
117
|
+
this.it('dispatches once the command handler returned, and queues behind them what a command sent by a handler saved', async () => {
|
|
118
|
+
const bench = new ShippingBench(this.subject);
|
|
119
|
+
const bus = this.registeringBus(bench);
|
|
120
|
+
bench.on('before-commit', async (event) => {
|
|
121
|
+
bench.journal.push(`handling ${event.aggregateId}`);
|
|
122
|
+
if (event.aggregateId === 'p1') {
|
|
123
|
+
await bus.execute(new RegisterParcels(['p3']));
|
|
124
|
+
}
|
|
125
|
+
});
|
|
126
|
+
await bus.execute(new RegisterParcels(['p1', 'p2']));
|
|
127
|
+
this.expect(bench.journal).toEqual([
|
|
128
|
+
'saved p1',
|
|
129
|
+
'saved p2',
|
|
130
|
+
'handler over',
|
|
131
|
+
'handling p1',
|
|
132
|
+
'saved p3',
|
|
133
|
+
'handler over',
|
|
134
|
+
'handling p2',
|
|
135
|
+
'handling p3',
|
|
136
|
+
]);
|
|
137
|
+
});
|
|
138
|
+
}
|
|
139
|
+
registeringBus(bench) {
|
|
140
|
+
const bus = new InMemoryCommandBus().use(unitOfWorkMiddleware(this.subject.unitOfWork));
|
|
141
|
+
bus.register(RegisterParcels, {
|
|
142
|
+
execute: async ({ ids }) => {
|
|
143
|
+
await bench.register(...ids);
|
|
144
|
+
bench.journal.push('handler over');
|
|
145
|
+
return undefined;
|
|
146
|
+
},
|
|
147
|
+
});
|
|
148
|
+
return bus;
|
|
149
|
+
}
|
|
150
|
+
dispatchesAtOnceOutside() {
|
|
151
|
+
this.it('dispatches with the save outside of any unit of work: both phases, before the save resolves', async () => {
|
|
152
|
+
const bench = new ShippingBench(this.subject);
|
|
153
|
+
bench.note('before-commit', 'handling');
|
|
154
|
+
bench.note('after-commit', 'committed');
|
|
155
|
+
await bench.register('p1');
|
|
156
|
+
await bench.register('p2');
|
|
157
|
+
this.expect(bench.journal).toEqual([
|
|
158
|
+
'handling p1',
|
|
159
|
+
'committed p1',
|
|
160
|
+
'saved p1',
|
|
161
|
+
'handling p2',
|
|
162
|
+
'committed p2',
|
|
163
|
+
'saved p2',
|
|
164
|
+
]);
|
|
165
|
+
});
|
|
166
|
+
}
|
|
167
|
+
}
|
|
168
|
+
function pause(ms) {
|
|
169
|
+
return new Promise((resolve) => setTimeout(resolve, ms));
|
|
170
|
+
}
|
|
171
|
+
//# sourceMappingURL=dispatch-suite.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"dispatch-suite.js","sourceRoot":"","sources":["../../../src/contracts/unit-of-work/dispatch-suite.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,17 @@
|
|
|
1
|
+
import { ContractSuite } from '../contract-suite.js';
|
|
2
|
+
import type { UnitOfWorkUnderContract } from './unit-of-work-under-contract.js';
|
|
3
|
+
/**
|
|
4
|
+
* No effect of a domain event survives a persistence failure, wherever the failure happens:
|
|
5
|
+
* in the save, in a later save, in the work, in a handler or in the commit itself.
|
|
6
|
+
*/
|
|
7
|
+
export declare class FailureSuite extends ContractSuite<UnitOfWorkUnderContract> {
|
|
8
|
+
protected tests(): void;
|
|
9
|
+
private refusedSave;
|
|
10
|
+
private everyEffect;
|
|
11
|
+
private expectNothingLeft;
|
|
12
|
+
private failingWork;
|
|
13
|
+
private failingHandler;
|
|
14
|
+
private failingCommit;
|
|
15
|
+
private relaysWhatCommitted;
|
|
16
|
+
}
|
|
17
|
+
//# sourceMappingURL=failure-suite.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"failure-suite.d.ts","sourceRoot":"","sources":["../../../src/contracts/unit-of-work/failure-suite.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAIrD,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,kCAAkC,CAAC;AAIhF;;;GAGG;AACH,qBAAa,YAAa,SAAQ,aAAa,CAAC,uBAAuB,CAAC;IACtE,SAAS,CAAC,KAAK,IAAI,IAAI,CAUtB;IAED,OAAO,CAAC,WAAW;IA+BnB,OAAO,CAAC,WAAW;YASL,iBAAiB;IAO/B,OAAO,CAAC,WAAW;IAmCnB,OAAO,CAAC,cAAc;IAoBtB,OAAO,CAAC,aAAa;IAmBrB,OAAO,CAAC,mBAAmB;CAqB5B"}
|
|
@@ -0,0 +1,114 @@
|
|
|
1
|
+
import { ContractSuite } from '../contract-suite.js';
|
|
2
|
+
import { failureOf } from '../failure-of.js';
|
|
3
|
+
import { Parcel } from './parcel.js';
|
|
4
|
+
import { ShippingBench } from './shipping-bench.js';
|
|
5
|
+
class CarrierDown extends Error {
|
|
6
|
+
}
|
|
7
|
+
/**
|
|
8
|
+
* No effect of a domain event survives a persistence failure, wherever the failure happens:
|
|
9
|
+
* in the save, in a later save, in the work, in a handler or in the commit itself.
|
|
10
|
+
*/
|
|
11
|
+
export class FailureSuite extends ContractSuite {
|
|
12
|
+
tests() {
|
|
13
|
+
this.afterEach(async () => {
|
|
14
|
+
await this.subject.close?.();
|
|
15
|
+
});
|
|
16
|
+
this.refusedSave();
|
|
17
|
+
this.failingWork();
|
|
18
|
+
this.failingHandler();
|
|
19
|
+
this.failingCommit();
|
|
20
|
+
this.relaysWhatCommitted();
|
|
21
|
+
}
|
|
22
|
+
refusedSave() {
|
|
23
|
+
this.it('hands no event over for a save the database refused, in a unit of work or outside: they stay on the aggregate', async () => {
|
|
24
|
+
const bench = this.everyEffect();
|
|
25
|
+
const inside = Parcel.register('p1');
|
|
26
|
+
const outside = Parcel.register('p1');
|
|
27
|
+
await this.subject.insert('p1');
|
|
28
|
+
this.expect((await failureOf(() => bench.run(() => bench.parcels.save(inside)))) === undefined).toBe(false);
|
|
29
|
+
this.expect((await failureOf(() => bench.parcels.save(outside))) === undefined).toBe(false);
|
|
30
|
+
this.expect(bench.journal).toEqual([]);
|
|
31
|
+
this.expect([inside.pullEvents().length, outside.pullEvents().length]).toEqual([1, 1]);
|
|
32
|
+
this.expect(await bench.pending()).toBe(0);
|
|
33
|
+
});
|
|
34
|
+
this.it('runs no handler of the earlier saves when a later save is refused: nothing stored, nothing in the outbox', async () => {
|
|
35
|
+
const bench = this.everyEffect();
|
|
36
|
+
const failure = await failureOf(() => bench.run(() => bench.register('p1', 'p2', 'p1')));
|
|
37
|
+
this.expect(failure === undefined).toBe(false);
|
|
38
|
+
await this.expectNothingLeft(bench, ['saved p1', 'saved p2']);
|
|
39
|
+
});
|
|
40
|
+
}
|
|
41
|
+
everyEffect() {
|
|
42
|
+
const bench = new ShippingBench(this.subject);
|
|
43
|
+
bench.publish();
|
|
44
|
+
bench.note('after-commit', 'committed');
|
|
45
|
+
return bench;
|
|
46
|
+
}
|
|
47
|
+
async expectNothingLeft(bench, journal) {
|
|
48
|
+
this.expect(bench.journal).toEqual(journal);
|
|
49
|
+
this.expect(await this.subject.ids()).toEqual([]);
|
|
50
|
+
this.expect(await bench.pending()).toBe(0);
|
|
51
|
+
this.expect(await bench.relayed()).toEqual([]);
|
|
52
|
+
}
|
|
53
|
+
failingWork() {
|
|
54
|
+
this.it('runs no handler when the work fails after a save: nothing stored, nothing in the outbox', async () => {
|
|
55
|
+
const bench = this.everyEffect();
|
|
56
|
+
const failure = await failureOf(() => bench.run(async () => {
|
|
57
|
+
await bench.register('p1');
|
|
58
|
+
throw new CarrierDown();
|
|
59
|
+
}));
|
|
60
|
+
this.expect(failure instanceof CarrierDown).toBe(true);
|
|
61
|
+
await this.expectNothingLeft(bench, ['saved p1']);
|
|
62
|
+
});
|
|
63
|
+
this.it('drops the events of a rolled back unit of work: the retry dispatches what it records, once', async () => {
|
|
64
|
+
const bench = this.everyEffect();
|
|
65
|
+
const first = Parcel.register('p1');
|
|
66
|
+
await failureOf(() => bench.run(async () => {
|
|
67
|
+
await bench.parcels.save(first);
|
|
68
|
+
throw new CarrierDown();
|
|
69
|
+
}));
|
|
70
|
+
this.expect(first.pullEvents()).toEqual([]);
|
|
71
|
+
await bench.run(() => bench.register('p1'));
|
|
72
|
+
this.expect(bench.journal).toEqual(['saved p1', 'published p1', 'committed p1']);
|
|
73
|
+
this.expect(await bench.relayed()).toEqual(['evt-p1']);
|
|
74
|
+
});
|
|
75
|
+
}
|
|
76
|
+
failingHandler() {
|
|
77
|
+
this.it('fails the unit of work when a before-commit handler fails: state and outbox rolled back, no after-commit handler', async () => {
|
|
78
|
+
const bench = this.everyEffect();
|
|
79
|
+
bench.on('before-commit', async (event) => {
|
|
80
|
+
if (event.aggregateId === 'p2') {
|
|
81
|
+
throw new CarrierDown();
|
|
82
|
+
}
|
|
83
|
+
});
|
|
84
|
+
const failure = await failureOf(() => bench.run(() => bench.register('p1', 'p2')));
|
|
85
|
+
this.expect(failure instanceof CarrierDown).toBe(true);
|
|
86
|
+
await this.expectNothingLeft(bench, ['saved p1', 'saved p2', 'published p1', 'published p2']);
|
|
87
|
+
});
|
|
88
|
+
}
|
|
89
|
+
failingCommit() {
|
|
90
|
+
this.it('rolls back what the before-commit handlers wrote when the commit itself fails, and runs no after-commit handler', async () => {
|
|
91
|
+
const bench = this.everyEffect();
|
|
92
|
+
const failure = await failureOf(() => bench.run(async () => {
|
|
93
|
+
await bench.register('p1');
|
|
94
|
+
await this.subject.insertRefusedAtCommit('p2');
|
|
95
|
+
}));
|
|
96
|
+
this.expect(failure === undefined).toBe(false);
|
|
97
|
+
await this.expectNothingLeft(bench, ['saved p1', 'published p1']);
|
|
98
|
+
});
|
|
99
|
+
}
|
|
100
|
+
relaysWhatCommitted() {
|
|
101
|
+
this.it('leaves in the outbox what the committed unit of work published for each save, and nothing of the one rolled back', async () => {
|
|
102
|
+
const bench = this.everyEffect();
|
|
103
|
+
await bench.run(() => bench.register('p1', 'p2'));
|
|
104
|
+
await failureOf(() => bench.run(async () => {
|
|
105
|
+
await bench.register('p3');
|
|
106
|
+
throw new CarrierDown();
|
|
107
|
+
}));
|
|
108
|
+
this.expect(await this.subject.ids()).toEqual(['p1', 'p2']);
|
|
109
|
+
this.expect(await bench.pending()).toBe(2);
|
|
110
|
+
this.expect(await bench.relayed()).toEqual(['evt-p1', 'evt-p2']);
|
|
111
|
+
});
|
|
112
|
+
}
|
|
113
|
+
}
|
|
114
|
+
//# sourceMappingURL=failure-suite.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"failure-suite.js","sourceRoot":"","sources":["../../../src/contracts/unit-of-work/failure-suite.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,11 @@
|
|
|
1
|
+
import { AggregateRoot } from '@ddd-ts-kit/kernel';
|
|
2
|
+
/** The aggregate of the contract: one event recorded per intention. */
|
|
3
|
+
export declare class Parcel extends AggregateRoot {
|
|
4
|
+
static readonly REGISTERED = "shipping.parcel.registered";
|
|
5
|
+
static readonly WEIGHED = "shipping.parcel.weighed";
|
|
6
|
+
private constructor();
|
|
7
|
+
static register(id: string): Parcel;
|
|
8
|
+
weigh(): this;
|
|
9
|
+
private note;
|
|
10
|
+
}
|
|
11
|
+
//# sourceMappingURL=parcel.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"parcel.d.ts","sourceRoot":"","sources":["../../../src/contracts/unit-of-work/parcel.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAEnD,uEAAuE;AACvE,qBAAa,MAAO,SAAQ,aAAa;IACvC,MAAM,CAAC,QAAQ,CAAC,UAAU,gCAAgC;IAE1D,MAAM,CAAC,QAAQ,CAAC,OAAO,6BAA6B;IAEpD,OAAO,eAEN;IAED,MAAM,CAAC,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAMlC;IAED,KAAK,IAAI,IAAI,CAIZ;IAED,OAAO,CAAC,IAAI;CAGb"}
|
|
@@ -0,0 +1,22 @@
|
|
|
1
|
+
import { AggregateRoot } from '@ddd-ts-kit/kernel';
|
|
2
|
+
/** The aggregate of the contract: one event recorded per intention. */
|
|
3
|
+
export class Parcel extends AggregateRoot {
|
|
4
|
+
static REGISTERED = 'shipping.parcel.registered';
|
|
5
|
+
static WEIGHED = 'shipping.parcel.weighed';
|
|
6
|
+
constructor(id) {
|
|
7
|
+
super(id);
|
|
8
|
+
}
|
|
9
|
+
static register(id) {
|
|
10
|
+
const parcel = new Parcel(id);
|
|
11
|
+
parcel.note(Parcel.REGISTERED);
|
|
12
|
+
return parcel;
|
|
13
|
+
}
|
|
14
|
+
weigh() {
|
|
15
|
+
this.note(Parcel.WEIGHED);
|
|
16
|
+
return this;
|
|
17
|
+
}
|
|
18
|
+
note(name) {
|
|
19
|
+
this.record({ name, aggregateId: this.id, occurredAt: new Date(0) });
|
|
20
|
+
}
|
|
21
|
+
}
|
|
22
|
+
//# sourceMappingURL=parcel.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"parcel.js","sourceRoot":"","sources":["../../../src/contracts/unit-of-work/parcel.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAEnD,uEAAuE;AACvE,MAAM,OAAO,MAAO,SAAQ,aAAa;IACvC,MAAM,CAAU,UAAU,GAAG,4BAA4B,CAAC;IAE1D,MAAM,CAAU,OAAO,GAAG,yBAAyB,CAAC;IAEpD,YAAoB,EAAU;QAC5B,KAAK,CAAC,EAAE,CAAC,CAAC;IACZ,CAAC;IAED,MAAM,CAAC,QAAQ,CAAC,EAAU;QACxB,MAAM,MAAM,GAAG,IAAI,MAAM,CAAC,EAAE,CAAC,CAAC;QAE9B,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;QAE/B,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,KAAK;QACH,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QAE1B,OAAO,IAAI,CAAC;IACd,CAAC;IAEO,IAAI,CAAC,IAAY;QACvB,IAAI,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,CAAC,EAAE,EAAE,UAAU,EAAE,IAAI,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;IACvE,CAAC;CACF"}
|
|
@@ -0,0 +1,10 @@
|
|
|
1
|
+
import type { Parcel } from './parcel.js';
|
|
2
|
+
import type { UnitOfWorkUnderContract } from './unit-of-work-under-contract.js';
|
|
3
|
+
/** A repository adapter over the table of the subject: it persists, and knows nothing of events. */
|
|
4
|
+
export declare class Parcels {
|
|
5
|
+
private readonly subject;
|
|
6
|
+
constructor(subject: Pick<UnitOfWorkUnderContract, 'insert' | 'ids'>);
|
|
7
|
+
save(parcel: Parcel): Promise<void>;
|
|
8
|
+
exists(id: string): Promise<boolean>;
|
|
9
|
+
}
|
|
10
|
+
//# sourceMappingURL=parcels.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"parcels.d.ts","sourceRoot":"","sources":["../../../src/contracts/unit-of-work/parcels.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,kCAAkC,CAAC;AAEhF,oGAAoG;AACpG,qBAAa,OAAO;IACN,OAAO,CAAC,QAAQ,CAAC,OAAO;IAApC,YAA6B,OAAO,EAAE,IAAI,CAAC,uBAAuB,EAAE,QAAQ,GAAG,KAAK,CAAC,EAAI;IAEnF,IAAI,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAExC;IAEK,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAEzC;CACF"}
|
|
@@ -0,0 +1,14 @@
|
|
|
1
|
+
/** A repository adapter over the table of the subject: it persists, and knows nothing of events. */
|
|
2
|
+
export class Parcels {
|
|
3
|
+
subject;
|
|
4
|
+
constructor(subject) {
|
|
5
|
+
this.subject = subject;
|
|
6
|
+
}
|
|
7
|
+
async save(parcel) {
|
|
8
|
+
await this.subject.insert(parcel.id);
|
|
9
|
+
}
|
|
10
|
+
async exists(id) {
|
|
11
|
+
return (await this.subject.ids()).includes(id);
|
|
12
|
+
}
|
|
13
|
+
}
|
|
14
|
+
//# sourceMappingURL=parcels.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"parcels.js","sourceRoot":"","sources":["../../../src/contracts/unit-of-work/parcels.ts"],"names":[],"mappings":"AAGA,oGAAoG;AACpG,MAAM,OAAO,OAAO;IACW,OAAO;IAApC,YAA6B,OAAwD;uBAAxD,OAAO;IAAoD,CAAC;IAEzF,KAAK,CAAC,IAAI,CAAC,MAAc;QACvB,MAAM,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IACvC,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,EAAU;QACrB,OAAO,CAAC,MAAM,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;IACjD,CAAC;CACF"}
|
|
@@ -0,0 +1,25 @@
|
|
|
1
|
+
import { InMemoryDomainEventDispatcher, InMemoryErrorReporter, InMemoryLogger, type DomainEventCallback, type DomainEventPhase } from '@ddd-ts-kit/kernel';
|
|
2
|
+
import { Parcels } from './parcels.js';
|
|
3
|
+
import type { UnitOfWorkUnderContract } from './unit-of-work-under-contract.js';
|
|
4
|
+
/** The wiring of a composition root around the subject, with a journal of what happened, in order. */
|
|
5
|
+
export declare class ShippingBench {
|
|
6
|
+
readonly subject: UnitOfWorkUnderContract;
|
|
7
|
+
readonly journal: string[];
|
|
8
|
+
readonly reporter: InMemoryErrorReporter;
|
|
9
|
+
readonly logger: InMemoryLogger;
|
|
10
|
+
readonly dispatcher: InMemoryDomainEventDispatcher;
|
|
11
|
+
readonly parcels: Parcels;
|
|
12
|
+
constructor(subject: UnitOfWorkUnderContract);
|
|
13
|
+
run<T>(work: () => Promise<T>): Promise<T>;
|
|
14
|
+
/** Saves a new parcel under each id, one save after the other, noting each save. */
|
|
15
|
+
register(...ids: string[]): Promise<void>;
|
|
16
|
+
on(phase: DomainEventPhase, handler: DomainEventCallback, name?: string): void;
|
|
17
|
+
/** Notes `<label> <id>` for every registered parcel, in that phase. */
|
|
18
|
+
note(phase: DomainEventPhase, label: string): void;
|
|
19
|
+
/** The publisher of the context: before the commit, one integration event per registered parcel, to the outbox. */
|
|
20
|
+
publish(): void;
|
|
21
|
+
/** The ids of the events a relay would publish now, oldest first. */
|
|
22
|
+
relayed(): Promise<string[]>;
|
|
23
|
+
pending(): Promise<number>;
|
|
24
|
+
}
|
|
25
|
+
//# sourceMappingURL=shipping-bench.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"shipping-bench.d.ts","sourceRoot":"","sources":["../../../src/contracts/unit-of-work/shipping-bench.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,6BAA6B,EAC7B,qBAAqB,EACrB,cAAc,EAId,KAAK,mBAAmB,EACxB,KAAK,gBAAgB,EACtB,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,kCAAkC,CAAC;AAIhF,sGAAsG;AACtG,qBAAa,aAAa;IAaZ,QAAQ,CAAC,OAAO,EAAE,uBAAuB;IAZrD,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,CAAM;IAEhC,QAAQ,CAAC,QAAQ,wBAA+B;IAEhD,QAAQ,CAAC,MAAM,iBAAwB;IAEvC,QAAQ,CAAC,UAAU,gCAEjB;IAEF,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAE1B,YAAqB,OAAO,EAAE,uBAAuB,EAEpD;IAED,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAEzC;IAED,oFAAoF;IAC9E,QAAQ,CAAC,GAAG,GAAG,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAK9C;IAED,EAAE,CAAC,KAAK,EAAE,gBAAgB,EAAE,OAAO,EAAE,mBAAmB,EAAE,IAAI,GAAE,MAA0B,GAAG,IAAI,CAEhG;IAED,uEAAuE;IACvE,IAAI,CAAC,KAAK,EAAE,gBAAgB,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAEjD;IAED,mHAAmH;IACnH,OAAO,IAAI,IAAI,CAKd;IAED,qEAAqE;IAC/D,OAAO,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC,CAEjC;IAEK,OAAO,IAAI,OAAO,CAAC,MAAM,CAAC,CAE/B;CACF"}
|
|
@@ -0,0 +1,58 @@
|
|
|
1
|
+
import { InMemoryDomainEventDispatcher, InMemoryErrorReporter, InMemoryLogger, dispatchingOnSave, reportAfterCommitFailures, } from '@ddd-ts-kit/kernel';
|
|
2
|
+
import { Parcel } from './parcel.js';
|
|
3
|
+
import { Parcels } from './parcels.js';
|
|
4
|
+
const LATER = new Date('2100-01-01T00:00:00.000Z');
|
|
5
|
+
/** The wiring of a composition root around the subject, with a journal of what happened, in order. */
|
|
6
|
+
export class ShippingBench {
|
|
7
|
+
subject;
|
|
8
|
+
journal = [];
|
|
9
|
+
reporter = new InMemoryErrorReporter();
|
|
10
|
+
logger = new InMemoryLogger();
|
|
11
|
+
dispatcher = new InMemoryDomainEventDispatcher(reportAfterCommitFailures({ reporter: this.reporter, logger: this.logger }));
|
|
12
|
+
parcels;
|
|
13
|
+
constructor(subject) {
|
|
14
|
+
this.subject = subject;
|
|
15
|
+
this.parcels = dispatchingOnSave(new Parcels(subject), () => this.dispatcher);
|
|
16
|
+
}
|
|
17
|
+
run(work) {
|
|
18
|
+
return this.subject.unitOfWork.run(work);
|
|
19
|
+
}
|
|
20
|
+
/** Saves a new parcel under each id, one save after the other, noting each save. */
|
|
21
|
+
async register(...ids) {
|
|
22
|
+
for (const id of ids) {
|
|
23
|
+
await this.parcels.save(Parcel.register(id));
|
|
24
|
+
this.journal.push(`saved ${id}`);
|
|
25
|
+
}
|
|
26
|
+
}
|
|
27
|
+
on(phase, handler, name = Parcel.REGISTERED) {
|
|
28
|
+
this.dispatcher.on(name, handler, { phase });
|
|
29
|
+
}
|
|
30
|
+
/** Notes `<label> <id>` for every registered parcel, in that phase. */
|
|
31
|
+
note(phase, label) {
|
|
32
|
+
this.on(phase, async (event) => void this.journal.push(`${label} ${event.aggregateId}`));
|
|
33
|
+
}
|
|
34
|
+
/** The publisher of the context: before the commit, one integration event per registered parcel, to the outbox. */
|
|
35
|
+
publish() {
|
|
36
|
+
this.on('before-commit', async (event) => {
|
|
37
|
+
await this.subject.outbox.append([published(event)]);
|
|
38
|
+
this.journal.push(`published ${event.aggregateId}`);
|
|
39
|
+
});
|
|
40
|
+
}
|
|
41
|
+
/** The ids of the events a relay would publish now, oldest first. */
|
|
42
|
+
async relayed() {
|
|
43
|
+
return (await this.subject.outbox.claimBatch(100, LATER)).map((record) => record.event.id);
|
|
44
|
+
}
|
|
45
|
+
async pending() {
|
|
46
|
+
return (await this.subject.outbox.stats()).pending;
|
|
47
|
+
}
|
|
48
|
+
}
|
|
49
|
+
function published(event) {
|
|
50
|
+
return {
|
|
51
|
+
id: `evt-${event.aggregateId}`,
|
|
52
|
+
type: event.name,
|
|
53
|
+
version: 1,
|
|
54
|
+
occurredAt: event.occurredAt.toISOString(),
|
|
55
|
+
payload: { parcelId: event.aggregateId },
|
|
56
|
+
};
|
|
57
|
+
}
|
|
58
|
+
//# sourceMappingURL=shipping-bench.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"shipping-bench.js","sourceRoot":"","sources":["../../../src/contracts/unit-of-work/shipping-bench.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,6BAA6B,EAC7B,qBAAqB,EACrB,cAAc,EACd,iBAAiB,EACjB,yBAAyB,GAI1B,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAGvC,MAAM,KAAK,GAAG,IAAI,IAAI,CAAC,0BAA0B,CAAC,CAAC;AAEnD,sGAAsG;AACtG,MAAM,OAAO,aAAa;IAaH,OAAO;IAZnB,OAAO,GAAa,EAAE,CAAC;IAEvB,QAAQ,GAAG,IAAI,qBAAqB,EAAE,CAAC;IAEvC,MAAM,GAAG,IAAI,cAAc,EAAE,CAAC;IAE9B,UAAU,GAAG,IAAI,6BAA6B,CACrD,yBAAyB,CAAC,EAAE,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC,CAC5E,CAAC;IAEO,OAAO,CAAU;IAE1B,YAAqB,OAAgC;uBAAhC,OAAO;QAC1B,IAAI,CAAC,OAAO,GAAG,iBAAiB,CAAC,IAAI,OAAO,CAAC,OAAO,CAAC,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IAChF,CAAC;IAED,GAAG,CAAI,IAAsB;QAC3B,OAAO,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAC3C,CAAC;IAED,oFAAoF;IACpF,KAAK,CAAC,QAAQ,CAAC,GAAG,GAAa;QAC7B,KAAK,MAAM,EAAE,IAAI,GAAG,EAAE,CAAC;YACrB,MAAM,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,CAAC;YAC7C,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC;QACnC,CAAC;IACH,CAAC;IAED,EAAE,CAAC,KAAuB,EAAE,OAA4B,EAAE,IAAI,GAAW,MAAM,CAAC,UAAU;QACxF,IAAI,CAAC,UAAU,CAAC,EAAE,CAAC,IAAI,EAAE,OAAO,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;IAC/C,CAAC;IAED,uEAAuE;IACvE,IAAI,CAAC,KAAuB,EAAE,KAAa;QACzC,IAAI,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE,CAAC,KAAK,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,KAAK,IAAI,KAAK,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC;IAC3F,CAAC;IAED,mHAAmH;IACnH,OAAO;QACL,IAAI,CAAC,EAAE,CAAC,eAAe,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE;YACvC,MAAM,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;YACrD,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,aAAa,KAAK,CAAC,WAAW,EAAE,CAAC,CAAC;QACtD,CAAC,CAAC,CAAC;IACL,CAAC;IAED,qEAAqE;IACrE,KAAK,CAAC,OAAO;QACX,OAAO,CAAC,MAAM,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,UAAU,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IAC7F,CAAC;IAED,KAAK,CAAC,OAAO;QACX,OAAO,CAAC,MAAM,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC,OAAO,CAAC;IACrD,CAAC;CACF;AAED,SAAS,SAAS,CAAC,KAAkB;IAOnC,OAAO;QACL,EAAE,EAAE,OAAO,KAAK,CAAC,WAAW,EAAE;QAC9B,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,OAAO,EAAE,CAAC;QACV,UAAU,EAAE,KAAK,CAAC,UAAU,CAAC,WAAW,EAAE;QAC1C,OAAO,EAAE,EAAE,QAAQ,EAAE,KAAK,CAAC,WAAW,EAAE;KACzC,CAAC;AACJ,CAAC"}
|