@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.
Files changed (546) hide show
  1. package/README.md +549 -2
  2. package/dist/builders/buildable.d.ts +7 -0
  3. package/dist/builders/buildable.d.ts.map +1 -0
  4. package/dist/builders/buildable.js +2 -0
  5. package/dist/builders/buildable.js.map +1 -0
  6. package/dist/builders/builder.d.ts +33 -0
  7. package/dist/builders/builder.d.ts.map +1 -0
  8. package/dist/builders/builder.js +66 -0
  9. package/dist/builders/builder.js.map +1 -0
  10. package/dist/builders/defaults.d.ts +6 -0
  11. package/dist/builders/defaults.d.ts.map +1 -0
  12. package/dist/builders/defaults.js +2 -0
  13. package/dist/builders/defaults.js.map +1 -0
  14. package/dist/builders/define-builder.d.ts +14 -0
  15. package/dist/builders/define-builder.d.ts.map +1 -0
  16. package/dist/builders/define-builder.js +10 -0
  17. package/dist/builders/define-builder.js.map +1 -0
  18. package/dist/builders/generic-builder.d.ts +16 -0
  19. package/dist/builders/generic-builder.d.ts.map +1 -0
  20. package/dist/builders/generic-builder.js +23 -0
  21. package/dist/builders/generic-builder.js.map +1 -0
  22. package/dist/builders/is-resolvable.d.ts +3 -0
  23. package/dist/builders/is-resolvable.d.ts.map +1 -0
  24. package/dist/builders/is-resolvable.js +5 -0
  25. package/dist/builders/is-resolvable.js.map +1 -0
  26. package/dist/builders/lazy.d.ts +4 -0
  27. package/dist/builders/lazy.d.ts.map +1 -0
  28. package/dist/builders/lazy.js +15 -0
  29. package/dist/builders/lazy.js.map +1 -0
  30. package/dist/builders/resolvable.d.ts +6 -0
  31. package/dist/builders/resolvable.d.ts.map +1 -0
  32. package/dist/builders/resolvable.js +2 -0
  33. package/dist/builders/resolvable.js.map +1 -0
  34. package/dist/builders/resolve.d.ts +4 -0
  35. package/dist/builders/resolve.d.ts.map +1 -0
  36. package/dist/builders/resolve.js +7 -0
  37. package/dist/builders/resolve.js.map +1 -0
  38. package/dist/builders/sequence.d.ts +10 -0
  39. package/dist/builders/sequence.d.ts.map +1 -0
  40. package/dist/builders/sequence.js +14 -0
  41. package/dist/builders/sequence.js.map +1 -0
  42. package/dist/contracts/awaitable.d.ts +2 -0
  43. package/dist/contracts/awaitable.d.ts.map +1 -0
  44. package/dist/contracts/awaitable.js +2 -0
  45. package/dist/contracts/awaitable.js.map +1 -0
  46. package/dist/contracts/cache-contract.d.ts +13 -0
  47. package/dist/contracts/cache-contract.d.ts.map +1 -0
  48. package/dist/contracts/cache-contract.js +81 -0
  49. package/dist/contracts/cache-contract.js.map +1 -0
  50. package/dist/contracts/contract-runner.d.ts +16 -0
  51. package/dist/contracts/contract-runner.d.ts.map +1 -0
  52. package/dist/contracts/contract-runner.js +2 -0
  53. package/dist/contracts/contract-runner.js.map +1 -0
  54. package/dist/contracts/contract-suite.d.ts +23 -0
  55. package/dist/contracts/contract-suite.d.ts.map +1 -0
  56. package/dist/contracts/contract-suite.js +39 -0
  57. package/dist/contracts/contract-suite.js.map +1 -0
  58. package/dist/contracts/criteria/criteria-case.d.ts +11 -0
  59. package/dist/contracts/criteria/criteria-case.d.ts.map +1 -0
  60. package/dist/contracts/criteria/criteria-case.js +2 -0
  61. package/dist/contracts/criteria/criteria-case.js.map +1 -0
  62. package/dist/contracts/criteria/criteria-contract-definition.d.ts +5 -0
  63. package/dist/contracts/criteria/criteria-contract-definition.d.ts.map +1 -0
  64. package/dist/contracts/criteria/criteria-contract-definition.js +20 -0
  65. package/dist/contracts/criteria/criteria-contract-definition.js.map +1 -0
  66. package/dist/contracts/criteria/criteria-contract-row.d.ts +15 -0
  67. package/dist/contracts/criteria/criteria-contract-row.d.ts.map +1 -0
  68. package/dist/contracts/criteria/criteria-contract-row.js +2 -0
  69. package/dist/contracts/criteria/criteria-contract-row.js.map +1 -0
  70. package/dist/contracts/criteria/criteria-contract-rows.d.ts +9 -0
  71. package/dist/contracts/criteria/criteria-contract-rows.d.ts.map +1 -0
  72. package/dist/contracts/criteria/criteria-contract-rows.js +55 -0
  73. package/dist/contracts/criteria/criteria-contract-rows.js.map +1 -0
  74. package/dist/contracts/criteria/group-cases.d.ts +4 -0
  75. package/dist/contracts/criteria/group-cases.d.ts.map +1 -0
  76. package/dist/contracts/criteria/group-cases.js +96 -0
  77. package/dist/contracts/criteria/group-cases.js.map +1 -0
  78. package/dist/contracts/criteria/operator-cases.d.ts +4 -0
  79. package/dist/contracts/criteria/operator-cases.d.ts.map +1 -0
  80. package/dist/contracts/criteria/operator-cases.js +122 -0
  81. package/dist/contracts/criteria/operator-cases.js.map +1 -0
  82. package/dist/contracts/criteria/scope-cases.d.ts +4 -0
  83. package/dist/contracts/criteria/scope-cases.d.ts.map +1 -0
  84. package/dist/contracts/criteria/scope-cases.js +73 -0
  85. package/dist/contracts/criteria/scope-cases.js.map +1 -0
  86. package/dist/contracts/criteria/sort-cases.d.ts +4 -0
  87. package/dist/contracts/criteria/sort-cases.d.ts.map +1 -0
  88. package/dist/contracts/criteria/sort-cases.js +54 -0
  89. package/dist/contracts/criteria/sort-cases.js.map +1 -0
  90. package/dist/contracts/criteria-contract.d.ts +20 -0
  91. package/dist/contracts/criteria-contract.d.ts.map +1 -0
  92. package/dist/contracts/criteria-contract.js +94 -0
  93. package/dist/contracts/criteria-contract.js.map +1 -0
  94. package/dist/contracts/event-bus-contract.d.ts +23 -0
  95. package/dist/contracts/event-bus-contract.d.ts.map +1 -0
  96. package/dist/contracts/event-bus-contract.js +122 -0
  97. package/dist/contracts/event-bus-contract.js.map +1 -0
  98. package/dist/contracts/failure-of.d.ts +3 -0
  99. package/dist/contracts/failure-of.d.ts.map +1 -0
  100. package/dist/contracts/failure-of.js +12 -0
  101. package/dist/contracts/failure-of.js.map +1 -0
  102. package/dist/contracts/full-envelope.d.ts +4 -0
  103. package/dist/contracts/full-envelope.d.ts.map +1 -0
  104. package/dist/contracts/full-envelope.js +12 -0
  105. package/dist/contracts/full-envelope.js.map +1 -0
  106. package/dist/contracts/job-scheduler-contract.d.ts +21 -0
  107. package/dist/contracts/job-scheduler-contract.d.ts.map +1 -0
  108. package/dist/contracts/job-scheduler-contract.js +181 -0
  109. package/dist/contracts/job-scheduler-contract.js.map +1 -0
  110. package/dist/contracts/lock-contract.d.ts +13 -0
  111. package/dist/contracts/lock-contract.d.ts.map +1 -0
  112. package/dist/contracts/lock-contract.js +90 -0
  113. package/dist/contracts/lock-contract.js.map +1 -0
  114. package/dist/contracts/logger/create-logger.d.ts +6 -0
  115. package/dist/contracts/logger/create-logger.d.ts.map +1 -0
  116. package/dist/contracts/logger/create-logger.js +2 -0
  117. package/dist/contracts/logger/create-logger.js.map +1 -0
  118. package/dist/contracts/logger/error-outline-of.d.ts +12 -0
  119. package/dist/contracts/logger/error-outline-of.d.ts.map +1 -0
  120. package/dist/contracts/logger/error-outline-of.js +27 -0
  121. package/dist/contracts/logger/error-outline-of.js.map +1 -0
  122. package/dist/contracts/logger/logged-line.d.ts +9 -0
  123. package/dist/contracts/logger/logged-line.d.ts.map +1 -0
  124. package/dist/contracts/logger/logged-line.js +2 -0
  125. package/dist/contracts/logger/logged-line.js.map +1 -0
  126. package/dist/contracts/logger/logger-contract-setup.d.ts +11 -0
  127. package/dist/contracts/logger/logger-contract-setup.d.ts.map +1 -0
  128. package/dist/contracts/logger/logger-contract-setup.js +2 -0
  129. package/dist/contracts/logger/logger-contract-setup.js.map +1 -0
  130. package/dist/contracts/logger/logger-entries-suite.d.ts +19 -0
  131. package/dist/contracts/logger/logger-entries-suite.d.ts.map +1 -0
  132. package/dist/contracts/logger/logger-entries-suite.js +177 -0
  133. package/dist/contracts/logger/logger-entries-suite.js.map +1 -0
  134. package/dist/contracts/logger/logger-shutdown-suite.d.ts +15 -0
  135. package/dist/contracts/logger/logger-shutdown-suite.d.ts.map +1 -0
  136. package/dist/contracts/logger/logger-shutdown-suite.js +98 -0
  137. package/dist/contracts/logger/logger-shutdown-suite.js.map +1 -0
  138. package/dist/contracts/logger/logger-under-contract.d.ts +9 -0
  139. package/dist/contracts/logger/logger-under-contract.d.ts.map +1 -0
  140. package/dist/contracts/logger/logger-under-contract.js +2 -0
  141. package/dist/contracts/logger/logger-under-contract.js.map +1 -0
  142. package/dist/contracts/logger/unreadable-total.d.ts +5 -0
  143. package/dist/contracts/logger/unreadable-total.d.ts.map +1 -0
  144. package/dist/contracts/logger/unreadable-total.js +9 -0
  145. package/dist/contracts/logger/unreadable-total.js.map +1 -0
  146. package/dist/contracts/logger-contract.d.ts +14 -0
  147. package/dist/contracts/logger-contract.d.ts.map +1 -0
  148. package/dist/contracts/logger-contract.js +12 -0
  149. package/dist/contracts/logger-contract.js.map +1 -0
  150. package/dist/contracts/outbox-store-contract.d.ts +36 -0
  151. package/dist/contracts/outbox-store-contract.d.ts.map +1 -0
  152. package/dist/contracts/outbox-store-contract.js +148 -0
  153. package/dist/contracts/outbox-store-contract.js.map +1 -0
  154. package/dist/contracts/processed-event-store-contract.d.ts +11 -0
  155. package/dist/contracts/processed-event-store-contract.d.ts.map +1 -0
  156. package/dist/contracts/processed-event-store-contract.js +40 -0
  157. package/dist/contracts/processed-event-store-contract.js.map +1 -0
  158. package/dist/contracts/rate-limiter-contract.d.ts +13 -0
  159. package/dist/contracts/rate-limiter-contract.d.ts.map +1 -0
  160. package/dist/contracts/rate-limiter-contract.js +86 -0
  161. package/dist/contracts/rate-limiter-contract.js.map +1 -0
  162. package/dist/contracts/read-model/everything.d.ts +5 -0
  163. package/dist/contracts/read-model/everything.d.ts.map +1 -0
  164. package/dist/contracts/read-model/everything.js +3 -0
  165. package/dist/contracts/read-model/everything.js.map +1 -0
  166. package/dist/contracts/read-model/read-model-store-suite.d.ts +14 -0
  167. package/dist/contracts/read-model/read-model-store-suite.d.ts.map +1 -0
  168. package/dist/contracts/read-model/read-model-store-suite.js +23 -0
  169. package/dist/contracts/read-model/read-model-store-suite.js.map +1 -0
  170. package/dist/contracts/read-model/read-model-store-under-contract.d.ts +11 -0
  171. package/dist/contracts/read-model/read-model-store-under-contract.d.ts.map +1 -0
  172. package/dist/contracts/read-model/read-model-store-under-contract.js +2 -0
  173. package/dist/contracts/read-model/read-model-store-under-contract.js.map +1 -0
  174. package/dist/contracts/read-model/rebuild-suite.d.ts +14 -0
  175. package/dist/contracts/read-model/rebuild-suite.d.ts.map +1 -0
  176. package/dist/contracts/read-model/rebuild-suite.js +116 -0
  177. package/dist/contracts/read-model/rebuild-suite.js.map +1 -0
  178. package/dist/contracts/read-model/row-of.d.ts +4 -0
  179. package/dist/contracts/read-model/row-of.d.ts.map +1 -0
  180. package/dist/contracts/read-model/row-of.js +10 -0
  181. package/dist/contracts/read-model/row-of.js.map +1 -0
  182. package/dist/contracts/read-model/rows-suite.d.ts +11 -0
  183. package/dist/contracts/read-model/rows-suite.d.ts.map +1 -0
  184. package/dist/contracts/read-model/rows-suite.js +122 -0
  185. package/dist/contracts/read-model/rows-suite.js.map +1 -0
  186. package/dist/contracts/read-model/source-of-truth.d.ts +17 -0
  187. package/dist/contracts/read-model/source-of-truth.d.ts.map +1 -0
  188. package/dist/contracts/read-model/source-of-truth.js +36 -0
  189. package/dist/contracts/read-model/source-of-truth.js.map +1 -0
  190. package/dist/contracts/read-model/stamped-at.d.ts +4 -0
  191. package/dist/contracts/read-model/stamped-at.d.ts.map +1 -0
  192. package/dist/contracts/read-model/stamped-at.js +5 -0
  193. package/dist/contracts/read-model/stamped-at.js.map +1 -0
  194. package/dist/contracts/read-model-store-contract.d.ts +15 -0
  195. package/dist/contracts/read-model-store-contract.d.ts.map +1 -0
  196. package/dist/contracts/read-model-store-contract.js +13 -0
  197. package/dist/contracts/read-model-store-contract.js.map +1 -0
  198. package/dist/contracts/repository-contract.d.ts +18 -0
  199. package/dist/contracts/repository-contract.d.ts.map +1 -0
  200. package/dist/contracts/repository-contract.js +103 -0
  201. package/dist/contracts/repository-contract.js.map +1 -0
  202. package/dist/contracts/unit-of-work/after-commit-suite.d.ts +12 -0
  203. package/dist/contracts/unit-of-work/after-commit-suite.d.ts.map +1 -0
  204. package/dist/contracts/unit-of-work/after-commit-suite.js +79 -0
  205. package/dist/contracts/unit-of-work/after-commit-suite.js.map +1 -0
  206. package/dist/contracts/unit-of-work/dispatch-suite.d.ts +14 -0
  207. package/dist/contracts/unit-of-work/dispatch-suite.d.ts.map +1 -0
  208. package/dist/contracts/unit-of-work/dispatch-suite.js +171 -0
  209. package/dist/contracts/unit-of-work/dispatch-suite.js.map +1 -0
  210. package/dist/contracts/unit-of-work/failure-suite.d.ts +17 -0
  211. package/dist/contracts/unit-of-work/failure-suite.d.ts.map +1 -0
  212. package/dist/contracts/unit-of-work/failure-suite.js +114 -0
  213. package/dist/contracts/unit-of-work/failure-suite.js.map +1 -0
  214. package/dist/contracts/unit-of-work/parcel.d.ts +11 -0
  215. package/dist/contracts/unit-of-work/parcel.d.ts.map +1 -0
  216. package/dist/contracts/unit-of-work/parcel.js +22 -0
  217. package/dist/contracts/unit-of-work/parcel.js.map +1 -0
  218. package/dist/contracts/unit-of-work/parcels.d.ts +10 -0
  219. package/dist/contracts/unit-of-work/parcels.d.ts.map +1 -0
  220. package/dist/contracts/unit-of-work/parcels.js +14 -0
  221. package/dist/contracts/unit-of-work/parcels.js.map +1 -0
  222. package/dist/contracts/unit-of-work/shipping-bench.d.ts +25 -0
  223. package/dist/contracts/unit-of-work/shipping-bench.d.ts.map +1 -0
  224. package/dist/contracts/unit-of-work/shipping-bench.js +58 -0
  225. package/dist/contracts/unit-of-work/shipping-bench.js.map +1 -0
  226. package/dist/contracts/unit-of-work/unit-of-work-under-contract.d.ts +22 -0
  227. package/dist/contracts/unit-of-work/unit-of-work-under-contract.d.ts.map +1 -0
  228. package/dist/contracts/unit-of-work/unit-of-work-under-contract.js +2 -0
  229. package/dist/contracts/unit-of-work/unit-of-work-under-contract.js.map +1 -0
  230. package/dist/contracts/unit-of-work-contract.d.ts +19 -0
  231. package/dist/contracts/unit-of-work-contract.d.ts.map +1 -0
  232. package/dist/contracts/unit-of-work-contract.js +19 -0
  233. package/dist/contracts/unit-of-work-contract.js.map +1 -0
  234. package/dist/contracts.d.ts +27 -0
  235. package/dist/contracts.d.ts.map +1 -0
  236. package/dist/contracts.js +17 -0
  237. package/dist/contracts.js.map +1 -0
  238. package/dist/coverage/affected-contexts.d.ts +7 -0
  239. package/dist/coverage/affected-contexts.d.ts.map +1 -0
  240. package/dist/coverage/affected-contexts.js +15 -0
  241. package/dist/coverage/affected-contexts.js.map +1 -0
  242. package/dist/coverage/contexts-in.d.ts +3 -0
  243. package/dist/coverage/contexts-in.d.ts.map +1 -0
  244. package/dist/coverage/contexts-in.js +13 -0
  245. package/dist/coverage/contexts-in.js.map +1 -0
  246. package/dist/coverage/coverage-layer.d.ts +4 -0
  247. package/dist/coverage/coverage-layer.d.ts.map +1 -0
  248. package/dist/coverage/coverage-layer.js +2 -0
  249. package/dist/coverage/coverage-layer.js.map +1 -0
  250. package/dist/coverage/coverage-rates.d.ts +8 -0
  251. package/dist/coverage/coverage-rates.d.ts.map +1 -0
  252. package/dist/coverage/coverage-rates.js +2 -0
  253. package/dist/coverage/coverage-rates.js.map +1 -0
  254. package/dist/coverage/governed-coverage.d.ts +23 -0
  255. package/dist/coverage/governed-coverage.d.ts.map +1 -0
  256. package/dist/coverage/governed-coverage.js +27 -0
  257. package/dist/coverage/governed-coverage.js.map +1 -0
  258. package/dist/coverage/governed-jest-coverage.d.ts +18 -0
  259. package/dist/coverage/governed-jest-coverage.d.ts.map +1 -0
  260. package/dist/coverage/governed-jest-coverage.js +23 -0
  261. package/dist/coverage/governed-jest-coverage.js.map +1 -0
  262. package/dist/coverage/governed-settings.d.ts +13 -0
  263. package/dist/coverage/governed-settings.d.ts.map +1 -0
  264. package/dist/coverage/governed-settings.js +49 -0
  265. package/dist/coverage/governed-settings.js.map +1 -0
  266. package/dist/coverage/held-layers.d.ts +17 -0
  267. package/dist/coverage/held-layers.d.ts.map +1 -0
  268. package/dist/coverage/held-layers.js +30 -0
  269. package/dist/coverage/held-layers.js.map +1 -0
  270. package/dist/coverage/measured-files.d.ts +4 -0
  271. package/dist/coverage/measured-files.d.ts.map +1 -0
  272. package/dist/coverage/measured-files.js +7 -0
  273. package/dist/coverage/measured-files.js.map +1 -0
  274. package/dist/coverage/measured-layers.d.ts +8 -0
  275. package/dist/coverage/measured-layers.d.ts.map +1 -0
  276. package/dist/coverage/measured-layers.js +14 -0
  277. package/dist/coverage/measured-layers.js.map +1 -0
  278. package/dist/coverage/reference-coverage.d.ts +33 -0
  279. package/dist/coverage/reference-coverage.d.ts.map +1 -0
  280. package/dist/coverage/reference-coverage.js +13 -0
  281. package/dist/coverage/reference-coverage.js.map +1 -0
  282. package/dist/coverage/unaffected-contexts.d.ts +10 -0
  283. package/dist/coverage/unaffected-contexts.d.ts.map +1 -0
  284. package/dist/coverage/unaffected-contexts.js +23 -0
  285. package/dist/coverage/unaffected-contexts.js.map +1 -0
  286. package/dist/coverage.d.ts +7 -0
  287. package/dist/coverage.d.ts.map +1 -0
  288. package/dist/coverage.js +5 -0
  289. package/dist/coverage.js.map +1 -0
  290. package/dist/e2e/collect-events.d.ts +9 -0
  291. package/dist/e2e/collect-events.d.ts.map +1 -0
  292. package/dist/e2e/collect-events.js +9 -0
  293. package/dist/e2e/collect-events.js.map +1 -0
  294. package/dist/e2e/create-http-client.d.ts +4 -0
  295. package/dist/e2e/create-http-client.d.ts.map +1 -0
  296. package/dist/e2e/create-http-client.js +7 -0
  297. package/dist/e2e/create-http-client.js.map +1 -0
  298. package/dist/e2e/database-reset.d.ts +8 -0
  299. package/dist/e2e/database-reset.d.ts.map +1 -0
  300. package/dist/e2e/database-reset.js +2 -0
  301. package/dist/e2e/database-reset.js.map +1 -0
  302. package/dist/e2e/event-recorder.d.ts +12 -0
  303. package/dist/e2e/event-recorder.d.ts.map +1 -0
  304. package/dist/e2e/event-recorder.js +2 -0
  305. package/dist/e2e/event-recorder.js.map +1 -0
  306. package/dist/e2e/event-type.d.ts +5 -0
  307. package/dist/e2e/event-type.d.ts.map +1 -0
  308. package/dist/e2e/event-type.js +2 -0
  309. package/dist/e2e/event-type.js.map +1 -0
  310. package/dist/e2e/eventually.d.ts +13 -0
  311. package/dist/e2e/eventually.d.ts.map +1 -0
  312. package/dist/e2e/eventually.js +27 -0
  313. package/dist/e2e/eventually.js.map +1 -0
  314. package/dist/e2e/expect-problem.d.ts +13 -0
  315. package/dist/e2e/expect-problem.d.ts.map +1 -0
  316. package/dist/e2e/expect-problem.js +27 -0
  317. package/dist/e2e/expect-problem.js.map +1 -0
  318. package/dist/e2e/expect-status.d.ts +7 -0
  319. package/dist/e2e/expect-status.d.ts.map +1 -0
  320. package/dist/e2e/expect-status.js +18 -0
  321. package/dist/e2e/expect-status.js.map +1 -0
  322. package/dist/e2e/fetch-client.d.ts +18 -0
  323. package/dist/e2e/fetch-client.d.ts.map +1 -0
  324. package/dist/e2e/fetch-client.js +56 -0
  325. package/dist/e2e/fetch-client.js.map +1 -0
  326. package/dist/e2e/http-client.d.ts +17 -0
  327. package/dist/e2e/http-client.d.ts.map +1 -0
  328. package/dist/e2e/http-client.js +2 -0
  329. package/dist/e2e/http-client.js.map +1 -0
  330. package/dist/e2e/http-headers.d.ts +2 -0
  331. package/dist/e2e/http-headers.d.ts.map +1 -0
  332. package/dist/e2e/http-headers.js +2 -0
  333. package/dist/e2e/http-headers.js.map +1 -0
  334. package/dist/e2e/http-response.d.ts +9 -0
  335. package/dist/e2e/http-response.d.ts.map +1 -0
  336. package/dist/e2e/http-response.js +2 -0
  337. package/dist/e2e/http-response.js.map +1 -0
  338. package/dist/e2e/listen-on-random-port.d.ts +13 -0
  339. package/dist/e2e/listen-on-random-port.d.ts.map +1 -0
  340. package/dist/e2e/listen-on-random-port.js +21 -0
  341. package/dist/e2e/listen-on-random-port.js.map +1 -0
  342. package/dist/e2e/lower-cased.d.ts +3 -0
  343. package/dist/e2e/lower-cased.d.ts.map +1 -0
  344. package/dist/e2e/lower-cased.js +6 -0
  345. package/dist/e2e/lower-cased.js.map +1 -0
  346. package/dist/e2e/request-options.d.ts +6 -0
  347. package/dist/e2e/request-options.d.ts.map +1 -0
  348. package/dist/e2e/request-options.js +2 -0
  349. package/dist/e2e/request-options.js.map +1 -0
  350. package/dist/e2e/running-server.d.ts +6 -0
  351. package/dist/e2e/running-server.d.ts.map +1 -0
  352. package/dist/e2e/running-server.js +2 -0
  353. package/dist/e2e/running-server.js.map +1 -0
  354. package/dist/e2e/start-test-server.d.ts +18 -0
  355. package/dist/e2e/start-test-server.d.ts.map +1 -0
  356. package/dist/e2e/start-test-server.js +14 -0
  357. package/dist/e2e/start-test-server.js.map +1 -0
  358. package/dist/e2e/subscribed-recorder.d.ts +17 -0
  359. package/dist/e2e/subscribed-recorder.d.ts.map +1 -0
  360. package/dist/e2e/subscribed-recorder.js +45 -0
  361. package/dist/e2e/subscribed-recorder.js.map +1 -0
  362. package/dist/e2e/without-trailing-slashes.d.ts +3 -0
  363. package/dist/e2e/without-trailing-slashes.d.ts.map +1 -0
  364. package/dist/e2e/without-trailing-slashes.js +9 -0
  365. package/dist/e2e/without-trailing-slashes.js.map +1 -0
  366. package/dist/e2e.d.ts +16 -0
  367. package/dist/e2e.d.ts.map +1 -0
  368. package/dist/e2e.js +8 -0
  369. package/dist/e2e.js.map +1 -0
  370. package/dist/execution/a-session.d.ts +4 -0
  371. package/dist/execution/a-session.d.ts.map +1 -0
  372. package/dist/execution/a-session.js +7 -0
  373. package/dist/execution/a-session.js.map +1 -0
  374. package/dist/execution/a-test-user.d.ts +4 -0
  375. package/dist/execution/a-test-user.d.ts.map +1 -0
  376. package/dist/execution/a-test-user.js +9 -0
  377. package/dist/execution/a-test-user.js.map +1 -0
  378. package/dist/execution/an-execution-context.d.ts +4 -0
  379. package/dist/execution/an-execution-context.d.ts.map +1 -0
  380. package/dist/execution/an-execution-context.js +7 -0
  381. package/dist/execution/an-execution-context.js.map +1 -0
  382. package/dist/execution/execution-context-builder.d.ts +37 -0
  383. package/dist/execution/execution-context-builder.d.ts.map +1 -0
  384. package/dist/execution/execution-context-builder.js +67 -0
  385. package/dist/execution/execution-context-builder.js.map +1 -0
  386. package/dist/execution/scoped.d.ts +8 -0
  387. package/dist/execution/scoped.d.ts.map +1 -0
  388. package/dist/execution/scoped.js +9 -0
  389. package/dist/execution/scoped.js.map +1 -0
  390. package/dist/execution/session-builder.d.ts +37 -0
  391. package/dist/execution/session-builder.d.ts.map +1 -0
  392. package/dist/execution/session-builder.js +71 -0
  393. package/dist/execution/session-builder.js.map +1 -0
  394. package/dist/faker/create-data-generator.d.ts +15 -0
  395. package/dist/faker/create-data-generator.d.ts.map +1 -0
  396. package/dist/faker/create-data-generator.js +24 -0
  397. package/dist/faker/create-data-generator.js.map +1 -0
  398. package/dist/faker/current-data-generator.d.ts +9 -0
  399. package/dist/faker/current-data-generator.d.ts.map +1 -0
  400. package/dist/faker/current-data-generator.js +16 -0
  401. package/dist/faker/current-data-generator.js.map +1 -0
  402. package/dist/faker/data-generator.d.ts +9 -0
  403. package/dist/faker/data-generator.d.ts.map +1 -0
  404. package/dist/faker/data-generator.js +2 -0
  405. package/dist/faker/data-generator.js.map +1 -0
  406. package/dist/faker/generated.d.ts +8 -0
  407. package/dist/faker/generated.d.ts.map +1 -0
  408. package/dist/faker/generated.js +10 -0
  409. package/dist/faker/generated.js.map +1 -0
  410. package/dist/faker/replay-hint.d.ts +2 -0
  411. package/dist/faker/replay-hint.d.ts.map +1 -0
  412. package/dist/faker/replay-hint.js +4 -0
  413. package/dist/faker/replay-hint.js.map +1 -0
  414. package/dist/faker/report-seed-on-failure.d.ts +11 -0
  415. package/dist/faker/report-seed-on-failure.d.ts.map +1 -0
  416. package/dist/faker/report-seed-on-failure.js +12 -0
  417. package/dist/faker/report-seed-on-failure.js.map +1 -0
  418. package/dist/faker.d.ts +7 -0
  419. package/dist/faker.d.ts.map +1 -0
  420. package/dist/faker.js +6 -0
  421. package/dist/faker.js.map +1 -0
  422. package/dist/harness/create-test-buses.d.ts +49 -0
  423. package/dist/harness/create-test-buses.d.ts.map +1 -0
  424. package/dist/harness/create-test-buses.js +35 -0
  425. package/dist/harness/create-test-buses.js.map +1 -0
  426. package/dist/index.d.ts +27 -0
  427. package/dist/index.d.ts.map +1 -0
  428. package/dist/index.js +19 -0
  429. package/dist/index.js.map +1 -0
  430. package/dist/repositories/in-memory-repository.d.ts +30 -0
  431. package/dist/repositories/in-memory-repository.d.ts.map +1 -0
  432. package/dist/repositories/in-memory-repository.js +58 -0
  433. package/dist/repositories/in-memory-repository.js.map +1 -0
  434. package/dist/repositories/snapshot-codec.d.ts +6 -0
  435. package/dist/repositories/snapshot-codec.d.ts.map +1 -0
  436. package/dist/repositories/snapshot-codec.js +2 -0
  437. package/dist/repositories/snapshot-codec.js.map +1 -0
  438. package/dist/repositories/snapshots.d.ts +5 -0
  439. package/dist/repositories/snapshots.d.ts.map +1 -0
  440. package/dist/repositories/snapshots.js +9 -0
  441. package/dist/repositories/snapshots.js.map +1 -0
  442. package/dist/scenarios/act.d.ts +5 -0
  443. package/dist/scenarios/act.d.ts.map +1 -0
  444. package/dist/scenarios/act.js +21 -0
  445. package/dist/scenarios/act.js.map +1 -0
  446. package/dist/scenarios/async-outcome.d.ts +5 -0
  447. package/dist/scenarios/async-outcome.d.ts.map +1 -0
  448. package/dist/scenarios/async-outcome.js +2 -0
  449. package/dist/scenarios/async-outcome.js.map +1 -0
  450. package/dist/scenarios/async-scenario.d.ts +5 -0
  451. package/dist/scenarios/async-scenario.d.ts.map +1 -0
  452. package/dist/scenarios/async-scenario.js +2 -0
  453. package/dist/scenarios/async-scenario.js.map +1 -0
  454. package/dist/scenarios/deferred-outcome.d.ts +18 -0
  455. package/dist/scenarios/deferred-outcome.d.ts.map +1 -0
  456. package/dist/scenarios/deferred-outcome.js +34 -0
  457. package/dist/scenarios/deferred-outcome.js.map +1 -0
  458. package/dist/scenarios/describe-event.d.ts +3 -0
  459. package/dist/scenarios/describe-event.d.ts.map +1 -0
  460. package/dist/scenarios/describe-event.js +6 -0
  461. package/dist/scenarios/describe-event.js.map +1 -0
  462. package/dist/scenarios/error-class.d.ts +2 -0
  463. package/dist/scenarios/error-class.d.ts.map +1 -0
  464. package/dist/scenarios/error-class.js +2 -0
  465. package/dist/scenarios/error-class.js.map +1 -0
  466. package/dist/scenarios/event-matcher.d.ts +11 -0
  467. package/dist/scenarios/event-matcher.d.ts.map +1 -0
  468. package/dist/scenarios/event-matcher.js +2 -0
  469. package/dist/scenarios/event-matcher.js.map +1 -0
  470. package/dist/scenarios/event-mismatches.d.ts +5 -0
  471. package/dist/scenarios/event-mismatches.d.ts.map +1 -0
  472. package/dist/scenarios/event-mismatches.js +33 -0
  473. package/dist/scenarios/event-mismatches.js.map +1 -0
  474. package/dist/scenarios/event-source.d.ts +6 -0
  475. package/dist/scenarios/event-source.d.ts.map +1 -0
  476. package/dist/scenarios/event-source.js +2 -0
  477. package/dist/scenarios/event-source.js.map +1 -0
  478. package/dist/scenarios/given.d.ts +9 -0
  479. package/dist/scenarios/given.d.ts.map +1 -0
  480. package/dist/scenarios/given.js +10 -0
  481. package/dist/scenarios/given.js.map +1 -0
  482. package/dist/scenarios/immediate-outcome.d.ts +18 -0
  483. package/dist/scenarios/immediate-outcome.d.ts.map +1 -0
  484. package/dist/scenarios/immediate-outcome.js +147 -0
  485. package/dist/scenarios/immediate-outcome.js.map +1 -0
  486. package/dist/scenarios/is-promise-like.d.ts +2 -0
  487. package/dist/scenarios/is-promise-like.d.ts.map +1 -0
  488. package/dist/scenarios/is-promise-like.js +4 -0
  489. package/dist/scenarios/is-promise-like.js.map +1 -0
  490. package/dist/scenarios/outcome.d.ts +17 -0
  491. package/dist/scenarios/outcome.d.ts.map +1 -0
  492. package/dist/scenarios/outcome.js +2 -0
  493. package/dist/scenarios/outcome.js.map +1 -0
  494. package/dist/scenarios/recorded.d.ts +10 -0
  495. package/dist/scenarios/recorded.d.ts.map +1 -0
  496. package/dist/scenarios/recorded.js +2 -0
  497. package/dist/scenarios/recorded.js.map +1 -0
  498. package/dist/scenarios/scenario.d.ts +18 -0
  499. package/dist/scenarios/scenario.d.ts.map +1 -0
  500. package/dist/scenarios/scenario.js +17 -0
  501. package/dist/scenarios/scenario.js.map +1 -0
  502. package/dist/scenarios/show.d.ts +3 -0
  503. package/dist/scenarios/show.d.ts.map +1 -0
  504. package/dist/scenarios/show.js +6 -0
  505. package/dist/scenarios/show.js.map +1 -0
  506. package/dist/secrecy/expect-no-secret.d.ts +9 -0
  507. package/dist/secrecy/expect-no-secret.d.ts.map +1 -0
  508. package/dist/secrecy/expect-no-secret.js +55 -0
  509. package/dist/secrecy/expect-no-secret.js.map +1 -0
  510. package/dist/vitest/compiler-script.d.ts +3 -0
  511. package/dist/vitest/compiler-script.d.ts.map +1 -0
  512. package/dist/vitest/compiler-script.js +18 -0
  513. package/dist/vitest/compiler-script.js.map +1 -0
  514. package/dist/vitest/decorator-compiler.d.ts +21 -0
  515. package/dist/vitest/decorator-compiler.d.ts.map +1 -0
  516. package/dist/vitest/decorator-compiler.js +112 -0
  517. package/dist/vitest/decorator-compiler.js.map +1 -0
  518. package/dist/vitest/decorator-coverage.d.ts +27 -0
  519. package/dist/vitest/decorator-coverage.d.ts.map +1 -0
  520. package/dist/vitest/decorator-coverage.js +41 -0
  521. package/dist/vitest/decorator-coverage.js.map +1 -0
  522. package/dist/vitest/decorators.d.ts +41 -0
  523. package/dist/vitest/decorators.d.ts.map +1 -0
  524. package/dist/vitest/decorators.js +49 -0
  525. package/dist/vitest/decorators.js.map +1 -0
  526. package/dist/vitest/is-record.d.ts +2 -0
  527. package/dist/vitest/is-record.d.ts.map +1 -0
  528. package/dist/vitest/is-record.js +4 -0
  529. package/dist/vitest/is-record.js.map +1 -0
  530. package/dist/vitest/project-options.d.ts +3 -0
  531. package/dist/vitest/project-options.d.ts.map +1 -0
  532. package/dist/vitest/project-options.js +2 -0
  533. package/dist/vitest/project-options.js.map +1 -0
  534. package/dist/vitest/single-file-project.d.ts +3 -0
  535. package/dist/vitest/single-file-project.d.ts.map +1 -0
  536. package/dist/vitest/single-file-project.js +26 -0
  537. package/dist/vitest/single-file-project.js.map +1 -0
  538. package/dist/vitest/source-map-of.d.ts +3 -0
  539. package/dist/vitest/source-map-of.d.ts.map +1 -0
  540. package/dist/vitest/source-map-of.js +14 -0
  541. package/dist/vitest/source-map-of.js.map +1 -0
  542. package/dist/vitest.d.ts +3 -0
  543. package/dist/vitest.d.ts.map +1 -0
  544. package/dist/vitest.js +3 -0
  545. package/dist/vitest.js.map +1 -0
  546. 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":"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"}