@satorio/machinery 0.2.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 (341) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +71 -0
  3. package/dictionary/all.json +4656 -0
  4. package/dictionary/all.toon +639 -0
  5. package/dictionary/core.json +221 -0
  6. package/dictionary/core.toon +33 -0
  7. package/dictionary/graphql.json +212 -0
  8. package/dictionary/graphql.toon +32 -0
  9. package/dictionary/http.json +113 -0
  10. package/dictionary/http.toon +21 -0
  11. package/dictionary/identifiers.json +266 -0
  12. package/dictionary/identifiers.toon +38 -0
  13. package/dictionary/index.json +96 -0
  14. package/dictionary/index.toon +18 -0
  15. package/dictionary/integration.json +131 -0
  16. package/dictionary/integration.toon +23 -0
  17. package/dictionary/money.json +383 -0
  18. package/dictionary/money.toon +51 -0
  19. package/dictionary/ports.json +392 -0
  20. package/dictionary/ports.toon +52 -0
  21. package/dictionary/postgres.json +473 -0
  22. package/dictionary/postgres.toon +61 -0
  23. package/dictionary/publishing.json +131 -0
  24. package/dictionary/publishing.toon +23 -0
  25. package/dictionary/queue.json +365 -0
  26. package/dictionary/queue.toon +49 -0
  27. package/dictionary/reference/api.mdx +843 -0
  28. package/dictionary/reference/uk/api.mdx +844 -0
  29. package/dictionary/storage.json +194 -0
  30. package/dictionary/storage.toon +30 -0
  31. package/dictionary/testing.json +707 -0
  32. package/dictionary/testing.toon +87 -0
  33. package/dictionary/time.json +311 -0
  34. package/dictionary/time.toon +43 -0
  35. package/dictionary/vitest.json +356 -0
  36. package/dictionary/vitest.toon +48 -0
  37. package/dictionary/workflow.json +185 -0
  38. package/dictionary/workflow.toon +29 -0
  39. package/dist/bin/command.d.ts +45 -0
  40. package/dist/bin/command.js +113 -0
  41. package/dist/bin.d.ts +2 -0
  42. package/dist/bin.js +11 -0
  43. package/dist/core/bigint-json.d.ts +6 -0
  44. package/dist/core/bigint-json.js +6 -0
  45. package/dist/core/closed-set.d.ts +14 -0
  46. package/dist/core/closed-set.js +8 -0
  47. package/dist/core/domain-error.d.ts +8 -0
  48. package/dist/core/domain-error.js +11 -0
  49. package/dist/core/environment.d.ts +124 -0
  50. package/dist/core/environment.js +115 -0
  51. package/dist/core/index.d.ts +13 -0
  52. package/dist/core/index.js +13 -0
  53. package/dist/core/ulid.d.ts +27 -0
  54. package/dist/core/ulid.js +27 -0
  55. package/dist/graphql/builder.d.ts +36 -0
  56. package/dist/graphql/builder.js +35 -0
  57. package/dist/graphql/context.d.ts +36 -0
  58. package/dist/graphql/context.js +69 -0
  59. package/dist/graphql/failure-classification.d.ts +11 -0
  60. package/dist/graphql/failure-classification.js +1 -0
  61. package/dist/graphql/failures.d.ts +62 -0
  62. package/dist/graphql/failures.js +30 -0
  63. package/dist/graphql/graphiql.d.ts +45 -0
  64. package/dist/graphql/graphiql.js +56 -0
  65. package/dist/graphql/index.d.ts +15 -0
  66. package/dist/graphql/index.js +14 -0
  67. package/dist/graphql/layer.d.ts +15 -0
  68. package/dist/graphql/layer.js +23 -0
  69. package/dist/graphql/request-handler.d.ts +26 -0
  70. package/dist/graphql/request-handler.js +33 -0
  71. package/dist/graphql/server.d.ts +19 -0
  72. package/dist/graphql/server.js +16 -0
  73. package/dist/graphql/settings.d.ts +55 -0
  74. package/dist/graphql/settings.js +82 -0
  75. package/dist/http/health.d.ts +70 -0
  76. package/dist/http/health.js +60 -0
  77. package/dist/http/index.d.ts +5 -0
  78. package/dist/http/index.js +5 -0
  79. package/dist/identifiers/client-code.d.ts +37 -0
  80. package/dist/identifiers/client-code.js +41 -0
  81. package/dist/identifiers/creditor-reference.d.ts +38 -0
  82. package/dist/identifiers/creditor-reference.js +32 -0
  83. package/dist/identifiers/damm.d.ts +22 -0
  84. package/dist/identifiers/damm.js +50 -0
  85. package/dist/identifiers/document-number.d.ts +68 -0
  86. package/dist/identifiers/document-number.js +73 -0
  87. package/dist/identifiers/document-numbers.d.ts +27 -0
  88. package/dist/identifiers/document-numbers.js +16 -0
  89. package/dist/identifiers/failures.d.ts +46 -0
  90. package/dist/identifiers/failures.js +48 -0
  91. package/dist/identifiers/index.d.ts +14 -0
  92. package/dist/identifiers/index.js +13 -0
  93. package/dist/identifiers/next-document-number.d.ts +26 -0
  94. package/dist/identifiers/next-document-number.js +31 -0
  95. package/dist/identifiers/ulid.d.ts +28 -0
  96. package/dist/identifiers/ulid.js +71 -0
  97. package/dist/integration/external-http-client.d.ts +22 -0
  98. package/dist/integration/external-http-client.js +74 -0
  99. package/dist/integration/index.d.ts +12 -0
  100. package/dist/integration/index.js +12 -0
  101. package/dist/integration/layer.d.ts +19 -0
  102. package/dist/integration/layer.js +30 -0
  103. package/dist/integration/retry.d.ts +65 -0
  104. package/dist/integration/retry.js +54 -0
  105. package/dist/integration/settings.d.ts +73 -0
  106. package/dist/integration/settings.js +92 -0
  107. package/dist/money/amount.d.ts +60 -0
  108. package/dist/money/amount.js +67 -0
  109. package/dist/money/arithmetic.d.ts +60 -0
  110. package/dist/money/arithmetic.js +73 -0
  111. package/dist/money/currency.d.ts +25 -0
  112. package/dist/money/currency.js +24 -0
  113. package/dist/money/decimal.d.ts +29 -0
  114. package/dist/money/decimal.js +39 -0
  115. package/dist/money/exchange-rate.d.ts +32 -0
  116. package/dist/money/exchange-rate.js +28 -0
  117. package/dist/money/failures.d.ts +86 -0
  118. package/dist/money/failures.js +97 -0
  119. package/dist/money/index.d.ts +15 -0
  120. package/dist/money/index.js +15 -0
  121. package/dist/money/percent.d.ts +35 -0
  122. package/dist/money/percent.js +50 -0
  123. package/dist/money/schema.d.ts +25 -0
  124. package/dist/money/schema.js +41 -0
  125. package/dist/ports/blob-store.d.ts +42 -0
  126. package/dist/ports/blob-store.js +13 -0
  127. package/dist/ports/document-number-counter.d.ts +36 -0
  128. package/dist/ports/document-number-counter.js +12 -0
  129. package/dist/ports/event-publisher.d.ts +29 -0
  130. package/dist/ports/event-publisher.js +13 -0
  131. package/dist/ports/external-http-client.d.ts +60 -0
  132. package/dist/ports/external-http-client.js +25 -0
  133. package/dist/ports/index.d.ts +17 -0
  134. package/dist/ports/index.js +17 -0
  135. package/dist/ports/integration-event-outbox.d.ts +44 -0
  136. package/dist/ports/integration-event-outbox.js +13 -0
  137. package/dist/ports/port-unavailable.d.ts +21 -0
  138. package/dist/ports/port-unavailable.js +30 -0
  139. package/dist/ports/processed-event-registry.d.ts +57 -0
  140. package/dist/ports/processed-event-registry.js +24 -0
  141. package/dist/ports/queue-message-producer.d.ts +26 -0
  142. package/dist/ports/queue-message-producer.js +12 -0
  143. package/dist/ports/queue-message-source.d.ts +39 -0
  144. package/dist/ports/queue-message-source.js +13 -0
  145. package/dist/ports/readiness-probe.d.ts +27 -0
  146. package/dist/ports/readiness-probe.js +13 -0
  147. package/dist/ports/transaction-boundary.d.ts +28 -0
  148. package/dist/ports/transaction-boundary.js +13 -0
  149. package/dist/postgres/client.d.ts +51 -0
  150. package/dist/postgres/client.js +81 -0
  151. package/dist/postgres/document-number-counter.d.ts +14 -0
  152. package/dist/postgres/document-number-counter.js +27 -0
  153. package/dist/postgres/failures.d.ts +28 -0
  154. package/dist/postgres/failures.js +18 -0
  155. package/dist/postgres/index.d.ts +18 -0
  156. package/dist/postgres/index.js +18 -0
  157. package/dist/postgres/integration-event-outbox.d.ts +15 -0
  158. package/dist/postgres/integration-event-outbox.js +60 -0
  159. package/dist/postgres/jsonb-value.d.ts +10 -0
  160. package/dist/postgres/jsonb-value.js +9 -0
  161. package/dist/postgres/layer.d.ts +57 -0
  162. package/dist/postgres/layer.js +72 -0
  163. package/dist/postgres/migrations/advisory-lock.d.ts +47 -0
  164. package/dist/postgres/migrations/advisory-lock.js +59 -0
  165. package/dist/postgres/migrations/runner.d.ts +56 -0
  166. package/dist/postgres/migrations/runner.js +69 -0
  167. package/dist/postgres/migrations/sql-file-loader.d.ts +59 -0
  168. package/dist/postgres/migrations/sql-file-loader.js +99 -0
  169. package/dist/postgres/processed-event-registry.d.ts +13 -0
  170. package/dist/postgres/processed-event-registry.js +44 -0
  171. package/dist/postgres/readiness-probe.d.ts +27 -0
  172. package/dist/postgres/readiness-probe.js +33 -0
  173. package/dist/postgres/settings.d.ts +134 -0
  174. package/dist/postgres/settings.js +210 -0
  175. package/dist/postgres/sql/0001_processed_event.sql +4 -0
  176. package/dist/postgres/sql/0002_integration_event_outbox.sql +13 -0
  177. package/dist/postgres/sql/0003_document_number_counter.sql +6 -0
  178. package/dist/postgres/sql-failure.d.ts +19 -0
  179. package/dist/postgres/sql-failure.js +22 -0
  180. package/dist/postgres/store-failure.d.ts +17 -0
  181. package/dist/postgres/store-failure.js +16 -0
  182. package/dist/postgres/transaction-boundary.d.ts +13 -0
  183. package/dist/postgres/transaction-boundary.js +21 -0
  184. package/dist/publishing/event-publisher.sns.d.ts +66 -0
  185. package/dist/publishing/event-publisher.sns.js +75 -0
  186. package/dist/publishing/event-publisher.stdout.d.ts +15 -0
  187. package/dist/publishing/event-publisher.stdout.js +24 -0
  188. package/dist/publishing/index.d.ts +10 -0
  189. package/dist/publishing/index.js +10 -0
  190. package/dist/publishing/layer.d.ts +25 -0
  191. package/dist/publishing/layer.js +39 -0
  192. package/dist/publishing/settings.d.ts +60 -0
  193. package/dist/publishing/settings.js +85 -0
  194. package/dist/queue/consumer.d.ts +91 -0
  195. package/dist/queue/consumer.js +92 -0
  196. package/dist/queue/envelope.d.ts +39 -0
  197. package/dist/queue/envelope.js +39 -0
  198. package/dist/queue/failures.d.ts +33 -0
  199. package/dist/queue/failures.js +15 -0
  200. package/dist/queue/index.d.ts +14 -0
  201. package/dist/queue/index.js +14 -0
  202. package/dist/queue/layer.d.ts +33 -0
  203. package/dist/queue/layer.js +58 -0
  204. package/dist/queue/message-codec.d.ts +43 -0
  205. package/dist/queue/message-codec.js +33 -0
  206. package/dist/queue/queue-message-producer.d.ts +61 -0
  207. package/dist/queue/queue-message-producer.js +52 -0
  208. package/dist/queue/queue-message-source.d.ts +93 -0
  209. package/dist/queue/queue-message-source.js +86 -0
  210. package/dist/queue/readiness.d.ts +78 -0
  211. package/dist/queue/readiness.js +86 -0
  212. package/dist/queue/settings.d.ts +106 -0
  213. package/dist/queue/settings.js +160 -0
  214. package/dist/storage/blob-store.d.ts +84 -0
  215. package/dist/storage/blob-store.js +109 -0
  216. package/dist/storage/index.d.ts +9 -0
  217. package/dist/storage/index.js +9 -0
  218. package/dist/storage/layer.d.ts +17 -0
  219. package/dist/storage/layer.js +30 -0
  220. package/dist/storage/settings.d.ts +48 -0
  221. package/dist/storage/settings.js +65 -0
  222. package/dist/testing/blob-store.d.ts +27 -0
  223. package/dist/testing/blob-store.js +45 -0
  224. package/dist/testing/clock.d.ts +29 -0
  225. package/dist/testing/clock.js +41 -0
  226. package/dist/testing/dna-perturbator/attention.d.ts +55 -0
  227. package/dist/testing/dna-perturbator/attention.js +49 -0
  228. package/dist/testing/dna-perturbator/chains.d.ts +31 -0
  229. package/dist/testing/dna-perturbator/chains.js +53 -0
  230. package/dist/testing/dna-perturbator/report.d.ts +12 -0
  231. package/dist/testing/dna-perturbator/report.js +22 -0
  232. package/dist/testing/dna-perturbator/verdict.d.ts +26 -0
  233. package/dist/testing/dna-perturbator/verdict.js +28 -0
  234. package/dist/testing/dna-perturbator.d.ts +48 -0
  235. package/dist/testing/dna-perturbator.js +145 -0
  236. package/dist/testing/document-number-counter.d.ts +29 -0
  237. package/dist/testing/document-number-counter.js +39 -0
  238. package/dist/testing/event-publisher.d.ts +28 -0
  239. package/dist/testing/event-publisher.js +33 -0
  240. package/dist/testing/external-http-client.d.ts +29 -0
  241. package/dist/testing/external-http-client.js +49 -0
  242. package/dist/testing/index.d.ts +24 -0
  243. package/dist/testing/index.js +24 -0
  244. package/dist/testing/integration-event-outbox.d.ts +37 -0
  245. package/dist/testing/integration-event-outbox.js +67 -0
  246. package/dist/testing/mutation-settings.d.ts +71 -0
  247. package/dist/testing/mutation-settings.js +57 -0
  248. package/dist/testing/postgres-rows.d.ts +12 -0
  249. package/dist/testing/postgres-rows.js +19 -0
  250. package/dist/testing/processed-event-registry.d.ts +25 -0
  251. package/dist/testing/processed-event-registry.js +39 -0
  252. package/dist/testing/queue-message-producer.d.ts +27 -0
  253. package/dist/testing/queue-message-producer.js +41 -0
  254. package/dist/testing/queue-message-source.d.ts +54 -0
  255. package/dist/testing/queue-message-source.js +71 -0
  256. package/dist/testing/quiet-reporter.d.ts +86 -0
  257. package/dist/testing/quiet-reporter.js +81 -0
  258. package/dist/testing/readiness-probe.d.ts +27 -0
  259. package/dist/testing/readiness-probe.js +33 -0
  260. package/dist/testing/scenario.d.ts +94 -0
  261. package/dist/testing/scenario.js +81 -0
  262. package/dist/testing/transaction-boundary.d.ts +30 -0
  263. package/dist/testing/transaction-boundary.js +36 -0
  264. package/dist/testing/typed-failure.d.ts +8 -0
  265. package/dist/testing/typed-failure.js +15 -0
  266. package/dist/time/calendar-day.d.ts +83 -0
  267. package/dist/time/calendar-day.js +112 -0
  268. package/dist/time/failures.d.ts +51 -0
  269. package/dist/time/failures.js +56 -0
  270. package/dist/time/index.d.ts +11 -0
  271. package/dist/time/index.js +11 -0
  272. package/dist/time/instant.d.ts +64 -0
  273. package/dist/time/instant.js +67 -0
  274. package/dist/time/period.d.ts +45 -0
  275. package/dist/time/period.js +55 -0
  276. package/dist/vitest/container-reuse.d.ts +14 -0
  277. package/dist/vitest/container-reuse.js +15 -0
  278. package/dist/vitest/dotenv.d.ts +16 -0
  279. package/dist/vitest/dotenv.js +48 -0
  280. package/dist/vitest/effect-single-instance.d.ts +36 -0
  281. package/dist/vitest/effect-single-instance.js +125 -0
  282. package/dist/vitest/fast-check-single-instance.d.ts +11 -0
  283. package/dist/vitest/fast-check-single-instance.js +26 -0
  284. package/dist/vitest/index.d.ts +31 -0
  285. package/dist/vitest/index.js +30 -0
  286. package/dist/vitest/localstack-container.d.ts +32 -0
  287. package/dist/vitest/localstack-container.js +55 -0
  288. package/dist/vitest/port-contract-tester.d.ts +8 -0
  289. package/dist/vitest/port-contract-tester.js +1 -0
  290. package/dist/vitest/port-contracts/blob-store.contract.d.ts +22 -0
  291. package/dist/vitest/port-contracts/blob-store.contract.js +108 -0
  292. package/dist/vitest/port-contracts/document-number-counter.contract.d.ts +18 -0
  293. package/dist/vitest/port-contracts/document-number-counter.contract.js +90 -0
  294. package/dist/vitest/port-contracts/event-publisher.contract.d.ts +35 -0
  295. package/dist/vitest/port-contracts/event-publisher.contract.js +67 -0
  296. package/dist/vitest/port-contracts/external-http-client.contract.d.ts +35 -0
  297. package/dist/vitest/port-contracts/external-http-client.contract.js +52 -0
  298. package/dist/vitest/port-contracts/integration-event-outbox.contract.d.ts +23 -0
  299. package/dist/vitest/port-contracts/integration-event-outbox.contract.js +75 -0
  300. package/dist/vitest/port-contracts/processed-event-registry.contract.d.ts +18 -0
  301. package/dist/vitest/port-contracts/processed-event-registry.contract.js +84 -0
  302. package/dist/vitest/port-contracts/queue-message-producer.contract.d.ts +26 -0
  303. package/dist/vitest/port-contracts/queue-message-producer.contract.js +48 -0
  304. package/dist/vitest/port-contracts/queue-message-source.contract.d.ts +29 -0
  305. package/dist/vitest/port-contracts/queue-message-source.contract.js +71 -0
  306. package/dist/vitest/port-contracts/readiness-probe.contract.d.ts +18 -0
  307. package/dist/vitest/port-contracts/readiness-probe.contract.js +41 -0
  308. package/dist/vitest/port-contracts/transaction-boundary.contract.d.ts +21 -0
  309. package/dist/vitest/port-contracts/transaction-boundary.contract.js +64 -0
  310. package/dist/vitest/postgres-container.d.ts +57 -0
  311. package/dist/vitest/postgres-container.js +118 -0
  312. package/dist/vitest/reader-port-contract.d.ts +41 -0
  313. package/dist/vitest/reader-port-contract.js +43 -0
  314. package/dist/vitest/repo-source-files.d.ts +37 -0
  315. package/dist/vitest/repo-source-files.js +61 -0
  316. package/dist/vitest/reset-tables.d.ts +18 -0
  317. package/dist/vitest/reset-tables.js +30 -0
  318. package/dist/vitest/settings-contract.d.ts +38 -0
  319. package/dist/vitest/settings-contract.js +77 -0
  320. package/dist/vitest/stub-server.d.ts +43 -0
  321. package/dist/vitest/stub-server.js +60 -0
  322. package/dist/vitest/term-registry.json +730 -0
  323. package/dist/vitest/testclock-fork-isolated-files.d.ts +13 -0
  324. package/dist/vitest/testclock-fork-isolated-files.js +18 -0
  325. package/dist/vitest/testclock-fork-isolation.d.ts +77 -0
  326. package/dist/vitest/testclock-fork-isolation.js +188 -0
  327. package/dist/workflow/claim-once.d.ts +16 -0
  328. package/dist/workflow/claim-once.js +9 -0
  329. package/dist/workflow/failures.d.ts +47 -0
  330. package/dist/workflow/failures.js +22 -0
  331. package/dist/workflow/index.d.ts +12 -0
  332. package/dist/workflow/index.js +12 -0
  333. package/dist/workflow/on-claim.d.ts +17 -0
  334. package/dist/workflow/on-claim.js +8 -0
  335. package/dist/workflow/publish-pending-events.d.ts +31 -0
  336. package/dist/workflow/publish-pending-events.js +31 -0
  337. package/dist/workflow/transactionally.d.ts +8 -0
  338. package/dist/workflow/transactionally.js +8 -0
  339. package/dist/workflow/versioned-payload.d.ts +35 -0
  340. package/dist/workflow/versioned-payload.js +43 -0
  341. package/package.json +309 -0
@@ -0,0 +1,639 @@
1
+ package: @satorio/machinery
2
+ version: 0.2.1
3
+ index[15]{mechanism,what,whatUk,import}:
4
+ core,"Public entry to the core mechanism: the few pieces every other mechanism leans on, and which lean on nothing themselves.","Публічний вхід до механізму core: кілька частин, на які спирається кожен інший механізм і які самі не спираються ні на що.",@satorio/machinery/core
5
+ http,"Public entry to the http mechanism: readiness probes mounted on the same port as GraphQL.","Публічний вхід до механізму http: проби готовності (ReadinessProbe), змонтовані на тому самому порту (port), що й GraphQL.",@satorio/machinery/http
6
+ money,"Public entry to the money mechanism, over dinero.js, the optional peer your service installs: exact amounts of one currency, shares, rates, and rounding.","Публічний вхід до механізму money, над dinero.js, спільною залежністю, яку ставить ваш сервіс: точні суми однієї валюти, частки, курси й округлення.",@satorio/machinery/money
7
+ ports,"Public entry to the ports mechanism: every boundary a use case may ask for, and the failure each one raises.","Публічний вхід до механізму ports: кожна межа, яку може попросити процедура (use case), і відмова (refusal), яку піднімає кожна з них.",@satorio/machinery/ports
8
+ time,"Public entry to the time mechanism: a day a person reads and writes, a period of days, and a moment on the clock.","Публічний вхід до механізму time: день, який людина читає і пише, період (period) днів і мить на годиннику.",@satorio/machinery/time
9
+ identifiers,"Public entry to the identifiers mechanism: the id a machine mints, and the numbers a person reads off a document.","Публічний вхід до механізму identifiers: ідентифікатор, який карбує машина, і номери, які людина читає з документа.",@satorio/machinery/identifiers
10
+ workflow,"Public entry to the workflow mechanism: the combinators a use case composes its own beat from.","Публічний вхід до механізму workflow: комбінатори, з яких процедура складає власний такт.",@satorio/machinery/workflow
11
+ graphql,"Public entry to the graphql mechanism: one server that answers your operations and the readiness probes beside them.","Публічний вхід до механізму graphql: один сервер, який відповідає на ваші операції і на проби готовності поруч із ними.",@satorio/machinery/graphql
12
+ integration,"Public entry to the integration mechanism: one HTTP client for reference data outside this service.","Публічний вхід до механізму integration: один HTTP-клієнт до довідкових даних поза цим сервісом.",@satorio/machinery/integration
13
+ postgres,"Public entry to the postgres mechanism: every port this machinery defines, bound to a real database.","Публічний вхід до механізму postgres: кожен порт, який визначає ця машинерія (machinery), прив'язаний до справжньої бази.",@satorio/machinery/postgres
14
+ publishing,"Public entry to the publishing mechanism: the event publisher, bound to a topic or to one line on stdout.","Публічний вхід до механізму publishing: публікатор (publisher) подій, прив'язаний до топіка або до одного рядка на stdout.",@satorio/machinery/publishing
15
+ queue,"Public entry to the queue mechanism: the envelope a message travels in, and the consumer that decides its fate.","Публічний вхід до механізму queue: конверт, у якому мандрує повідомлення, і робітник (consumer), який вирішує його долю.",@satorio/machinery/queue
16
+ storage,"Public entry to the storage mechanism: whole objects stored under a key and read back.","Публічний вхід до механізму storage: цілі об'єкти, збережені під ключем і прочитані назад.",@satorio/machinery/storage
17
+ testing,"Public entry to the testing mechanism: a stand-in for every port, a clock a test drives, and the scenario player.","Публічний вхід до механізму testing: замінник кожного порту, годинник, яким керує тест (test), і програвач сценаріїв (playScenario).",@satorio/machinery/testing
18
+ vitest,"Public entry to the vitest mechanism: live stands, port contracts, and the guards that read the test runtime.","Публічний вхід до механізму vitest: живі стенди, контракти портів і три перевірки збірки (guard), які тримають рантайм цих тестів.",@satorio/machinery/vitest
19
+ mechanisms[15]:
20
+ - mechanism: core
21
+ import: @satorio/machinery/core
22
+ kind: foundation
23
+ page: mechanisms/core
24
+ what: "Public entry to the core mechanism: the few pieces every other mechanism leans on, and which lean on nothing themselves."
25
+ whatUk: "Публічний вхід до механізму core: кілька частин, на які спирається кожен інший механізм і які самі не спираються ні на що."
26
+ rows[23]{name,kind,signature,fallback,caption,captionUk,anchor}:
27
+ ClosedSet,value,interface,"","Turns an array of string literals into a closed set: the values, a union type of their members, and an `is` guard, all from one source.","Чітко визначений перелік (closed set) із одного джерела: значення, тип-об'єднання його членів і перевірка `is`.",core-ClosedSet-value
28
+ EnvironmentEntry,value,interface,"","One variable a mechanism reads, and the one state it stands in.","Одна змінна, яку читає механізм, і один стан, у якому вона стоїть.",core-EnvironmentEntry-value
29
+ EnvironmentState,value,type,"",Which of three states a variable stands in.,Котрий із трьох станів має змінна.,core-EnvironmentState-value
30
+ Refusal,value,interface,"","A refusal in the three parts a reader needs: what happened, why this mechanism cannot go on without it, and what to do next.","Відмова у трьох частинах, яких потребує читач: що сталось, чому механізм без цього не піде далі і що робити.",core-Refusal-value
31
+ Ulid,value,"string & { readonly [ulidBrand]: 'Ulid' }","","A ULID: the identifier a machine mints for a record, sortable by the moment it was minted, and a plain string everywhere it travels.","ULID: ідентифікатор, який машина карбує для запису, сортовний за миттю карбування і звичайний рядок усюди, куди мандрує.",core-Ulid-value
32
+ bigIntsAsDecimalStrings,procedure,"(_key: string, value: unknown) => unknown","",Use as the replacer argument to `JSON.stringify`.,Подавайте це аргументом-заміною до `JSON.stringify`.,core-bigIntsAsDecimalStrings-procedure
33
+ closedSet,procedure,"<const T extends readonly string[]>(values: T) => ClosedSet<T>","","Builds a closed set from an array of string literals, so the guard and the list it guards come from one source.","Будує чітко визначений перелік зі списку рядкових літералів, тож перевірка і список, який вона стереже, приходять з одного джерела.",core-closedSet-procedure
34
+ fallsBackTo,procedure,"(value: string) => EnvironmentState","","The variable is safe to omit, and this is what happens instead.","Змінну безпечно не ставити, і ось що стається натомість.",core-fallsBackTo-procedure
35
+ handedOn,procedure,"(consequence: string) => EnvironmentState","","The variable is legitimately optional with no default, because somebody else decides it, and this is what follows from leaving it unset.","Змінна законно необов'язкова і не має значення за замовчуванням, бо її вирішує хтось інший; ось що випливає, якщо її не поставити.",core-handedOn-procedure
36
+ isUlid,procedure,"(value: string) => value is Ulid","","Whether a string is a ULID, as a type guard, so a caller narrows the type without raising anything.","Чи є рядок ULID, як перевірка типу, тож викликач звужує тип і нічого не піднімає.",core-isUlid-procedure
37
+ optionalSecret,procedure,"(name: string) => Config.Config<Option.Option<Redacted.Redacted>>","","Reads a secret that is legitimately optional, and hands back `Option.none` when it is unset or blank.","Читає секрет, який законно необов'язковий, і подає `Option.none`, коли той не поставлений або порожній.",core-optionalSecret-procedure
38
+ optionalText,procedure,"(name: string) => Config.Config<Option.Option<string>>","","Reads a variable that is legitimately optional with no default, because somebody outside this process decides it.","Читає змінну, яка законно необов'язкова і не має значення за замовчуванням, бо її вирішує хтось поза цим процесом.",core-optionalText-procedure
39
+ refusalFor,procedure,"(name: string, refusal: Refusal) => ConfigError.ConfigError","","The one failure a refusing variable raises, with its three parts sewn into a single line.","Одна відмова, яку піднімає змінна, що відмовляє, з трьома її частинами, зшитими в один рядок.",core-refusalFor-procedure
40
+ refusalText,procedure,"(refusal: Refusal) => string","",Sews a refusal into the one line an operator reads in a log or a startup failure.,"Зшиває відмову в один рядок, який оператор читає в лозі або у відмові на старті.",core-refusalText-procedure
41
+ refuses,procedure,"(refusal: Refusal) => EnvironmentState","","The mechanism cannot work without the variable, and this is the three-part text a reader meets when it is missing.","Механізм без цієї змінної не працює, і ось той текст із трьох частин, який читач зустріне, коли її немає.",core-refuses-procedure
42
+ requiredSecret,procedure,"(name: string, refusal: Refusal) => Config.Config<Redacted.Redacted>","","Reads a secret a mechanism cannot work without, and refuses in the same three parts when it is missing or blank.","Читає секрет, без якого механізм не працює, і відмовляє тими самими трьома частинами, коли той відсутній або порожній.",core-requiredSecret-procedure
43
+ requiredText,procedure,"(name: string, refusal: Refusal) => Config.Config<string>","","Reads a variable that a mechanism cannot work without, and refuses in three parts when it is missing or blank.","Читає змінну, без якої механізм не працює, і відмовляє трьома частинами, коли та відсутня або порожня.",core-requiredText-procedure
44
+ ulid,procedure,"(raw: string) => Ulid","","Reads a string as a ULID and throws `NotAUlidError` when it is not one, so a raw string comes through one door.","Читає рядок як ULID і кидає `NotAUlidError`, коли це не ULID, тож сирий рядок заходить одними дверима.",core-ulid-procedure
45
+ variableNameOf,procedure,"(entry: EnvironmentEntry) => string","","The name an operator sets, with `<PREFIX>` standing in front of a suffix the application chooses at mount time.","Назва, яку ставить оператор, де `<PREFIX>` стоїть перед суфіксом, що його застосунок обирає під час монтування.",core-variableNameOf-procedure
46
+ wholeNumberFallingBackTo,procedure,"(name: string, lowest: number, highest: number, fallback: number, refusal: Refusal) => Config.Config<number>","","Reads a whole number a mechanism is happy to do without, and falls back to the value it names when nobody set the variable.","Читає ціле число, без якого механізм радо обійдеться, і падає на назване значення, коли змінну ніхто не поставив.",core-wholeNumberFallingBackTo-procedure
47
+ wholeNumberWithin,procedure,"(name: string, lowest: number, highest: number, refusal: Refusal) => Config.Config<number>","","Reads a whole number inside a range, and refuses in three parts when it is not one.","Читає ціле число всередині діапазону і відмовляє трьома частинами, коли це не воно.",core-wholeNumberWithin-procedure
48
+ DomainError,failure,Error,"",Base class for domain errors.,Базовий клас доменних помилок.,core-DomainError-failure
49
+ NotAUlidError,failure,DomainError,"",What a caller meets when a string that is not a ULID reaches `ulid`; the message quotes the exact value received.,"Що зустрічає викликач, коли до `ulid` дійшов рядок, який не є ULID; повідомлення цитує точне отримане значення.",core-NotAUlidError-failure
50
+ - mechanism: http
51
+ import: @satorio/machinery/http
52
+ kind: foundation
53
+ page: mechanisms/http
54
+ what: "Public entry to the http mechanism: readiness probes mounted on the same port as GraphQL."
55
+ whatUk: "Публічний вхід до механізму http: проби готовності (ReadinessProbe), змонтовані на тому самому порту (port), що й GraphQL."
56
+ rows[11]{name,kind,signature,fallback,caption,captionUk,anchor}:
57
+ DEFAULT_HEALTH_CHECK_DEADLINE_MILLIS,value,const,"",How long one check gets before it counts as down.,"Скільки часу дістає одна перевірка, перш ніж рахуватись як недоступна.",http-DEFAULT-HEALTH-CHECK-DEADLINE-MILLIS-value
58
+ HealthCheckStatus,value,'ok' | 'down',"","How one dependency came back: it answered, or it is down.","Як відповіла одна залежність: вона відповіла, або вона лежить.",http-HealthCheckStatus-value
59
+ HealthRoutesOptions,value,interface,"","What the readiness routes need: the runtime that runs a check, the checks themselves, and the deadline one check gets.","Що потрібно маршрутам готовності: рантайм, який виконує перевірку, самі перевірки і строк, який дістає одна з них.",http-HealthRoutesOptions-value
60
+ HEALTHZ_PATH,value,const,"","Same check as READYZ_PATH, under a second name.","Та сама перевірка, що й `READYZ_PATH`, під другою назвою.",http-HEALTHZ-PATH-value
61
+ LIVEZ_PATH,value,const,"","The path that answers whether this process is alive at all, without checking a single dependency.","Шлях, який відповідає, чи цей процес узагалі живий, не питаючи жодної залежності.",http-LIVEZ-PATH-value
62
+ NamedHealthCheck,value,interface,"","One dependency to check, under the name the answer reports it by.","Одна залежність до перевірки, під назвою, якою відповідь про неї звітує.",http-NamedHealthCheck-value
63
+ ReadinessOutcome,value,interface,"","What the readiness endpoint answers: whether the service is ready, and how each dependency came back.","Що відповідає точка готовності: чи сервіс готовий і як відповіла кожна залежність.",http-ReadinessOutcome-value
64
+ READYZ_PATH,value,const,"","The path that answers whether this service can take traffic, after every mounted dependency has been asked.","Шлях, який відповідає, чи цей сервіс може брати трафік, після того як опитано кожну змонтовану залежність.",http-READYZ-PATH-value
65
+ RunHealthCheck,value,type,"",Runs a readiness check and returns its Exit.,Виконує перевірку готовності і повертає її `Exit`.,http-RunHealthCheck-value
66
+ checkReadiness,procedure,"<R>(options: HealthRoutesOptions<R>) => Effect.Effect<ReadinessOutcome>","","Runs every check independently, in parallel, under its own deadline.","Виконує кожну перевірку незалежно, паралельно, під її власним строком.",http-checkReadiness-procedure
67
+ healthRoutesFetch,procedure,"<R>(options: HealthRoutesOptions<R>) => ((request: Request) => Promise<Response | null>)","",Handles the three readiness endpoints.,Обробляє три точки готовності.,http-healthRoutesFetch-procedure
68
+ - mechanism: money
69
+ import: @satorio/machinery/money
70
+ kind: foundation
71
+ page: mechanisms/money
72
+ what: "Public entry to the money mechanism, over dinero.js, the optional peer your service installs: exact amounts of one currency, shares, rates, and rounding."
73
+ whatUk: "Публічний вхід до механізму money, над dinero.js, спільною залежністю, яку ставить ваш сервіс: точні суми однієї валюти, частки, курси й округлення."
74
+ rows[41]{name,kind,signature,fallback,caption,captionUk,anchor}:
75
+ Currency,value,DineroCurrency<bigint>,"","One currency of the ISO 4217 table: its code, the base it counts in, and how many decimals one unit holds.","Одна валюта з таблиці ISO 4217: її код, основа, якою вона рахує, і скільки десяткових знаків тримає одна одиниця.",money-Currency-value
76
+ ExchangeRate,value,interface,"","How many units of the currency you are going to, one unit of the currency you are coming from buys.","Скільки одиниць валюти, у яку ви йдете, купує одна одиниця валюти, з якої ви йдете.",money-ExchangeRate-value
77
+ Money,value,Dinero<bigint>,"",An exact amount of one currency.,Точна сума однієї валюти.,money-Money-value
78
+ Percent,value,interface,"","A share of an amount, held exactly.","Частка суми (share), яку тримають точно.",money-Percent-value
79
+ PercentFromPercentageString,value,"Schema.Schema<Percent, string>","","Reads a share off the wire in the form a price list writes: `30` means thirty percent.","Читає частку з дроту у формі, якою пише прайс-лист: `30` означає тридцять відсотків.",money-PercentFromPercentageString-value
80
+ PercentFromRatioString,value,"Schema.Schema<Percent, string>","","Reads a share off the wire in the form a table of rates writes: `0.3` means thirty percent.","Читає частку з дроту у формі, якою пише таблиця ставок: `0.3` означає тридцять відсотків.",money-PercentFromRatioString-value
81
+ addMoney,procedure,"(left: Money, right: Money) => Either.Either<Money, CurrenciesDoNotMeetError>","",Adds two amounts of one currency.,Додає дві суми однієї валюти.,money-addMoney-procedure
82
+ atRate,procedure,"(amount: Money, target: Currency, rate: ExchangeRate) => Money","","Turns an amount into another currency at the rate you name, keeping every digit of the product.","Переводить суму в іншу валюту за названим вами курсом, зберігаючи кожну цифру добутку.",money-atRate-procedure
83
+ compareMoney,procedure,"(left: Money, right: Money) => Either.Either<number, CurrenciesDoNotMeetError>","",Puts two amounts of one currency in order.,Ставить дві суми однієї валюти по порядку.,money-compareMoney-procedure
84
+ currencyCodeOf,procedure,"(currency: Currency) => string","",Writes a currency back as the three letters ISO 4217 gives it.,"Пише валюту назад трьома літерами, які дає їй ISO 4217.",money-currencyCodeOf-procedure
85
+ currencyOf,procedure,"(code: string) => Either.Either<Currency, NotACurrencyCodeError>","","Reads a currency code somebody wrote: `USD`, `EUR`, `UAH`.","Читає код валюти, який хтось написав: `USD`, `EUR`, `UAH`.",money-currencyOf-procedure
86
+ currencyOfMoney,procedure,"(amount: Money) => Currency","",The currency an amount is counted in.,"Валюта, у якій порахована сума.",money-currencyOfMoney-procedure
87
+ decimalsOf,procedure,"(currency: Currency) => number","","How many decimals one unit of this currency holds: two for a currency counted in cents, zero for one counted in whole units.","Скільки десяткових знаків тримає одна одиниця цієї валюти: два для валюти, що рахує центами, нуль для тієї, що рахує цілими.",money-decimalsOf-procedure
88
+ exchangeRateFromDecimalForm,procedure,"(text: string) => Either.Either<ExchangeRate, NotAnExchangeRateError>","","Reads a rate somebody wrote: `0.89`, `41.57306`.","Читає курс, який хтось написав: `0.89`, `41.57306`.",money-exchangeRateFromDecimalForm-procedure
89
+ exchangeRateInDecimalForm,procedure,"(rate: ExchangeRate) => string","","Writes a rate back, trimmed, the way the source that published it wrote it: `0.89`.","Пише курс назад, обрізаним, так, як його написало джерело, що його опублікувало: `0.89`.",money-exchangeRateInDecimalForm-procedure
90
+ minorUnitsOf,procedure,"(amount: Money) => bigint","","The amount counted in the currency's own smallest unit, rounded to it by the one policy this mechanism keeps.","Сума, порахована у власній найдрібнішій одиниці (minor unit) валюти, округлена до неї єдиним правилом, яке тримає цей механізм.",money-minorUnitsOf-procedure
91
+ money,procedure,"(currency: Currency, minorUnits: bigint) => Money","","An amount counted in the currency's own smallest unit: 4055 minor units of a currency counted in cents is 40.55.","Сума, порахована у власній найдрібнішій одиниці валюти: 4055 таких одиниць валюти, що рахує центами, — це 40.55.",money-money-procedure
92
+ moneyAtScale,procedure,"(currency: Currency, units: bigint, scale: bigint) => Money","","An amount held at a scale finer than the currency's own, so a calculation drops no digit.","Сума, яку тримають у масштабі тоншому за власний масштаб валюти, тож розрахунок не губить жодної цифри.",money-moneyAtScale-procedure
93
+ moneyFromDecimalForm,procedure,"(currency: Currency, text: string) => Either.Either<Money, NotAnAmountError>","","Reads an amount somebody wrote: `40.0455`, `-25`, `0.10`.","Читає суму, яку хтось написав: `40.0455`, `-25`, `0.10`.",money-moneyFromDecimalForm-procedure
94
+ MoneyFromDecimalString,procedure,"(currency: Currency) => Schema.Schema<Money, string>","","Reads and writes an amount on the wire as decimal text, in the currency you name.","Читає і пише суму на дроті десятковим текстом, у названій вами валюті.",money-MoneyFromDecimalString-procedure
95
+ moneyInDecimalForm,procedure,"(amount: Money) => string","","Writes an amount for the wire and for a person: `40.0455`, `-25.00`.","Пише суму для дроту і для людини: `40.0455`, `-25.00`.",money-moneyInDecimalForm-procedure
96
+ negatedMoney,procedure,"(amount: Money) => Money","","Turns an amount around: what was owed becomes what is owed back.","Обертає суму: те, що були винні, стає тим, що винні назад.",money-negatedMoney-procedure
97
+ percentFromPercentageForm,procedure,"(text: string) => Either.Either<Percent, NotAPercentError>","","Reads the form a price list writes: `30` means thirty percent.","Читає форму, якою пише прайс-лист: `30` означає тридцять відсотків.",money-percentFromPercentageForm-procedure
98
+ percentFromRatioForm,procedure,"(text: string) => Either.Either<Percent, NotAPercentError>","","Reads the form a table of rates writes: `0.3` means thirty percent.","Читає форму, якою пише таблиця ставок: `0.3` означає тридцять відсотків.",money-percentFromRatioForm-procedure
99
+ percentInPercentageForm,procedure,"(percent: Percent) => string","","Writes the percentage form back, trimmed: thirty percent reads `30`.","Пише відсоткову форму назад, обрізаною: тридцять відсотків читаються як `30`.",money-percentInPercentageForm-procedure
100
+ percentInRatioForm,procedure,"(percent: Percent) => string","","Writes the ratio form back, trimmed: thirty percent reads `0.3`.","Пише форму відношення назад, обрізаною: тридцять відсотків читаються як `0.3`.",money-percentInRatioForm-procedure
101
+ percentOf,procedure,"(amount: Money, percent: Percent) => Money","",Takes a share of an amount and keeps every digit of the product.,Бере частку від суми і зберігає кожну цифру добутку.,money-percentOf-procedure
102
+ roundedToTheCent,procedure,"(amount: Money) => Money","","Rounds an amount to the currency's own smallest unit, half away from zero.","Округлює суму до власної найдрібнішої одиниці валюти, половину — геть від нуля.",money-roundedToTheCent-procedure
103
+ sameMoney,procedure,"(left: Money, right: Money) => boolean","",Whether two amounts are the same amount.,Чи дві суми є однією сумою.,money-sameMoney-procedure
104
+ samePercent,procedure,"(left: Percent, right: Percent) => boolean","","Whether two shares are the same share, whichever form each was read from.","Чи дві частки є однією часткою, з якої б форми кожну не прочитали.",money-samePercent-procedure
105
+ scaleOfMoney,procedure,"(amount: Money) => bigint","","The scale an amount is currently held at: how many decimals its own units are counted in, which grows as a calculation keeps precision.","Масштаб, у якому суму тримають зараз: скількома десятковими знаками рахують її власні одиниці, і він росте, поки розрахунок береже точність.",money-scaleOfMoney-procedure
106
+ sharesOf,procedure,"(amount: Money, proportions: readonly bigint[]) => Either.Either<readonly Money[], ProportionsDoNotSplitError>","",Splits an amount into shares that add back up to exactly what went in.,"Ділить суму на частки, які складаються назад рівно в те, що зайшло.",money-sharesOf-procedure
107
+ sumOfMoney,procedure,"(currency: Currency, amounts: readonly Money[]) => Either.Either<Money, CurrenciesDoNotMeetError>","","Adds up any number of amounts, starting from nothing in the currency you name.","Додає будь-яку кількість сум, починаючи від нуля в названій вами валюті.",money-sumOfMoney-procedure
108
+ zeroMoney,procedure,"(currency: Currency) => Money","","Nothing at all, in one currency.","Нічого взагалі, в одній валюті.",money-zeroMoney-procedure
109
+ CurrenciesDoNotMeetError,failure,"Data.TaggedError<{ readonly left: string; readonly right: string }>","",Two amounts in two currencies were asked to meet.,Дві суми у двох валютах попросили зустрітись.,money-CurrenciesDoNotMeetError-failure
110
+ MoneyFailure,failure,type,"",Every way this mechanism refuses a value.,"Кожен спосіб, яким цей механізм відмовляє значенню.",money-MoneyFailure-failure
111
+ NotACurrencyCodeError,failure,"Data.TaggedError<{ readonly text: string }>","",The text handed in does not name a currency this mechanism knows.,"Поданий текст не називає валюти, яку знає цей механізм.",money-NotACurrencyCodeError-failure
112
+ NotAnAmountError,failure,"Data.TaggedError<{ readonly text: string }>","",The text handed in does not write an amount.,Поданий текст не пише суми.,money-NotAnAmountError-failure
113
+ NotAnExchangeRateError,failure,"Data.TaggedError<{ readonly text: string }>","",The text handed in does not write an exchange rate.,Поданий текст не пише курсу обміну.,money-NotAnExchangeRateError-failure
114
+ NotAPercentError,failure,"Data.TaggedError<{ readonly text: string; readonly form: 'percentage' | 'ratio' }>","",The text handed in does not write a percent.,Поданий текст не пише відсотка.,money-NotAPercentError-failure
115
+ ProportionsDoNotSplitError,failure,"Data.TaggedError<{ readonly proportions: readonly bigint[] }>","",The proportions handed in cannot split an amount.,Подані пропорції не ділять суми.,money-ProportionsDoNotSplitError-failure
116
+ - mechanism: ports
117
+ import: @satorio/machinery/ports
118
+ kind: foundation
119
+ page: mechanisms/ports
120
+ what: "Public entry to the ports mechanism: every boundary a use case may ask for, and the failure each one raises."
121
+ whatUk: "Публічний вхід до механізму ports: кожна межа, яку може попросити процедура (use case), і відмова (refusal), яку піднімає кожна з них."
122
+ rows[42]{name,kind,signature,fallback,caption,captionUk,anchor}:
123
+ BlobStoreShape,value,interface,"",The blob store's operations.,Операції сховища об'єктів (blob store).,ports-BlobStoreShape-value
124
+ claimAccepted,value,ProcessedEventClaim,"","The claim nobody had taken yet, so this run is the one that does the work.","Резервація (claim-once), якої ще ніхто не взяв, тож саме цей прогін робить роботу.",ports-claimAccepted-value
125
+ ClaimProcessedEventInput,value,interface,"","What a claim needs: which event is being claimed, and the moment it is claimed at.","Що потрібно резервації: яку подію резервують і в яку мить це роблять.",ports-ClaimProcessedEventInput-value
126
+ DocumentNumberCounterShape,value,interface,"","What the counter offers: one call that moves a client's month on and hands back the count the next document takes.","Що пропонує лічильник: один виклик, який рухає місяць клієнта далі й подає лічбу, яку візьме наступний документ.",ports-DocumentNumberCounterShape-value
127
+ DocumentNumberCountInput,value,interface,"","Which counter to move on: one client, one reporting month.","Який лічильник рухати далі: один клієнт, один звітний місяць (reporting month).",ports-DocumentNumberCountInput-value
128
+ EventPublisherShape,value,interface,"","What a publisher offers: one call that sends a batch of outbox messages out of this service.","Що пропонує публікатор: один виклик, який надсилає пачку повідомлень із буфера трансмітера (outbox) геть із цього сервісу.",ports-EventPublisherShape-value
129
+ ExternalHttpClientShape,value,interface,"","One external HTTP service, read through one operation.","Один зовнішній HTTP-сервіс, прочитаний однією операцією.",ports-ExternalHttpClientShape-value
130
+ IntegrationEventOutboxShape,value,interface,"",The outbox holds messages a use case enqueues in the same transaction as its state change.,"Буфер трансмітера тримає повідомлення, які процедура ставить у чергу тією самою транзакцією, що й свою зміну стану.",ports-IntegrationEventOutboxShape-value
131
+ OutboxMessage,value,interface,"","One message waiting in the outbox: its own id, what it is, which schema shaped it, when it happened, and what it carries.","Одне повідомлення, що чекає в буфері трансмітера: власний ідентифікатор, що воно таке, яка схема надала йому форми, коли воно сталось і що воно несе.",ports-OutboxMessage-value
132
+ PORT_FAILURES_IN_THE_EVENTS_LANGUAGE,value,"Readonly<Record<string, string>>","","A port failure named in the event's language rather than as `<Port>UnavailableError`, with the sentence that earns the exception.","Відмова порту, названа мовою події, а не як `<Port>UnavailableError`, разом із реченням, яке заслуговує на цей виняток.",ports-PORT-FAILURES-IN-THE-EVENTS-LANGUAGE-value
133
+ ProcessedEventClaim,value,type,"","The two states of the claim-once lock: this run took the event, or somebody already had.","Два стани замка резервації: цей прогін узяв подію, або хтось уже взяв її раніше.",ports-ProcessedEventClaim-value
134
+ ProcessedEventRegistryShape,value,interface,"","What the claim-once lock offers: one call that either takes an event for the first time or says when it was taken before.","Що пропонує замок резервації: один виклик, який або бере подію вперше, або каже, коли її взяли раніше.",ports-ProcessedEventRegistryShape-value
135
+ QueueMessageProducerShape,value,interface,"","What a producer offers: one call that puts a message body onto the queue.","Що пропонує відправник: один виклик, який кладе тіло повідомлення в чергу.",ports-QueueMessageProducerShape-value
136
+ QueueMessageSourceShape,value,interface,"","A source of queue messages: it receives a batch and acknowledges what was taken.","Джерело повідомлень черги: воно отримує пачку і підтверджує взяте.",ports-QueueMessageSourceShape-value
137
+ RawQueueMessage,value,interface,"","One message as the queue hands it over: its own id, the receipt an acknowledgement quotes, and the body, still text.","Одне повідомлення таким, яким його віддає черга: власний ідентифікатор, квитанція, яку цитує підтвердження, і тіло, ще текстом.",ports-RawQueueMessage-value
138
+ ReadinessProbeShape,value,interface,"","What a readiness probe offers: one check that the database answers, so the endpoint reports a dependency rather than a guess.","Що пропонує проба готовності: одна перевірка того, що база відповідає, тож точка звітує про залежність, а не про здогад.",ports-ReadinessProbeShape-value
139
+ StoredBlob,value,interface,"","A stored blob's bytes, content type, and free-form text metadata.","Байти збереженого об'єкта, його тип вмісту і довільні текстові метадані.",ports-StoredBlob-value
140
+ TransactionBoundaryShape,value,interface,"","What a transaction boundary offers: one call that runs work inside a transaction, and rolls the whole of it back when the work fails.","Що пропонує межа транзакції: один виклик, який виконує роботу всередині транзакції і відкочує її цілком, коли робота падає.",ports-TransactionBoundaryShape-value
141
+ alreadyProcessed,procedure,"(processedAt: DateTime.Utc) => ProcessedEventClaim","","The claim somebody else already took, with the moment they took it.","Резервація, яку хтось уже взяв, разом із миттю, коли він її взяв.",ports-alreadyProcessed-procedure
142
+ portUnavailable,procedure,"<E>(Unavailable: new (fields: { readonly operation: string; readonly cause: unknown }) => E)","","Builds the \"did not answer\" failure factory around one port's own `<Port>UnavailableError` constructor.",Будує фабрику відмов «не відповів» навколо власного конструктора `<Port>UnavailableError` одного порту.,ports-portUnavailable-procedure
143
+ BlobStore,port,Context.Tag('BlobStore'),"",The port a use case asks for when it stores whole objects under a key and reads them back.,"Порт, який просить процедура, коли зберігає цілі об'єкти під ключем і читає їх назад.",ports-BlobStore-port
144
+ DocumentNumberCounter,port,Context.Tag('DocumentNumberCounter'),"",The port a use case asks for when it numbers a document a person will read.,"Порт, який просить процедура, коли нумерує документ, що його читатиме людина.",ports-DocumentNumberCounter-port
145
+ EventPublisher,port,Context.Tag('EventPublisher'),"",The port the outbox relay asks for when it announces what has already happened.,"Порт, який просить трансмітер вихідних подій (outbox relay), коли оголошує те, що вже сталось.",ports-EventPublisher-port
146
+ ExternalHttpClient,port,Context.Tag('ExternalHttpClient'),"",The port a use case asks for when it reads reference data from a service outside this one.,"Порт, який просить процедура, коли читає довідкові дані із сервісу поза цим.",ports-ExternalHttpClient-port
147
+ IntegrationEventOutbox,port,"Context.Tag( 'IntegrationEventOutbox', )","",The port a use case asks for when it enqueues an event in the same transaction as the state change that caused it.,"Порт, який просить процедура, коли ставить подію в чергу тією самою транзакцією, що й зміну стану, яка її спричинила.",ports-IntegrationEventOutbox-port
148
+ ProcessedEventRegistry,port,"Context.Tag( 'ProcessedEventRegistry', )","","The port a use case asks for when an event must be acted on exactly once, however many times it arrives.","Порт, який просить процедура, коли подію треба відпрацювати рівно раз, хоч би скільки разів вона прийшла.",ports-ProcessedEventRegistry-port
149
+ QueueMessageProducer,port,Context.Tag('QueueMessageProducer'),"",The port a use case asks for when it sends a message to a queue.,"Порт, який просить процедура, коли надсилає повідомлення в чергу.",ports-QueueMessageProducer-port
150
+ QueueMessageSource,port,Context.Tag('QueueMessageSource'),"",The port a consumer asks for when it receives messages from a queue and acknowledges what it took.,"Порт, який просить робітник, коли отримує повідомлення з черги і підтверджує взяте.",ports-QueueMessageSource-port
151
+ ReadinessProbe,port,Context.Tag('ReadinessProbe'),"",The port the readiness endpoint asks for when it has to say whether this service can take traffic.,"Порт, який просить точка готовності, коли має сказати, чи цей сервіс може брати трафік.",ports-ReadinessProbe-port
152
+ TransactionBoundary,port,Context.Tag('TransactionBoundary'),"",The port a use case asks for when its writes must land together or not at all.,"Порт, який просить процедура, коли її записи мають лягти разом або не лягти зовсім.",ports-TransactionBoundary-port
153
+ BlobStoreUnavailableError,failure,"Data.TaggedError<{ readonly operation: string; readonly cause: unknown }>","",The object store did not answer; a key that is not there at all is never this failure.,"Сховище об'єктів не відповіло; ключ, якого там просто немає, ніколи не є цією відмовою.",ports-BlobStoreUnavailableError-failure
154
+ DatabaseDidNotAnswerError,failure,"Data.TaggedError<{ readonly reason: string }>","",The readiness check against the database did not come back; `reason` says what stopped it.,"Перевірка готовності проти бази не повернулась; `reason` каже, що її спинило.",ports-DatabaseDidNotAnswerError-failure
155
+ DocumentNumberCounterUnavailableError,failure,"Data.TaggedError<{ readonly operation: string; readonly cause: unknown }>","",The counter behind a document number did not answer; `operation` names the call and `cause` carries the driver's own error.,"Лічильник за номером документа не відповів; `operation` називає виклик, а `cause` несе власну помилку драйвера.",ports-DocumentNumberCounterUnavailableError-failure
156
+ EventPublisherUnavailableError,failure,"Data.TaggedError<{ readonly operation: string; readonly cause: unknown }>","","The publisher did not answer, or no topic is configured; `cause` says which of the two it was.","Публікатор не відповів, або топік не налаштований; `cause` каже, що з двох сталось.",ports-EventPublisherUnavailableError-failure
157
+ ExternalServiceRefusedError,failure,"Data.TaggedError<{ readonly service: string; readonly operation: string; readonly status: number }>","","The external service answered with a refusal of its own, so the same request will fail again until the request changes.","Зовнішній сервіс відповів власною відмовою, тож той самий запит падатиме знову, доки запит не зміниться.",ports-ExternalServiceRefusedError-failure
158
+ ExternalServiceResponseMalformedError,failure,"Data.TaggedError<{ readonly service: string; readonly operation: string; readonly cause: unknown }>","","The external service answered, but the body did not fit the schema the caller handed in.","Зовнішній сервіс відповів, але тіло не лягло в схему, яку подав викликач.",ports-ExternalServiceResponseMalformedError-failure
159
+ ExternalServiceUnavailableError,failure,"Data.TaggedError<{ readonly service: string; readonly operation: string; readonly cause: unknown }>","","A network failure, a timeout, or a server error after the retries ran out; the same request may well succeed later.","Мережева невдача, вичерпаний строк або помилка сервера після того, як скінчились спроби; той самий запит цілком може вдатись пізніше.",ports-ExternalServiceUnavailableError-failure
160
+ IntegrationEventOutboxUnavailableError,failure,"Data.TaggedError<{ readonly operation: string; readonly cause: unknown }>","",The outbox driver did not answer; `operation` names the call and `cause` carries the driver's own error.,"Драйвер буфера трансмітера не відповів; `operation` називає виклик, а `cause` несе власну помилку драйвера.",ports-IntegrationEventOutboxUnavailableError-failure
161
+ ProcessedEventRegistryUnavailableError,failure,"Data.TaggedError<{ readonly operation: string; readonly cause: unknown }>","",The claim-once driver did not answer; `operation` names the call and `cause` carries the driver's own error.,"Драйвер резервації не відповів; `operation` називає виклик, а `cause` несе власну помилку драйвера.",ports-ProcessedEventRegistryUnavailableError-failure
162
+ QueueMessageProducerUnavailableError,failure,"Data.TaggedError<{ readonly operation: string; readonly cause: unknown }>","",The queue producer did not answer; `operation` names the call and `cause` carries the driver's own error.,"Відправник черги не відповів; `operation` називає виклик, а `cause` несе власну помилку драйвера.",ports-QueueMessageProducerUnavailableError-failure
163
+ QueueMessageSourceUnavailableError,failure,"Data.TaggedError<{ readonly operation: string; readonly cause: unknown }>","",The queue source did not answer; `operation` names the call and `cause` carries the driver's own error.,"Джерело черги не відповіло; `operation` називає виклик, а `cause` несе власну помилку драйвера.",ports-QueueMessageSourceUnavailableError-failure
164
+ TransactionBoundaryUnavailableError,failure,"Data.TaggedError<{ readonly operation: string; readonly cause: unknown }>","",The transaction driver did not answer; `operation` names the call and `cause` carries the driver's own error.,"Драйвер транзакції не відповів; `operation` називає виклик, а `cause` несе власну помилку драйвера.",ports-TransactionBoundaryUnavailableError-failure
165
+ - mechanism: time
166
+ import: @satorio/machinery/time
167
+ kind: foundation
168
+ page: mechanisms/time
169
+ what: "Public entry to the time mechanism: a day a person reads and writes, a period of days, and a moment on the clock."
170
+ whatUk: "Публічний вхід до механізму time: день, який людина читає і пише, період (period) днів і мить на годиннику."
171
+ rows[33]{name,kind,signature,fallback,caption,captionUk,anchor}:
172
+ CalendarDay,value,type,"","One day of the calendar, with no time and no zone in it.","Один день календаря, без часу і без зони всередині.",time-CalendarDay-value
173
+ CalendarDayFromHumanString,value,"Schema.Schema<CalendarDay, string>","","Reads a day off the wire from the form a person writes, and writes it back in that same form.","Читає день із дроту у формі, якою пише людина, і пише його назад тією самою формою.",time-CalendarDayFromHumanString-value
174
+ CalendarDayOrder,value,Order.Order<CalendarDay>,"","Puts two days in calendar order, earliest first.","Ставить два дні в календарному порядку, раніший першим.",time-CalendarDayOrder-value
175
+ CalendarDayRefusalReason,value,type,"",Why a written day is not a calendar day.,Чому написаний день не є календарним днем (calendar day).,time-CalendarDayRefusalReason-value
176
+ Instant,value,interface,"","One moment on the world's clock, held as whole milliseconds since the start of 1970.","Одна мить на світовому годиннику, яку тримають цілими мілісекундами від початку 1970 року.",time-Instant-value
177
+ Period,value,interface,"",A run of calendar days.,Пробіг календарних днів.,time-Period-value
178
+ TimeZone,value,type,"","One named time zone, as the runtime's own zone table knows it.","Одна названа часова зона (time zone), така, якою її знає власна таблиця зон рантайму.",time-TimeZone-value
179
+ addDays,procedure,"(day: CalendarDay, days: number) => CalendarDay","",Moves a day by whole days.,Рухає день на цілі дні.,time-addDays-procedure
180
+ addMonths,procedure,"(day: CalendarDay, months: number) => CalendarDay","","Moves a day by whole months, landing on the last day of a month too short to hold it.","Рухає день на цілі місяці і сідає на останній день місяця, надто короткого, щоб його вмістити.",time-addMonths-procedure
181
+ calendarDayFromHumanForm,procedure,"(text: string) => Either.Either<CalendarDay, NotACalendarDayError>","","Reads the form a person writes a day in: `19.03.2026`.","Читає форму, якою день пише людина: `19.03.2026`.",time-calendarDayFromHumanForm-procedure
182
+ calendarDayFromIsoForm,procedure,"(text: string) => Either.Either<CalendarDay, NotACalendarDayError>","","Reads the form a machine writes a day in: `2026-03-19`.","Читає форму, якою день пише машина: `2026-03-19`.",time-calendarDayFromIsoForm-procedure
183
+ dateTimeOfInstant,procedure,"(instant: Instant) => DateTime.Utc","","Hands a moment back as Effect's own UTC value, for a row, an envelope, or any code that already speaks that type.","Подає мить назад власним значенням UTC від Effect — для рядка бази, конверта чи будь-якого коду, який уже говорить тим типом.",time-dateTimeOfInstant-procedure
184
+ dayInHumanForm,procedure,"(day: CalendarDay) => string","","Writes a day the way a person reads it: `19.03.2026`.","Пише день так, як його читає людина: `19.03.2026`.",time-dayInHumanForm-procedure
185
+ dayInIsoForm,procedure,"(day: CalendarDay) => string","","Writes a day the way a machine reads it: `2026-03-19`.","Пише день так, як його читає машина: `2026-03-19`.",time-dayInIsoForm-procedure
186
+ dayOfInstant,procedure,"(instant: Instant, zone: TimeZone) => CalendarDay","",The calendar day a moment falls on for a person standing in that zone.,"Календарний день, на який припадає мить для людини, що стоїть у тій зоні.",time-dayOfInstant-procedure
187
+ daysBetween,procedure,"(earlier: CalendarDay, later: CalendarDay) => number","",Counts whole days from the first day to the second.,Рахує цілі дні від першого дня до другого.,time-daysBetween-procedure
188
+ instantInHumanForm,procedure,"(instant: Instant, zone: TimeZone) => string","","Writes a moment the way a person in that zone reads it: `19.03.2026 14:05 +02:00`.","Пише мить так, як її читає людина в тій зоні: `19.03.2026 14:05 +02:00`.",time-instantInHumanForm-procedure
189
+ instantOfDateTime,procedure,"(moment: DateTime.Utc) => Instant","",Takes a moment the machinery already holds as Effect's own UTC value.,"Бере мить, яку машинерія вже тримає власним значенням UTC від Effect.",time-instantOfDateTime-procedure
190
+ lastDayOfTheMonthOf,procedure,"(day: CalendarDay) => CalendarDay","",The last day of the month the given day falls in.,"Останній день місяця, на який припадає поданий день.",time-lastDayOfTheMonthOf-procedure
191
+ lengthInDays,procedure,"(period: Period) => number","","Counts the days a period holds, both bounds included.","Рахує дні, які тримає період, разом з обома краями.",time-lengthInDays-procedure
192
+ monthOf,procedure,"(day: CalendarDay) => Period","","The whole calendar month the given day falls in, as a period.","Цілий календарний місяць, на який припадає поданий день, як період.",time-monthOf-procedure
193
+ monthsOf,procedure,"(period: Period) => readonly Period[]","","Cuts a period into one part per calendar month it runs over, in order.","Ріже період на одну частину для кожного календарного місяця, через який він біжить, по порядку.",time-monthsOf-procedure
194
+ periodContains,procedure,"(period: Period, day: CalendarDay) => boolean","",Answers whether the day belongs to the period.,"Відповідає, чи день належить періоду.",time-periodContains-procedure
195
+ periodOf,procedure,"(from: CalendarDay, to: CalendarDay) => Either.Either<Period, PeriodEndsBeforeItStartsError>","","Takes two days as a period, earliest first.","Бере два дні як період, раніший першим.",time-periodOf-procedure
196
+ periodsOverlap,procedure,"(left: Period, right: Period) => boolean","",Answers whether two periods share at least one day.,"Відповідає, чи два періоди ділять хоч один день.",time-periodsOverlap-procedure
197
+ startOfDay,procedure,"(day: CalendarDay, zone: TimeZone) => Instant","",The moment a calendar day begins in that zone.,"Мить, якою календарний день починається в тій зоні.",time-startOfDay-procedure
198
+ todayIn,procedure,"(zone: TimeZone) => Effect.Effect<CalendarDay>","","Today, as the calendar of that zone counts it, read from the clock the service already shares.","Сьогодні, як його рахує календар тієї зони, прочитане з годинника, який сервіс уже поділяє.",time-todayIn-procedure
199
+ zoneIdOf,procedure,"(zone: TimeZone) => string","","Reads the IANA name back out of a zone, for a log line or a row.",Читає назву IANA назад із зони — для рядка лога чи для рядка бази.,time-zoneIdOf-procedure
200
+ zoneNamed,procedure,"(zoneId: string) => Either.Either<TimeZone, UnknownTimeZoneError>","","Takes an IANA zone name, and refuses a name the runtime does not know.","Бере назву зони IANA і відмовляє назві, якої рантайм не знає.",time-zoneNamed-procedure
201
+ NotACalendarDayError,failure,"Data.TaggedError<{ readonly text: string; readonly reason: CalendarDayRefusalReason }>","",The text a reader was handed does not name a day any calendar holds.,"Текст, поданий читачеві, не називає дня, який тримає бодай один календар.",time-NotACalendarDayError-failure
202
+ PeriodEndsBeforeItStartsError,failure,"Data.TaggedError<{ readonly from: string; readonly to: string }>","",The two days handed in run backwards.,Два подані дні біжать назад.,time-PeriodEndsBeforeItStartsError-failure
203
+ TimeFailure,failure,type,"",Every way this mechanism refuses a value.,"Кожен спосіб, яким цей механізм відмовляє значенню.",time-TimeFailure-failure
204
+ UnknownTimeZoneError,failure,"Data.TaggedError<{ readonly zoneId: string }>","",The runtime has no zone under that name.,Рантайм не має зони під такою назвою.,time-UnknownTimeZoneError-failure
205
+ - mechanism: identifiers
206
+ import: @satorio/machinery/identifiers
207
+ kind: foundation
208
+ page: mechanisms/identifiers
209
+ what: "Public entry to the identifiers mechanism: the id a machine mints, and the numbers a person reads off a document."
210
+ whatUk: "Публічний вхід до механізму identifiers: ідентифікатор, який карбує машина, і номери, які людина читає з документа."
211
+ rows[28]{name,kind,signature,fallback,caption,captionUk,anchor}:
212
+ ClientCode,value,"string & { readonly [clientCodeBrand]: 'ClientCode' }","","The number a client quotes back to you: eight digits, the last of which checks the other seven.","Номер, який клієнт диктує вам назад: вісім цифр, остання з яких перевіряє сім інших.",identifiers-ClientCode-value
213
+ CreditorReference,value,type,"","The reference a payer copies into a bank transfer, with its own check digits.","Референс, який платник копіює в банківський переказ, із власними контрольними цифрами (check digit).",identifiers-CreditorReference-value
214
+ DocumentNumber,value,type,"","The number printed on a document, in the form a person reads it.","Номер, надрукований на документі, у формі, якою його читає людина.",identifiers-DocumentNumber-value
215
+ DocumentNumberParts,value,interface,"",What a document number is made of.,З чого складається номер документа.,identifiers-DocumentNumberParts-value
216
+ DocumentNumbers,value,interface,"","The document numbers of one closed set of series: minting bound to that set, reading that refuses any series outside it, and the set itself, so a caller lists its own series in one place and reads them back from the same one.","Номери документів одного переліку серій (series): карбування, прив'язане до того переліку, читання, яке відмовляє будь-якій серії поза ним, і сам перелік.",identifiers-DocumentNumbers-value
217
+ newClientCode,value,Effect.Effect<ClientCode>,"","A fresh client code, drawn from the randomness the service already shares.","Свіжий код клієнта, взятий із випадковості, яку сервіс уже поділяє.",identifiers-newClientCode-value
218
+ newUlid,value,Effect.Effect<Ulid>,"","A fresh identifier, minted from the clock and the randomness the service already shares.","Свіжий ідентифікатор, викарбуваний із годинника й випадковості, які сервіс уже поділяє.",identifiers-newUlid-value
219
+ NextDocumentNumberInput,value,interface,"","Which document to number: its series, who it goes to, and the month it reports on.","Який документ нумерувати: його серія, кому він іде і за який місяць звітує.",identifiers-NextDocumentNumberInput-value
220
+ ulidsInOrder,value,Effect.Effect<Effect.Effect<Ulid>>,"",A maker of identifiers that keep their order even when two of them land inside one millisecond.,"Породжувач ідентифікаторів, які тримають свій порядок навіть тоді, коли два з них падають в одну мілісекунду.",identifiers-ulidsInOrder-value
221
+ clientCodeFrom,procedure,"(text: string) => Either.Either<ClientCode, NotAClientCodeError>","","Reads a client code somebody typed, forgiving the spaces and hyphens a person puts between the groups.","Читає код клієнта, який хтось набрав, прощаючи пробіли й дефіси, що їх людина ставить між групами.",identifiers-clientCodeFrom-procedure
222
+ clientCodeInGroupedForm,procedure,"(code: ClientCode) => string","","The form a person reads off a document: two groups of four.","Форма, якою людина читає код із документа: дві групи по чотири.",identifiers-clientCodeInGroupedForm-procedure
223
+ clientCodeOfDocumentNumber,procedure,"(number: DocumentNumber) => ClientCode","",The client code printed inside a document number.,"Код клієнта, надрукований усередині номера документа.",identifiers-clientCodeOfDocumentNumber-procedure
224
+ creditorReferenceFrom,procedure,"(text: string) => Either.Either<CreditorReference, NotACreditorReferenceError>","","Reads a reference somebody typed, forgiving case, spaces and the hyphens a person copies along with it.","Читає референс, який хтось набрав, прощаючи регістр, пробіли й дефіси, що їх людина копіює разом із ним.",identifiers-creditorReferenceFrom-procedure
225
+ creditorReferenceInGroupedForm,procedure,"(reference: CreditorReference) => string","","The form a person reads off a document and types into a bank: groups of four, the way ISO 11649 prints one.","Форма, якою людина читає референс із документа і набирає його в банку: групи по чотири, як їх друкує ISO 11649.",identifiers-creditorReferenceInGroupedForm-procedure
226
+ creditorReferenceOf,procedure,"(number: DocumentNumber) => CreditorReference","",The payment reference for a document that somebody has to pay.,"Платіжний референс (creditor reference) для документа, який комусь треба сплатити.",identifiers-creditorReferenceOf-procedure
227
+ dammCheckDigit,procedure,"(digits: string) => string | null","","The check digit that makes a run of digits self-checking, by Damm's algorithm.","Контрольна цифра, яка робить пробіг цифр самоперевірним, за алгоритмом Дамма.",identifiers-dammCheckDigit-procedure
228
+ dammHolds,procedure,"(digits: string) => boolean","",Whether a run of digits already carries a check digit that holds.,"Чи пробіг цифр уже несе контрольну цифру, яка тримає.",identifiers-dammHolds-procedure
229
+ digitsOfClientCode,procedure,"(code: ClientCode) => string","","The eight digits with nothing between them, which is the form a document number and a payment reference are built from.","Вісім цифр без нічого між ними — та форма, з якої будують номер документа і платіжний референс.",identifiers-digitsOfClientCode-procedure
230
+ digitsOfCreditorReference,procedure,"(reference: CreditorReference) => string","",The digits of the document number this reference points at.,"Цифри номера документа, на який показує цей референс.",identifiers-digitsOfCreditorReference-procedure
231
+ digitsOfDocumentNumber,procedure,"(number: DocumentNumber) => string","","The digits of a document number with the series and the hyphens taken off, which is what a payment reference is built over.","Цифри номера документа зі знятою серією і дефісами — те, над чим будують платіжний референс.",identifiers-digitsOfDocumentNumber-procedure
232
+ makeDocumentNumbers,procedure,"<const Series extends readonly string[]>(series: ClosedSet<Series>) => DocumentNumbers<Series>","",Binds document numbers to the series one service issues.,"Прив'язує номери документів до серій, які видає один сервіс: які види документів існують — це канон того сервісу, а не цього пакета.",identifiers-makeDocumentNumbers-procedure
233
+ reportingMonthOf,procedure,"(day: CalendarDay) => string","","The two digits of year and two of month a reporting period is written as: March 2026 reads `2603`.","Дві цифри року і дві місяця, якими пишуть звітний період: березень 2026 читається як `2603`.",identifiers-reportingMonthOf-procedure
234
+ ulidOfSeed,procedure,"(moment: DateTime.Utc, seed: string) => Ulid","",The identifier a moment and a seed always mint the same way.,"Ідентифікатор, який мить і зерно завжди карбують однаково.",identifiers-ulidOfSeed-procedure
235
+ withDammCheckDigit,procedure,"(digits: string) => string | null","",The same digits with their check digit written on the end.,"Ті самі цифри з контрольною цифрою, дописаною в кінці.",identifiers-withDammCheckDigit-procedure
236
+ IdentifierFailure,failure,type,"",Every way this mechanism refuses a value.,"Кожен спосіб, яким цей механізм відмовляє значенню.",identifiers-IdentifierFailure-failure
237
+ NotAClientCodeError,failure,"Data.TaggedError<{ readonly text: string }>","",The text handed in is not a client code.,Поданий текст не є кодом клієнта.,identifiers-NotAClientCodeError-failure
238
+ NotACreditorReferenceError,failure,"Data.TaggedError<{ readonly text: string }>","",The text handed in is not a payment reference this mechanism issued.,"Поданий текст не є платіжним референсом, який видав цей механізм.",identifiers-NotACreditorReferenceError-failure
239
+ NotADocumentNumberError,failure,"Data.TaggedError<{ readonly text: string }>","","The parts handed in cannot make a document number, or the text handed in does not read as one.","Подані частини не складають номера документа, або поданий текст не читається як номер.",identifiers-NotADocumentNumberError-failure
240
+ - mechanism: workflow
241
+ import: @satorio/machinery/workflow
242
+ kind: foundation
243
+ page: mechanisms/workflow
244
+ what: "Public entry to the workflow mechanism: the combinators a use case composes its own beat from."
245
+ whatUk: "Публічний вхід до механізму workflow: комбінатори, з яких процедура складає власний такт."
246
+ rows[19]{name,kind,signature,fallback,caption,captionUk,anchor}:
247
+ ClaimOnce,value,type,"","The exactly-once claim: shared ground for every use case that takes an event or command once.","Резервація рівно один раз: спільний ґрунт для кожної процедури, яка бере подію або команду один раз.",workflow-ClaimOnce-value
248
+ DEFAULT_PUBLISH_PENDING_EVENTS_SETTINGS,value,PublishPendingEventsSettings,"",The pace the relay keeps when a service names none of its own.,"Темп, який тримає трансмітер вихідних подій, коли сервіс не називає власного.",workflow-DEFAULT-PUBLISH-PENDING-EVENTS-SETTINGS-value
249
+ OnClaimMatchers,value,interface,"","The two branches `onClaim` takes: what to do when the event was already claimed, and what to do when this run claims it.","Дві гілки, які бере `onClaim`: що робити, коли подію вже зарезервовано, і що робити, коли її резервує цей прогін.",workflow-OnClaimMatchers-value
250
+ PublishPendingEventsSettings,value,interface,"","How the relay paces itself: how many messages one beat takes, and how long it waits between beats.","Як трансмітер вихідних подій задає собі темп: скільки повідомлень бере один такт і скільки він чекає між тактами.",workflow-PublishPendingEventsSettings-value
251
+ UpcastStep,value,interface,"","One lift, from the version it names to the next one up.","Один підйом, від названої версії до наступної вгору.",workflow-UpcastStep-value
252
+ VersionedEventDefinition,value,interface,"",An event stored yesterday is read by today's code.,"Подію, збережену вчора, читає сьогоднішній код.",workflow-VersionedEventDefinition-value
253
+ claimAsProcessedAt,procedure,"(idempotencyKey: string, processedAt: DateTime.Utc) => ClaimOnce","","Claims with a processedAt supplied by the caller, for a handler that has already read the clock and must store that exact moment.","Резервує з `processedAt`, поданим викликачем, — для обробника, який уже прочитав годинник і мусить зберегти саме ту мить.",workflow-claimAsProcessedAt-procedure
254
+ claimAsProcessedNow,procedure,"(idempotencyKey: string) => ClaimOnce","","Claims with the current time, for a caller that only needs the claim.","Резервує з поточним часом — для викликача, якому потрібна лише резервація.",workflow-claimAsProcessedNow-procedure
255
+ decodeStoredPayload,procedure,"<S extends Schema.Schema.AnyNoContext>(definition: VersionedEventDefinition<S>, storedVersion: number, payload: unknown) => Effect.Effect<Schema.Schema.Type<S>, VersionedPayloadFailure | ParseResult.ParseError>","",Lifts a stored payload to the current version and decodes it with the current schema.,Підіймає збережений payload до поточної версії і декодує його поточною схемою.,workflow-decodeStoredPayload-procedure
256
+ keepPublishingPendingEvents,procedure,"(settings: PublishPendingEventsSettings = DEFAULT_PUBLISH_PENDING_EVENTS_SETTINGS) => Effect.Effect<never, never, IntegrationEventOutbox | EventPublisher>","",Runs the outbox relay for as long as the service lives.,"Крутить трансмітер вихідних подій стільки, скільки живе сервіс.",workflow-keepPublishingPendingEvents-procedure
257
+ onClaim,procedure,"<A1, E1, R1, A2, E2, R2, EClaim, RClaim>(claim: Effect.Effect<ProcessedEventClaim, EClaim, RClaim>, matchers: OnClaimMatchers<A1, E1, R1, A2, E2, R2>) => Effect.Effect<A1 | A2, EClaim | E1 | E2, RClaim | R1 | R2>","","Branches on the state of the exactly-once claim: AlreadyProcessed goes one way, ClaimAccepted the other.","Розгалужується на стані резервації: `AlreadyProcessed` іде одним шляхом, `ClaimAccepted` — іншим.",workflow-onClaim-procedure
258
+ publishOneBatch,procedure,"(batchLimit: number) => Effect.Effect<number, PublishPendingEventsFailure, IntegrationEventOutbox | EventPublisher>","","One outbox relay beat: take a batch of undelivered messages, hand it to the publisher, then mark it dispatched.","Один такт трансмітера вихідних подій: узяти пачку недоставлених повідомлень, віддати її публікаторові, тоді позначити її відправленою.",workflow-publishOneBatch-procedure
259
+ transactionally,procedure,"<A, E, R>(work: Effect.Effect<A, E, R>)","","Wraps work in a transaction boundary: pulls TransactionBoundary from context and runs the work through it.","Загортає роботу в межу транзакції: дістає `TransactionBoundary` з контексту і проганяє роботу крізь неї.",workflow-transactionally-procedure
260
+ upcastToCurrentVersion,procedure,"<S extends Schema.Schema.AnyNoContext>(definition: VersionedEventDefinition<S>, storedVersion: number, payload: unknown) => Effect.Effect<unknown, VersionedPayloadFailure>","","Lifts a stored payload from the version it was written at to the version this code reads, one step per version, in order.","Підіймає збережений payload від версії, якою його записали, до версії, яку читає цей код, по одному кроку на версію, по порядку.",workflow-upcastToCurrentVersion-procedure
261
+ MissingUpcastStepError,failure,"Data.TaggedError<{ readonly eventType: string; readonly fromVersion: number; readonly currentVersion: number }>","","One version between the stored payload and the current one has no upcast step, so the lift cannot finish.","Одна версія між збереженим payload і поточною не має кроку підйому, тож підйом не доходить до кінця.",workflow-MissingUpcastStepError-failure
262
+ PublishPendingEventsFailure,failure,type,"","What one beat of the relay can meet: the outbox did not answer, or the publisher did not.","Що може зустріти один такт трансмітера: буфер трансмітера не відповів або публікатор не відповів.",workflow-PublishPendingEventsFailure-failure
263
+ SchemaVersionFromTheFutureError,failure,"Data.TaggedError<{ readonly eventType: string; readonly storedVersion: number; readonly currentVersion: number }>","",The stored payload says it was written by a newer version of this code than the one reading it.,"Збережений payload каже, що його записала новіша версія цього коду, ніж та, що його читає.",workflow-SchemaVersionFromTheFutureError-failure
264
+ UpcastStepFailedError,failure,"Data.TaggedError<{ readonly eventType: string; readonly fromVersion: number; readonly cause: unknown }>","",An upcast step threw while lifting the payload one version up.,"Крок підйому кинув помилку, поки підіймав payload на версію вгору.",workflow-UpcastStepFailedError-failure
265
+ VersionedPayloadFailure,failure,type,"",Every way reading a stored payload can refuse.,"Кожен спосіб, яким читання збереженого payload може відмовити.",workflow-VersionedPayloadFailure-failure
266
+ - mechanism: graphql
267
+ import: @satorio/machinery/graphql
268
+ kind: adapter
269
+ page: mechanisms/graphql
270
+ what: "Public entry to the graphql mechanism: one server that answers your operations and the readiness probes beside them."
271
+ whatUk: "Публічний вхід до механізму graphql: один сервер, який відповідає на ваші операції і на проби готовності поруч із ними."
272
+ rows[22]{name,kind,signature,fallback,caption,captionUk,anchor}:
273
+ ENVIRONMENT,value,"readonly EnvironmentEntry[]","","Every variable this adapter reads, and the one state each of them stands in.","Кожна змінна, яку читає цей адаптер (adapter), і один стан, у якому стоїть кожна з них.",graphql-ENVIRONMENT-value
274
+ EveryFailureIsClassified,value,type,"",The proof that every failure a service can raise is mapped at this boundary.,"Доказ того, що кожну відмову, яку може підняти сервіс, замаплено на цій межі.",graphql-EveryFailureIsClassified-value
275
+ graphiqlEnabledFromEnvironment,value,Config.Config<boolean>,"",Whether to serve the editor page.,Чи віддавати сторінку редактора.,graphql-graphiqlEnabledFromEnvironment-value
276
+ GraphiqlPage,value,interface,"","A GraphiQL page: a title and a pre-filled document.","Сторінка GraphiQL: заголовок і наперед заповнений документ.",graphql-GraphiqlPage-value
277
+ GRAPHQL_ENDPOINT,value,const,"",The one path the GraphQL endpoint answers on.,"Єдиний шлях, на якому відповідає точка GraphQL.",graphql-GRAPHQL-ENDPOINT-value
278
+ GraphQLContext,value,interface,"","What a resolver reads from its context: one call that runs a use case's program and answers with its value or a `GraphQLError`.","Що резолвер читає зі свого контексту: один виклик, який виконує програму процедури і відповідає її значенням або `GraphQLError`.",graphql-GraphQLContext-value
279
+ graphqlPortFromEnvironment,value,Config.Config<number>,"",The port to listen on.,"Порт, на якому слухати.",graphql-graphqlPortFromEnvironment-value
280
+ RunOperationsExit,value,type,"","The minimal capability a resolver borrows from the runtime: run a program that needs `R` and return its `Exit`.","Найменша спроможність, яку резолвер позичає в рантайму: виконати програму, що потребує `R`, і повернути її `Exit`.",graphql-RunOperationsExit-value
281
+ asGraphQLError,procedure,"(failure: OperationFailure | ParseResult.ParseError) => GraphQLError","","Maps a GraphQL failure to a `GraphQLError`: the same three-class operation failure channel, plus input decoder failures — no second catalog.","Мапить відмову GraphQL на `GraphQLError`: той самий канал відмов операції з трьох класів плюс відмови декодера входу — жодного другого каталогу.",graphql-asGraphQLError-procedure
282
+ graphiqlExampleProblems,procedure,"(schema: GraphQLSchema, page: GraphiqlPage) => readonly GraphiqlExampleProblem[]","",Checks a GraphiQL page's default query against a schema.,Звіряє типовий запит сторінки GraphiQL зі схемою.,graphql-graphiqlExampleProblems-procedure
283
+ graphqlContextFrom,procedure,"<R>(runExit: RunOperationsExit<R>) => GraphQLContext<R>","","Builds that context around the runtime's own `runPromiseExit`, so a resolver never touches the runtime directly.","Будує той контекст навколо власного `runPromiseExit` рантайму, тож резолвер ніколи не торкається рантайму напряму.",graphql-graphqlContextFrom-procedure
284
+ makeSubGraphSchemaBuilder,procedure,<Context extends object>(),"",Returns a builder factory carrying the resolver context type.,"Повертає фабрику будівників, яка несе тип контексту резолвера.",graphql-makeSubGraphSchemaBuilder-procedure
285
+ makeYogaServer,procedure,"<R>(options: GraphQLServerOptions<R>) => YogaServerInstance<Record<string, never>, GraphQLContext<R>>","",Builds a Yoga GraphQL server for Bun.,Будує GraphQL-сервер Yoga для Bun.,graphql-makeYogaServer-procedure
286
+ serverCannotListen,procedure,"(port: number, cause: unknown) => ServerCannotListenError","",Turns whatever the runtime threw while opening the socket into the named failure a caller reads.,"Перетворює те, що кинув рантайм, відкриваючи сокет, на названу відмову, яку читає викликач.",graphql-serverCannotListen-procedure
287
+ graphqlServerLive,adapter,"<R>(options: GraphQLRequestHandlerOptions<R>) => Layer.Layer<never, ConfigError.ConfigError | ServerCannotListenError, R>","","The one layer this mechanism mounts: the server that answers your operations.","Єдиний шар, який монтує цей механізм: сервер, що відповідає на ваші операції.",graphql-graphqlServerLive-adapter
288
+ OperationFailure,failure,type,"","Everything a resolver may fail with, as one closed set: not found, rejected, or unavailable.","Усе, чим резолвер може відмовити, як один чітко визначений перелік: не знайдено, відхилено або недоступно.",graphql-OperationFailure-failure
289
+ OperationRejectedError,failure,"Data.TaggedError<{ readonly rule: string; readonly reason: string; readonly detail: string }>","","A resolver's rule rejected the operation, and `reason` names the cause it recognized.","Правило резолвера відхилило операцію, і `reason` називає причину, яку воно розпізнало.",graphql-OperationRejectedError-failure
290
+ OperationsUnavailableError,failure,"Data.TaggedError<{ readonly operation: string; readonly cause: unknown }>","",A resolver's own dependency did not answer; `cause` carries the port's own failure.,Власна залежність резолвера не відповіла; `cause` несе відмову самого порту.,graphql-OperationsUnavailableError-failure
291
+ ServerCannotListenError,failure,"Data.TaggedError<{ readonly port: number; readonly refusal: Refusal; readonly cause: unknown }>","",The socket never opened.,Сокет так і не відкрився.,graphql-ServerCannotListenError-failure
292
+ SubjectNotFoundError,failure,"Data.TaggedError<{ readonly subject: string; readonly id: string }>","",One of exactly three operation failure classes below — the closed set a resolver maps to.,"Один із рівно трьох класів відмови операції нижче — чітко визначений перелік, на який мапить резолвер.",graphql-SubjectNotFoundError-failure
293
+ GRAPHQL_PORT,environment variable,falls back,"4000",The port the GraphQL endpoint and the readiness probes listen on.,"Порт, на якому слухають точка GraphQL і проби готовності.",graphql-GRAPHQL-PORT-environment-variable
294
+ GRAPHIQL_ENABLED,environment variable,falls back,"true",Whether the GraphiQL editor page is served on the same endpoint.,Чи віддається сторінка редактора GraphiQL на тій самій точці.,graphql-GRAPHIQL-ENABLED-environment-variable
295
+ - mechanism: integration
296
+ import: @satorio/machinery/integration
297
+ kind: adapter
298
+ page: mechanisms/integration
299
+ what: "Public entry to the integration mechanism: one HTTP client for reference data outside this service."
300
+ whatUk: "Публічний вхід до механізму integration: один HTTP-клієнт до довідкових даних поза цим сервісом."
301
+ rows[13]{name,kind,signature,fallback,caption,captionUk,anchor}:
302
+ DEFAULT_TIMEOUT_MILLIS,value,const,"",How long one call may take when nobody names a number.,"Скільки може тривати один виклик, коли ніхто не назвав числа.",integration-DEFAULT-TIMEOUT-MILLIS-value
303
+ defaultExternalRetrySchedule,value,"Schedule.Schedule<unknown, unknown>","","How a call waits and tries again: growing pauses, jittered, on a short budget.","Як виклик чекає і пробує знову: зростальні паузи, з джитером, на короткому бюджеті.",integration-defaultExternalRetrySchedule-value
304
+ ENVIRONMENT,value,"readonly EnvironmentEntry[]","","Every variable this adapter reads, and the one state each of them stands in.","Кожна змінна, яку читає цей адаптер, і один стан, у якому стоїть кожна з них.",integration-ENVIRONMENT-value
305
+ ExternalServiceSettings,value,interface,"","What a client needs before it can call: the address every request goes under, and how long one call may take.","Що потрібно клієнтові, перш ніж він подзвонить: адреса, під яку йде кожен запит, і скільки може тривати один виклик.",integration-ExternalServiceSettings-value
306
+ baseUrlVariable,procedure,"(variablePrefix: string) => string","",Builds the environment variable name from the prefix the application gives at mount time.,"Будує назву змінної оточення з префікса, який застосунок дає під час монтування.",integration-baseUrlVariable-procedure
307
+ externalHttpClientUnavailableWithoutConfiguration,procedure,"(service: string, refusal: Refusal) => ExternalHttpClientShape","","The client that stands in when nobody set the address, and fails every call loudly.","Клієнт, який стоїть замість справжнього, коли адресу ніхто не поставив, і гучно валить кожен виклик.",integration-externalHttpClientUnavailableWithoutConfiguration-procedure
308
+ externalServiceSettings,procedure,"(variablePrefix: string) => Config.Config<ExternalServiceSettings>","",Reads every variable of `ENVIRONMENT` under one prefix.,Читає кожну змінну з `ENVIRONMENT` під одним префіксом.,integration-externalServiceSettings-procedure
309
+ makeExternalHttpClient,procedure,"(service: string, settings: ExternalServiceSettings) => Effect.Effect<ExternalHttpClientShape, never, HttpClient.HttpClient>","","A ready-to-use client, with its transport already captured.",Готовий до вжитку клієнт із уже захопленим транспортом.,integration-makeExternalHttpClient-procedure
310
+ timeoutVariable,procedure,"(variablePrefix: string) => string","","Builds the timeout variable's name from the same prefix, so each external service in one process keeps its own patience.","Будує назву змінної строку з того самого префікса, тож кожен зовнішній сервіс в одному процесі тримає власне терпіння.",integration-timeoutVariable-procedure
311
+ externalHttpClientFromEnvironmentLive,adapter,"(service: string, variablePrefix: string, transport: Layer.Layer<HttpClient.HttpClient> = FetchHttpClient.layer) => Layer.Layer<ExternalHttpClient, ConfigError.ConfigError>","",A client built from the environment variables under one prefix.,"Клієнт, зібраний зі змінних оточення під одним префіксом.",integration-externalHttpClientFromEnvironmentLive-adapter
312
+ externalHttpClientLive,adapter,"(service: string, variablePrefix: string) => Layer.Layer<ExternalHttpClient, ConfigError.ConfigError>","","One external service on the real fetch transport, reading the variables its prefix names.","Один зовнішній сервіс на справжньому транспорті `fetch`, який читає змінні, названі його префіксом.",integration-externalHttpClientLive-adapter
313
+ <PREFIX>_BASE_URL,environment variable,refuses,"",The address every call to this external service goes under.,"Адреса, під яку йде кожен виклик до цього зовнішнього сервісу.",integration-PREFIX-BASE-URL-environment-variable
314
+ <PREFIX>_TIMEOUT_MILLIS,environment variable,falls back,"3000",How many milliseconds one call may take before it counts as a network failure.,"Скільки мілісекунд може тривати один виклик, перш ніж рахуватись мережевою невдачею.",integration-PREFIX-TIMEOUT-MILLIS-environment-variable
315
+ - mechanism: postgres
316
+ import: @satorio/machinery/postgres
317
+ kind: adapter
318
+ page: mechanisms/postgres
319
+ what: "Public entry to the postgres mechanism: every port this machinery defines, bound to a real database."
320
+ whatUk: "Публічний вхід до механізму postgres: кожен порт, який визначає ця машинерія (machinery), прив'язаний до справжньої бази."
321
+ rows[51]{name,kind,signature,fallback,caption,captionUk,anchor}:
322
+ AdvisoryLock,value,interface,"","A lock somebody else may already hold: its name, the attempt to take it, and the release that follows.","Замок, який хтось інший може вже тримати: його назва, спроба взяти його і звільнення, що йде слідом.",postgres-AdvisoryLock-value
323
+ DEFAULT_APPLICATION_NAME,value,const,"",The name this service shows under in the database's own list of connections when nobody names it.,"Назва, під якою цей сервіс видно у власному списку з'єднань бази, коли її ніхто не називає.",postgres-DEFAULT-APPLICATION-NAME-value
324
+ DEFAULT_AUTH_MODE,value,'iam' | 'password',"",How a service proves who it is when nothing says otherwise.,"Як сервіс доводить, хто він, коли ніщо не каже інакше.",postgres-DEFAULT-AUTH-MODE-value
325
+ DEFAULT_POSTGRES_PORT,value,const,"",The port a Postgres server listens on when nobody says otherwise.,"Порт, на якому слухає сервер Postgres, коли ніхто не каже інакше.",postgres-DEFAULT-POSTGRES-PORT-value
326
+ DEFAULT_POSTGRES_SCHEMA,value,const,"",The schema every statement runs against when nobody names one.,"Схема, проти якої біжить кожен запит, коли ніхто її не називає.",postgres-DEFAULT-POSTGRES-SCHEMA-value
327
+ DEFAULT_POSTGRES_SSL_MODE,value,PostgresSslMode,"","How a connection is encrypted when nobody says otherwise: the chain is verified, so the safe choice is the one you get by saying nothing.","Як шифрується з'єднання, коли ніхто не каже інакше: ланцюг перевіряють, тож безпечний вибір — той, який ви дістаєте, не сказавши нічого.",postgres-DEFAULT-POSTGRES-SSL-MODE-value
328
+ ENVIRONMENT,value,"readonly EnvironmentEntry[]","","Every variable this adapter reads, and the one state each of them stands in.","Кожна змінна, яку читає цей адаптер, і один стан, у якому стоїть кожна з них.",postgres-ENVIRONMENT-value
329
+ MACHINERY_MIGRATIONS_DIRECTORY,value,const,"","Directory holding the machinery's shared migrations: the processed-event registry and the outbox.","Директорія зі спільними міграціями (migration) машинерії: реєстр відпрацьованих подій і буфер трансмітера.",postgres-MACHINERY-MIGRATIONS-DIRECTORY-value
330
+ MIGRATION_LOCK_NAME,value,const,"","The name every migration lock is built from, so one reader finds them all.","Назва, з якої будують кожен замок міграцій, тож один читач знаходить їх усі.",postgres-MIGRATION-LOCK-NAME-value
331
+ POSTGRES_SSL_MODES,value,const,"","Every way a connection can be encrypted and verified, from no encryption at all to a fully verified chain.",Кожен спосіб зашифрувати й перевірити з'єднання — від жодного шифрування до цілком перевіреного ланцюга.,postgres-POSTGRES-SSL-MODES-value
332
+ PostgresAuthentication,value,type,"","The two ways to prove to the database who you are: a short-lived IAM token or a password.","Два способи довести базі, хто ви: короткоживучий токен IAM або пароль.",postgres-PostgresAuthentication-value
333
+ PostgresConnectionSettings,value,interface,"","Everything one connection needs, read in one go: where the server is, who connects, and how the connection is proven and encrypted.","Усе, що потрібно одному з'єднанню, прочитане за раз: де сервер, хто під'єднується і як з'єднання доводять та шифрують.",postgres-PostgresConnectionSettings-value
334
+ postgresConnectionSettings,value,Config.Config<PostgresConnectionSettings>,"","Every variable of `ENVIRONMENT`, read in one go.","Кожна змінна з `ENVIRONMENT`, прочитана за раз.",postgres-postgresConnectionSettings-value
335
+ PostgresPorts,value,type,"","The ports this mechanism implements, named together as one type.","Порти, які реалізує цей механізм, названі разом одним типом.",postgres-PostgresPorts-value
336
+ PostgresSslMode,value,"(typeof POSTGRES_SSL_MODES)[number]","",One of the ways a connection can be encrypted and verified.,Один зі способів зашифрувати й перевірити з'єднання.,postgres-PostgresSslMode-value
337
+ READINESS_QUERY_DEADLINE_MILLIS,value,const,"","How long the probe waits for its query before it reports \"down\".","Скільки проба чекає на свій запит, перш ніж звітувати «лежить».",postgres-READINESS-QUERY-DEADLINE-MILLIS-value
338
+ READINESS_REASON_WHEN_THE_DATABASE_STAYS_SILENT,value,const,"",Reason reported when the readiness query answers with a failure.,"Причина, про яку звітують, коли запит готовності відповідає відмовою.",postgres-READINESS-REASON-WHEN-THE-DATABASE-STAYS-SILENT-value
339
+ READINESS_REASON_WHEN_THE_QUERY_TIMES_OUT,value,const,"",Reason reported when the readiness query times out.,"Причина, про яку звітують, коли запитові готовності виходить строк.",postgres-READINESS-REASON-WHEN-THE-QUERY-TIMES-OUT-value
340
+ applyMigrations,procedure,"(directories: readonly string[] = [MACHINERY_MIGRATIONS_DIRECTORY])","","Applies pending migrations from the given directories, the machinery's own directory first, then the caller's.","Застосовує міграції, що чекають, із поданих директорій: спершу власна директорія машинерії, тоді директорія викликача.",postgres-applyMigrations-procedure
341
+ configProviderPreferring,procedure,"(primary: ConfigProvider.ConfigProvider, fallbackKey: string, fallbackValue: string) => ConfigProvider.ConfigProvider","","Builds a config provider that reads from `primary`, falling back to one fixed value when `primary` has no such key.","Будує постачальника конфігурації, який читає з `primary` і падає на одне фіксоване значення, коли в `primary` такого ключа немає.",postgres-configProviderPreferring-procedure
342
+ firstRow,procedure,"<A>(rows: readonly A[]) => Option.Option<A>","","Returns the first row, or `Option.none()` for an empty result.",Повертає перший рядок або `Option.none()` для порожнього результату.,postgres-firstRow-procedure
343
+ holdingAdvisoryLock,procedure,"<ELock, RLock, ScheduleOut, RSchedule>(lock: AdvisoryLock<ELock, RLock>, retryWhileBusy: Schedule.Schedule<ScheduleOut, unknown, RSchedule>)","","Runs an effect while holding the lock, waiting on the given schedule while somebody else holds it, and letting go however the effect ends.","Виконує ефект, тримаючи замок, чекає за поданим розкладом, поки замок тримає хтось інший, і відпускає його, хай як ефект скінчиться.",postgres-holdingAdvisoryLock-procedure
344
+ isUniqueViolation,procedure,"(error: SqlError) => boolean","",Whether this driver failure is a duplicate key rather than anything else the database could refuse.,"Чи ця відмова драйвера є дублем ключа, а не чимось іншим, чому база могла б відмовити.",postgres-isUniqueViolation-procedure
345
+ jsonbValue,procedure,"(sql: SqlClient.SqlClient, value: unknown) => Fragment","","Hands a value to a `jsonb` column as JSON, whatever its shape.","Подає значення в колонку `jsonb` як JSON, хай яка в нього форма.",postgres-jsonbValue-procedure
346
+ migrationLockNameFor,procedure,"(schema: string) => string","","The lock one schema's migrations take, so two services migrating two schemas never wait on each other.","Замок, який беруть міграції однієї схеми, тож два сервіси, що мігрують дві схеми, ніколи не чекають один одного.",postgres-migrationLockNameFor-procedure
347
+ onUniqueViolation,procedure,"<Conflict, Unavailable>(operation: string, branches: { readonly unique: () => Conflict; readonly unavailable: ( operation: string, ) => (cause: unknown) => Unavailable })","","Splits a write path at the database boundary: a unique violation becomes a domain conflict, any other SqlError becomes \"store unavailable\".","Ділить шлях запису на межі бази: порушення унікальності стає доменним конфліктом, будь-який інший `SqlError` стає «сховище недоступне».",postgres-onUniqueViolation-procedure
348
+ postgresAdvisoryLock,procedure,"(name: string) => AdvisoryLock<SqlError.SqlError, SqlClient.SqlClient>","",A named advisory lock on the connection's own database.,Названий консультативний замок на власній базі цього з'єднання.,postgres-postgresAdvisoryLock-procedure
349
+ readinessProbeAsking,procedure,"(aQueryTheDatabaseMustAnswer: Effect.Effect<unknown, SqlError>)","","Builds a probe around one query the database must answer, with a deadline over it so an unreachable database reports \"down\" instead of hanging.","Будує пробу навколо одного запиту, на який має відповісти база, зі строком над ним, тож недосяжна база звітує «лежить», а не зависає.",postgres-readinessProbeAsking-procedure
350
+ reportApplied,procedure,"(applied: ReadonlyArray<readonly [number, string]>) => Effect.Effect<void>","","Says in one line what the run applied, or that the database was already current.","Каже одним рядком, що прогін застосував, або що база вже поточна.",postgres-reportApplied-procedure
351
+ schemaDefaultingTo,procedure,"(schema: string) => ConfigProvider.ConfigProvider","",Default schema for one service when `PGSCHEMA` isn't set.,"Схема за замовчуванням для одного сервісу, коли `PGSCHEMA` не поставлено.",postgres-schemaDefaultingTo-procedure
352
+ MigrationPgClientLive,adapter,"Layer.Layer<PgClient.PgClient | SqlClient.SqlClient, ConfigError | PlatformError | SqlError, FileSystem.FileSystem>","","The client the migration runner uses: one connection, under its own name.","Клієнт, яким користується виконавець міграцій: одне з'єднання під власною назвою.",postgres-MigrationPgClientLive-adapter
353
+ PgDocumentNumberCounterLive,adapter,"Layer.Layer<DocumentNumberCounter, never, PgClient.PgClient>","",The document number counter on a real `document_number_counter` table.,Лічильник номерів документів на справжній таблиці `document_number_counter`.,postgres-PgDocumentNumberCounterLive-adapter
354
+ PgIntegrationEventOutboxLive,adapter,"Layer.Layer<IntegrationEventOutbox, never, PgClient.PgClient>","",The outbox on a real `integration_event_outbox` table.,Буфер трансмітера на справжній таблиці `integration_event_outbox`.,postgres-PgIntegrationEventOutboxLive-adapter
355
+ PgProcessedEventRegistryLive,adapter,"Layer.Layer<ProcessedEventRegistry, never, PgClient.PgClient>","",The exactly-once claim on a real `processed_event` table.,Резервація рівно один раз на справжній таблиці `processed_event`.,postgres-PgProcessedEventRegistryLive-adapter
356
+ PgReadinessProbeLive,adapter,"Layer.Layer<ReadinessProbe, never, SqlClient.SqlClient>","",The readiness probe on one `SELECT 1` against the service's own pool.,Проба готовності на одному `SELECT 1` проти власного пулу сервісу.,postgres-PgReadinessProbeLive-adapter
357
+ PgTransactionBoundaryLive,adapter,"Layer.Layer<TransactionBoundary, never, SqlClient.SqlClient>","",The transaction boundary on a real Postgres transaction.,Межа транзакції на справжній транзакції Postgres.,postgres-PgTransactionBoundaryLive-adapter
358
+ PostgresClientLive,adapter,"Layer.Layer<PgClient.PgClient | SqlClient.SqlClient, ConfigError | PlatformError | SqlError, FileSystem.FileSystem>","","The `@effect/sql-pg` client every other layer here builds on, opened from the environment `settings.ts` names.","Клієнт `@effect/sql-pg`, на якому стоїть кожен інший шар тут, відкритий з оточення, яке називає `settings.ts`.",postgres-PostgresClientLive-adapter
359
+ PostgresPortsLive,adapter,"Layer.Layer<PostgresPorts | PgClient.PgClient | SqlClient.SqlClient, ConfigError | PlatformError | SqlError, FileSystem.FileSystem>","","Every port this mechanism implements, on one client, for a service that supplies its own `FileSystem`.","Кожен порт, який реалізує цей механізм, на одному клієнті, для сервісу, що подає власну `FileSystem`.",postgres-PostgresPortsLive-adapter
360
+ PostgresPortsOnBunLive,adapter,"Layer.Layer<PostgresPorts | PgClient.PgClient | SqlClient.SqlClient, ConfigError | PlatformError | SqlError>","","The same bundle on Bun's own file system, which is the whole Postgres side of the machinery in one layer.","Той самий набір на власній файловій системі Bun, і це вся частина машинерії з боку Postgres в одному шарі.",postgres-PostgresPortsOnBunLive-adapter
361
+ MigrationLockBusyError,failure,"Data.TaggedError<{ readonly lockName: string }>","",A second process already holds the migration lock and did not let go within the retry window.,Другий процес уже тримає замок міграцій і не відпустив його у вікні спроб.,postgres-MigrationLockBusyError-failure
362
+ PGHOST,environment variable,refuses,"",The host this service opens its connection pool against.,"Хост, проти якого цей сервіс відкриває свій пул з'єднань.",postgres-PGHOST-environment-variable
363
+ PGPORT,environment variable,falls back,"5432",The TCP port the database listens on.,"Порт TCP, на якому слухає база.",postgres-PGPORT-environment-variable
364
+ PGUSER,environment variable,refuses,"",The Postgres role this service connects as.,"Роль Postgres, під якою під'єднується цей сервіс.",postgres-PGUSER-environment-variable
365
+ PGDATABASE,environment variable,refuses,"",The database this service reads and writes.,"База, яку цей сервіс читає і пише.",postgres-PGDATABASE-environment-variable
366
+ PGSCHEMA,environment variable,falls back,app,"The schema every statement runs against, set as the connection's search_path.","Схема, проти якої біжить кожен запит, поставлена як `search_path` з'єднання.",postgres-PGSCHEMA-environment-variable
367
+ PGAPPNAME,environment variable,falls back,machinery,The name this service shows under in pg_stat_activity.,"Назва, під якою цей сервіс видно в `pg_stat_activity`.",postgres-PGAPPNAME-environment-variable
368
+ PGSSLMODE,environment variable,falls back,verify-full,"How the connection is encrypted and verified, one of disable, allow, prefer, require, verify-ca, verify-full.","Як з'єднання шифрують і перевіряють; один із `disable`, `allow`, `prefer`, `require`, `verify-ca`, `verify-full`.",postgres-PGSSLMODE-environment-variable
369
+ PGSSLROOTCERT,environment variable,handed on,"",The path to a certificate authority file the database chain is verified against.,"Шлях до файлу центру сертифікації, проти якого перевіряють ланцюг бази.",postgres-PGSSLROOTCERT-environment-variable
370
+ AUTH_MODE,environment variable,falls back,password,"Which of the two ways this service proves who it is, iam or password.","Котрим із двох способів цей сервіс доводить, хто він: `iam` чи `password`.",postgres-AUTH-MODE-environment-variable
371
+ PGPASSWORD,environment variable,refuses,"","The database password, read under the default password mode.","Пароль бази, який читають у режимі `password` за замовчуванням.",postgres-PGPASSWORD-environment-variable
372
+ AWS_REGION,environment variable,handed on,"","The region the IAM token signer signs against, read under AUTH_MODE=iam.","Регіон, проти якого підписує підписувач токенів IAM; його читають при `AUTH_MODE=iam`.",postgres-AWS-REGION-environment-variable
373
+ - mechanism: publishing
374
+ import: @satorio/machinery/publishing
375
+ kind: adapter
376
+ page: mechanisms/publishing
377
+ what: "Public entry to the publishing mechanism: the event publisher, bound to a topic or to one line on stdout."
378
+ whatUk: "Публічний вхід до механізму publishing: публікатор (publisher) подій, прив'язаний до топіка або до одного рядка на stdout."
379
+ rows[13]{name,kind,signature,fallback,caption,captionUk,anchor}:
380
+ DEFAULT_EVENT_CHANNEL,value,const,"",The log channel the stdout publisher writes its events under when nobody names one.,"Канал лога, під яким публікатор на stdout пише свої події, коли ніхто не назвав іншого.",publishing-DEFAULT-EVENT-CHANNEL-value
381
+ ENVIRONMENT,value,"readonly EnvironmentEntry[]","","Every variable this adapter reads, and the one state each of them stands in.","Кожна змінна, яку читає цей адаптер, і один стан, у якому стоїть кожна з них.",publishing-ENVIRONMENT-value
382
+ SnsPublisherSettings,value,interface,"","What the SNS publisher needs before it can send: one topic, and the two variables the AWS SDK reads for itself when nobody names them.","Що потрібно публікаторові SNS, перш ніж він надішле: один топік і дві змінні, які AWS SDK читає сам, коли їх ніхто не називає.",publishing-SnsPublisherSettings-value
383
+ snsMessageBodyOf,procedure,"(message: OutboxMessage) => string","","The message body a subscriber reads: the same envelope as the stdout line, minus the channel — here the topic itself plays that role.","Тіло повідомлення, яке читає підписник: той самий конверт, що й рядок на stdout, без каналу — тут цю роль грає сам топік.",publishing-snsMessageBodyOf-procedure
384
+ snsPublisherSettings,procedure,"(variablePrefix: string) => Config.Config<SnsPublisherSettings>","",Reads every variable the SNS publisher needs under one prefix.,"Читає кожну змінну, потрібну публікаторові SNS, під одним префіксом.",publishing-snsPublisherSettings-procedure
385
+ stdoutLineOf,procedure,"(channel: string, message: OutboxMessage) => string","","The simplest publisher: an event travels as one JSON line on stdout, where a log collector picks it up.","Найпростіший публікатор: подія мандрує одним рядком JSON на stdout, звідки її забирає збирач логів.",publishing-stdoutLineOf-procedure
386
+ topicArnVariable,procedure,"(variablePrefix: string) => string","",Builds the environment variable name from the prefix the application gives at mount time.,"Будує назву змінної оточення з префікса, який застосунок дає під час монтування.",publishing-topicArnVariable-procedure
387
+ snsEventPublisherLive,adapter,"(variablePrefix: string) => Layer.Layer<EventPublisher, ConfigError.ConfigError>","","The SNS publisher on the real AWS SDK transport, reading the variables this prefix names.","Публікатор SNS на справжньому транспорті AWS SDK, який читає змінні, названі цим префіксом.",publishing-snsEventPublisherLive-adapter
388
+ StdoutEventPublisherLive,adapter,Layer.Layer<EventPublisher>,"","The stdout publisher, mounted: one JSON line per event under the channel `EVENT_CHANNEL` names.","Змонтований публікатор на stdout: один рядок JSON на подію під каналом, який називає `EVENT_CHANNEL`.",publishing-StdoutEventPublisherLive-adapter
389
+ <PREFIX>_TOPIC_ARN,environment variable,refuses,"",The SNS topic this publisher sends events to.,"Топік SNS, до якого цей публікатор надсилає події.",publishing-PREFIX-TOPIC-ARN-environment-variable
390
+ EVENT_CHANNEL,environment variable,falls back,machinery-integration-events,The word a log collector filters the stdout publisher's lines by.,"Слово, за яким збирач логів фільтрує рядки публікатора на stdout.",publishing-EVENT-CHANNEL-environment-variable
391
+ AWS_REGION,environment variable,handed on,"",The region the SNS client talks to.,"Регіон, з яким говорить клієнт SNS.",publishing-AWS-REGION-environment-variable
392
+ AWS_ENDPOINT_URL,environment variable,handed on,"","A local stand to talk to instead of real SNS, such as localstack.","Локальний стенд, з яким говорити замість справжнього SNS, наприклад localstack.",publishing-AWS-ENDPOINT-URL-environment-variable
393
+ - mechanism: queue
394
+ import: @satorio/machinery/queue
395
+ kind: adapter
396
+ page: mechanisms/queue
397
+ what: "Public entry to the queue mechanism: the envelope a message travels in, and the consumer that decides its fate."
398
+ whatUk: "Публічний вхід до механізму queue: конверт, у якому мандрує повідомлення, і робітник (consumer), який вирішує його долю."
399
+ rows[39]{name,kind,signature,fallback,caption,captionUk,anchor}:
400
+ defaultQueueRetrySchedule,value,QueueRetrySchedule,"","The waiting a consumer keeps when a service names no schedule of its own: growing pauses, jittered, and a limit on how often it tries.","Очікування, якого тримається робітник, коли сервіс не називає власного розкладу: зростальні паузи, з джитером, і межа на кількість спроб.",queue-defaultQueueRetrySchedule-value
401
+ ENVIRONMENT,value,"readonly EnvironmentEntry[]","","Every variable this adapter reads, and the one state each of them stands in.","Кожна змінна, яку читає цей адаптер, і один стан, у якому стоїть кожна з них.",queue-ENVIRONMENT-value
402
+ EventDefinitionRegistry,value,interface,"","What a service's own list of event definitions offers: whether an event type is known, and the definition behind it.","Що пропонує власний список визначень подій сервісу: чи тип події відомий і яке визначення за ним стоїть.",queue-EventDefinitionRegistry-value
403
+ IncomingQueueMessage,value,interface,"","One message as a handler meets it: the envelope's own fields, and the decoded event itself.","Одне повідомлення таким, яким його зустрічає обробник: власні поля конверта і сама декодована подія.",queue-IncomingQueueMessage-value
404
+ PayloadDecoder,value,type,"",What turns a stored payload of some version into the event a handler works with.,"Те, що перетворює збережений payload якоїсь версії на подію, з якою працює обробник.",queue-PayloadDecoder-value
405
+ QueueConsumerSettings,value,interface,"",What a consumer needs before it can receive a single message.,"Що потрібно робітникові, перш ніж він отримає бодай одне повідомлення.",queue-QueueConsumerSettings-value
406
+ QueueMessageBody,value,const,"","The envelope as it travels: the JSON text on the wire, read and written through one schema.","Конверт таким, яким він мандрує: текст JSON на дроті, прочитаний і записаний однією схемою.",queue-QueueMessageBody-value
407
+ QueueMessageConsumerOptions,value,interface,"",What a consumer needs to turn a queue message into work.,"Що потрібно робітникові, щоб перетворити повідомлення черги на роботу.",queue-QueueMessageConsumerOptions-value
408
+ QueueMessageOutcome,value,type,"","The fate of one message has exactly three endings: acknowledged, left for redelivery, or refused permanently.","Доля одного повідомлення має рівно три кінці: підтверджено, лишено на перевідправку або відмовлено назавжди.",queue-QueueMessageOutcome-value
409
+ QueueProducerSettings,value,interface,"","What a producer needs before it can send: the queue, and the same two variables the SDK decides for itself.","Що потрібно відправникові, перш ніж він надішле: черга і ті самі дві змінні, які SDK вирішує сам.",queue-QueueProducerSettings-value
410
+ QueueRetrySchedule,value,type,"",How a consumer waits and tries again while the queue itself does not answer.,"Як робітник чекає і пробує знову, поки сама черга не відповідає.",queue-QueueRetrySchedule-value
411
+ RedeliveryReason,value,type,"","Why a message goes back on the queue: it never decoded, or the handler rejected it.","Чому повідомлення повертається в чергу: воно так і не декодувалось, або обробник його відхилив.",queue-RedeliveryReason-value
412
+ SchemaVersion,value,const,"","The version a stored payload was shaped by: a whole number above zero, and never anything else.","Версія, якою надано форми збереженому payload: ціле число понад нуль і ніколи нічого іншого.",queue-SchemaVersion-value
413
+ SQS_DEFAULT_VISIBILITY_TIMEOUT_SECONDS,value,const,"","How long a received message stays hidden while a handler works on it, when nobody names a number.","Скільки отримане повідомлення лишається схованим, поки над ним працює обробник, коли ніхто не назвав числа.",queue-SQS-DEFAULT-VISIBILITY-TIMEOUT-SECONDS-value
414
+ StoredEventEnvelope,value,const,"",The shared queue contract every message travels in.,"Спільний контракт черги, у якому мандрує кожне повідомлення.",queue-StoredEventEnvelope-value
415
+ consumeQueueMessages,procedure,"<A, E, R>(options: QueueMessageConsumerOptions<A, E, R>) => Stream.Stream<QueueMessageOutcome, QueueMessageSourceUnavailableError, R | QueueMessageSource>","","Reads messages off the queue and hands each one to the handler, answering with the fate of every message it took.","Читає повідомлення з черги і віддає кожне обробникові, відповідаючи долею кожного взятого повідомлення.",queue-consumeQueueMessages-procedure
416
+ decodeQueueMessageBody,procedure,"(body: string) => Effect.Effect<StoredEventEnvelope, QueueMessageNotDecodableError>","","Reads a message body into an envelope, or refuses at the envelope stage and says what it could not read.","Читає тіло повідомлення в конверт або відмовляє вже на конверті й каже, чого не змогло прочитати.",queue-decodeQueueMessageBody-procedure
417
+ eventDefinitionRegistry,procedure,"<S extends Schema.Schema.AnyNoContext>(definitions: readonly VersionedEventDefinition<S>[]) => EventDefinitionRegistry<S>","",Builds a registry of known event definitions.,Будує реєстр відомих визначень подій.,queue-eventDefinitionRegistry-procedure
418
+ handlerRejectedMessage,procedure,"(error: unknown) => RedeliveryReason","",The reason for a message the handler itself rejected.,"Причина для повідомлення, яке відхилив сам обробник.",queue-handlerRejectedMessage-procedure
419
+ messageAcknowledged,procedure,"(messageId: string) => QueueMessageOutcome","","The fate of a message the handler took, so the queue may drop it.","Доля повідомлення, яке обробник узяв, тож черга може його викинути.",queue-messageAcknowledged-procedure
420
+ messageLeftForRedelivery,procedure,"(messageId: string, reason: RedeliveryReason) => QueueMessageOutcome","","The fate of a message that goes back on the queue, with the reason it did.","Доля повідомлення, яке повертається в чергу, разом із причиною, чому воно повернулось.",queue-messageLeftForRedelivery-procedure
421
+ messageNotDecodable,procedure,"(error: QueueMessageNotDecodableError) => RedeliveryReason","",The reason for a message that never decoded.,"Причина для повідомлення, яке так і не декодувалось.",queue-messageNotDecodable-procedure
422
+ messageRefusedPermanently,procedure,"(messageId: string, eventId: string, refusal: unknown) => QueueMessageOutcome","","The fate of a message no retry can help, so the platform's own redrive takes it from here.","Доля повідомлення, якому не поможе жодна спроба, тож далі його бере власний redrive платформи.",queue-messageRefusedPermanently-procedure
423
+ payloadDecoderFor,procedure,"<S extends Schema.Schema.AnyNoContext>(definition: VersionedEventDefinition<S>) => PayloadDecoder<Schema.Schema.Type<S>>","","Builds the payload decoder for one event definition, climbing a stored payload up to the version this code knows.","Будує декодер payload для одного визначення події, підіймаючи збережений payload до версії, яку знає цей код.",queue-payloadDecoderFor-procedure
424
+ queueConsumerSettings,procedure,"(variablePrefix: string) => Config.Config<QueueConsumerSettings>","",Reads every variable a consumer needs under one prefix.,"Читає кожну змінну, потрібну робітникові, під одним префіксом.",queue-queueConsumerSettings-procedure
425
+ queueMessageBodyOf,procedure,"(envelope: { readonly eventId: string; readonly eventType: string; readonly schemaVersion: number; readonly occurredAtIso: string; readonly payload: { readonly [key: string]: unknown } }) => string","","Builds the same envelope contract, but for sending: the producer sets exactly the fields the consumer expects to read.","Будує той самий контракт конверта, але для надсилання: відправник ставить рівно ті поля, які очікує прочитати робітник.",queue-queueMessageBodyOf-procedure
426
+ queueProducerSettings,procedure,"(variablePrefix: string) => Config.Config<QueueProducerSettings>","",Reads every variable a producer needs under one prefix.,"Читає кожну змінну, потрібну відправникові, під одним префіксом.",queue-queueProducerSettings-procedure
427
+ queueReadinessCheck,procedure,"(variablePrefix: string) => Effect.Effect<Option.Option<Effect.Effect<void, QueueMessageSourceUnavailableError>>, ConfigError.ConfigError>","","The readiness check for a queue, absent when no queue is mounted at all.","Перевірка готовності для черги, відсутня тоді, коли жодної черги не змонтовано.",queue-queueReadinessCheck-procedure
428
+ queueUrlVariable,procedure,"(variablePrefix: string) => string","",Builds the environment variable name from the prefix the application gives at mount time.,"Будує назву змінної оточення з префікса, який застосунок дає під час монтування.",queue-queueUrlVariable-procedure
429
+ sqsQueueMessageProducerLive,adapter,"(variablePrefix: string) => Layer.Layer<QueueMessageProducer, ConfigError.ConfigError>","","The message producer on the real AWS SDK transport, reading the variables this prefix names.","Відправник повідомлень на справжньому транспорті AWS SDK, який читає змінні, названі цим префіксом.",queue-sqsQueueMessageProducerLive-adapter
430
+ sqsQueueMessageSourceLive,adapter,"(variablePrefix: string) => Layer.Layer<QueueMessageSource, ConfigError.ConfigError>","","The message source on the real AWS SDK transport, reading the variables this prefix names.","Джерело повідомлень на справжньому транспорті AWS SDK, яке читає змінні, названі цим префіксом.",queue-sqsQueueMessageSourceLive-adapter
431
+ QueueMessageNotDecodableError,failure,"Data.TaggedError<{ readonly stage: QueueMessageDecodingStage; readonly cause: unknown }>","",A message whose text this service cannot turn into an event.,"Повідомлення, текст якого цей сервіс не може перетворити на подію.",queue-QueueMessageNotDecodableError-failure
432
+ UnknownEventTypeError,failure,"Data.TaggedError<{ readonly eventType: string }>","",A message naming an event type this service never registered.,"Повідомлення, яке називає тип події, що його цей сервіс ніколи не реєстрував.",queue-UnknownEventTypeError-failure
433
+ <PREFIX>_QUEUE_URL,environment variable,refuses,"",The queue a consumer receives from and a producer sends to.,"Черга, з якої отримує робітник і в яку надсилає відправник.",queue-PREFIX-QUEUE-URL-environment-variable
434
+ <PREFIX>_MAX_MESSAGES_PER_RECEIVE,environment variable,falls back,"10",How many messages one receive call asks for.,Скільки повідомлень просить один виклик отримання.,queue-PREFIX-MAX-MESSAGES-PER-RECEIVE-environment-variable
435
+ <PREFIX>_WAIT_TIME_SECONDS,environment variable,falls back,"20",How many seconds a receive call waits for a message before it comes back empty.,"Скільки секунд виклик отримання чекає на повідомлення, перш ніж повернутись порожнім.",queue-PREFIX-WAIT-TIME-SECONDS-environment-variable
436
+ <PREFIX>_VISIBILITY_TIMEOUT_SECONDS,environment variable,falls back,"60",How many seconds a received message stays hidden from other consumers.,Скільки секунд отримане повідомлення лишається схованим від інших робітників.,queue-PREFIX-VISIBILITY-TIMEOUT-SECONDS-environment-variable
437
+ AWS_REGION,environment variable,handed on,"",The region the SQS client talks to.,"Регіон, з яким говорить клієнт SQS.",queue-AWS-REGION-environment-variable
438
+ AWS_ENDPOINT_URL,environment variable,handed on,"","A local stand to talk to instead of real SQS, such as localstack.","Локальний стенд, з яким говорити замість справжнього SQS, наприклад localstack.",queue-AWS-ENDPOINT-URL-environment-variable
439
+ - mechanism: storage
440
+ import: @satorio/machinery/storage
441
+ kind: adapter
442
+ page: mechanisms/storage
443
+ what: "Public entry to the storage mechanism: whole objects stored under a key and read back."
444
+ whatUk: "Публічний вхід до механізму storage: цілі об'єкти, збережені під ключем і прочитані назад."
445
+ rows[20]{name,kind,signature,fallback,caption,captionUk,anchor}:
446
+ BlobStoreSettings,value,interface,"",What the store needs before it can talk to the object store.,"Що потрібно сховищу, перш ніж воно заговорить зі сховищем об'єктів.",storage-BlobStoreSettings-value
447
+ ClosableS3Transport,value,interface,"","A transport that also closes, so the client behind it is released when the scope around it ends.","Транспорт, який ще й закривається, тож клієнта за ним відпускають, коли скоуп навколо нього кінчається.",storage-ClosableS3Transport-value
448
+ DEFAULT_CONTENT_TYPE,value,const,"","What an object is read as when the store hands back no content type of its own: plain bytes.","Чим читається об'єкт, коли сховище не подає власного типу вмісту: просто байтами.",storage-DEFAULT-CONTENT-TYPE-value
449
+ ENVIRONMENT,value,"readonly EnvironmentEntry[]","","Every variable this adapter reads, and the one state each of them stands in.","Кожна змінна, яку читає цей адаптер, і один стан, у якому стоїть кожна з них.",storage-ENVIRONMENT-value
450
+ S3FetchedObject,value,interface,"","One object as the store hands it back: its bytes, and the content type and metadata it carries when it carries any.","Один об'єкт таким, яким його віддає сховище: його байти, а також тип вмісту й метадані, коли він їх несе.",storage-S3FetchedObject-value
451
+ S3KeyRequest,value,interface,"","One object named: the bucket it sits in and the key it sits under.","Один названий об'єкт: бакет, у якому він сидить, і ключ, під яким він сидить.",storage-S3KeyRequest-value
452
+ S3ObjectTransport,value,interface,"","The narrow slice of the object store a blob store calls: put, get, check, delete, and nothing else.","Вузький зріз сховища об'єктів, який кличе сховище об'єктів: покласти, взяти, перевірити, видалити — і більш нічого.",storage-S3ObjectTransport-value
453
+ S3PutRequest,value,interface,"","The narrowest slice of the SDK the store uses: put, get, check existence, delete.","Найвужчий зріз SDK, яким користується сховище: покласти, взяти, перевірити наявність, видалити.",storage-S3PutRequest-value
454
+ blobStoreSettings,procedure,"(variablePrefix: string) => Config.Config<BlobStoreSettings>","",Reads every variable of `ENVIRONMENT` under one prefix.,Читає кожну змінну з `ENVIRONMENT` під одним префіксом.,storage-blobStoreSettings-procedure
455
+ blobStoreUnavailableWithoutConfiguration,procedure,"(refusal: Refusal) => BlobStoreShape","","Without a bucket set, the store does not fail service startup: it mounts a stub that fails every operation loudly.","Без поставленого бакета сховище не валить старт сервісу: воно монтує заглушку, яка гучно валить кожну операцію.",storage-blobStoreUnavailableWithoutConfiguration-procedure
456
+ bucketVariable,procedure,"(variablePrefix: string) => string","",Builds the environment variable name from the prefix the application gives at mount time.,"Будує назву змінної оточення з префікса, який застосунок дає під час монтування.",storage-bucketVariable-procedure
457
+ makeS3BlobStore,procedure,"(transport: S3ObjectTransport, settings: BlobStoreSettings) => BlobStoreShape","","Builds the blob store over one transport and one bucket, turning the store's own way of signalling a missing key into an absent value.","Будує сховище об'єктів над одним транспортом і одним бакетом, обертаючи власний спосіб сховища сигналити про відсутній ключ на відсутнє значення.",storage-makeS3BlobStore-procedure
458
+ openS3Transport,procedure,"(settings: BlobStoreSettings) => ClosableS3Transport","","Opens the real object-store client against the settings handed in, and is the one place that client is constructed.","Відкриває справжнього клієнта сховища об'єктів під подані налаштування і є єдиним місцем, де того клієнта створюють.",storage-openS3Transport-procedure
459
+ scopedS3Transport,procedure,"(openTransport: () => ClosableS3Transport) => Effect.Effect<S3ObjectTransport, never, Scope.Scope>","","Opens a transport that closes with the scope around it, so no client outlives the work that opened it.","Відкриває транспорт, який закривається разом зі скоупом навколо нього, тож жоден клієнт не переживає роботи, яка його відкрила.",storage-scopedS3Transport-procedure
460
+ signalsAbsentKey,procedure,"(error: unknown) => boolean","","S3 signals \"no such key\" as an ERROR, not an empty response: `GetObject` throws `NoSuchKey`, `HeadObject` throws `NotFound`.","S3 сигналить «немає такого ключа» помилкою, а не порожньою відповіддю: `GetObject` кидає `NoSuchKey`, `HeadObject` кидає `NotFound`.",storage-signalsAbsentKey-procedure
461
+ blobStoreFromEnvironmentLive,adapter,"(variablePrefix: string, openTransport: (settings: BlobStoreSettings) => ClosableS3Transport) => Layer.Layer<BlobStore, ConfigError.ConfigError>","",A blob store built from environment variables with the given prefix.,"Сховище об'єктів, зібране зі змінних оточення з поданим префіксом.",storage-blobStoreFromEnvironmentLive-adapter
462
+ s3BlobStoreLive,adapter,"(variablePrefix: string) => Layer.Layer<BlobStore, ConfigError.ConfigError>","","The blob store on the real AWS SDK transport, reading the variables this prefix names.","Сховище об'єктів на справжньому транспорті AWS SDK, яке читає змінні, названі цим префіксом.",storage-s3BlobStoreLive-adapter
463
+ <PREFIX>_BUCKET,environment variable,refuses,"",The bucket this store puts objects into and reads them back from.,"Бакет, у який це сховище кладе об'єкти і з якого читає їх назад.",storage-PREFIX-BUCKET-environment-variable
464
+ AWS_REGION,environment variable,handed on,"",The region the S3 client talks to.,"Регіон, з яким говорить клієнт S3.",storage-AWS-REGION-environment-variable
465
+ AWS_ENDPOINT_URL,environment variable,handed on,"","A local stand to talk to instead of real S3, such as localstack.","Локальний стенд, з яким говорити замість справжнього S3, наприклад localstack.",storage-AWS-ENDPOINT-URL-environment-variable
466
+ - mechanism: testing
467
+ import: @satorio/machinery/testing
468
+ kind: test kit
469
+ page: mechanisms/testing
470
+ what: "Public entry to the testing mechanism: a stand-in for every port, a clock a test drives, and the scenario player."
471
+ whatUk: "Публічний вхід до механізму testing: замінник кожного порту, годинник, яким керує тест (test), і програвач сценаріїв (playScenario)."
472
+ rows[77]{name,kind,signature,fallback,caption,captionUk,anchor}:
473
+ AnswersByPath,value,"Readonly<Record<string, unknown>>","","What an in-memory client answers with: one already-decoded body per path.","Чим відповідає клієнт у пам'яті: одне вже декодоване тіло на кожен шлях.",testing-AnswersByPath-value
474
+ BlobsByKey,value,"ReadonlyMap<string, StoredBlob>","","What an in-memory blob store holds: every blob it was given, by key.","Що тримає сховище об'єктів у пам'яті: кожен об'єкт, який йому дали, за ключем.",testing-BlobsByKey-value
475
+ DispatchedMessageIds,value,ReadonlySet<string>,"","What an in-memory outbox holds on the read side: the ids a relay has already marked as sent.","Що тримає буфер трансмітера в пам'яті з боку читання: ідентифікатори, які трансмітер уже позначив надісланими.",testing-DispatchedMessageIds-value
476
+ DocumentCountsByClientAndMonth,value,"ReadonlyMap<string, number>","","What an in-memory counter holds: how many documents each client has been sent in each reporting month, keyed by the two together.","Що тримає лічильник у пам'яті: скільки документів дістав кожен клієнт у кожен звітний місяць, за ключем із них двох.",testing-DocumentCountsByClientAndMonth-value
477
+ InMemoryBlobStoreLive,value,const,"","The in-memory blob store, mounted.",Змонтоване сховище об'єктів у пам'яті.,testing-InMemoryBlobStoreLive-value
478
+ InMemoryDocumentNumberCounterLive,value,const,"","The in-memory counter, mounted.",Змонтований лічильник у пам'яті.,testing-InMemoryDocumentNumberCounterLive-value
479
+ InMemoryEventPublisherLive,value,const,"","The in-memory publisher, mounted.",Змонтований публікатор у пам'яті.,testing-InMemoryEventPublisherLive-value
480
+ InMemoryIntegrationEventOutboxLive,value,const,"","The in-memory outbox, mounted.",Змонтований буфер трансмітера в пам'яті.,testing-InMemoryIntegrationEventOutboxLive-value
481
+ InMemoryProcessedEventRegistryLive,value,const,"","The in-memory registry, mounted.",Змонтований реєстр у пам'яті.,testing-InMemoryProcessedEventRegistryLive-value
482
+ InMemoryQueueMessageProducerLive,value,const,"","The in-memory producer, mounted.",Змонтований відправник у пам'яті.,testing-InMemoryQueueMessageProducerLive-value
483
+ InMemoryQueueMessageSourceLive,value,const,"","The in-memory message source, mounted.",Змонтоване джерело повідомлень у пам'яті.,testing-InMemoryQueueMessageSourceLive-value
484
+ makeInMemoryBlobStore,value,const,"","An in-memory blob store over a `Ref` of its own, empty at the start.","Сховище об'єктів у пам'яті над власним `Ref`, порожнє на початку.",testing-makeInMemoryBlobStore-value
485
+ makeInMemoryDocumentNumberCounter,value,const,"","An in-memory counter over a `Ref` of its own, with every month at zero.","Лічильник у пам'яті над власним `Ref`, де кожен місяць стоїть на нулі.",testing-makeInMemoryDocumentNumberCounter-value
486
+ makeInMemoryEventPublisher,value,const,"","An in-memory publisher over a `Ref` of its own, empty at the start.","Публікатор у пам'яті над власним `Ref`, порожній на початку.",testing-makeInMemoryEventPublisher-value
487
+ makeInMemoryIntegrationEventOutbox,value,const,"","An in-memory outbox over `Ref`s of its own, empty at the start.","Буфер трансмітера в пам'яті над власними `Ref`, порожній на початку.",testing-makeInMemoryIntegrationEventOutbox-value
488
+ makeInMemoryProcessedEventRegistry,value,const,"","An in-memory registry over a `Ref` of its own, empty at the start.","Реєстр у пам'яті над власним `Ref`, порожній на початку.",testing-makeInMemoryProcessedEventRegistry-value
489
+ makeInMemoryQueueMessageProducer,value,const,"","An in-memory producer over a `Ref` of its own, whose messages nobody receives.","Відправник у пам'яті над власним `Ref`, чиїх повідомлень ніхто не отримує.",testing-makeInMemoryQueueMessageProducer-value
490
+ makeInMemoryQueueMessageSource,value,const,"","An in-memory message source over a `Ref` of its own, empty at the start.","Джерело повідомлень у пам'яті над власним `Ref`, порожнє на початку.",testing-makeInMemoryQueueMessageSource-value
491
+ nowAsDateTime,value,Effect.Effect<DateTime.Utc>,"","The moment the clock reads now, as a moment on the world's clock.","Мить, яку годинник читає зараз, як мить на світовому годиннику.",testing-nowAsDateTime-value
492
+ nowAsIsoString,value,Effect.Effect<string>,"","The moment the clock reads now, written the way it travels the wire.","Мить, яку годинник читає зараз, написана так, як вона мандрує дротом.",testing-nowAsIsoString-value
493
+ PendingQueueMessages,value,"readonly RawQueueMessage[]","","What an in-memory queue holds: the messages waiting to be received, in the order they were put there.","Що тримає черга в пам'яті: повідомлення, які чекають на отримання, у тому порядку, в якому їх туди поклали.",testing-PendingQueueMessages-value
494
+ ProcessedEventsById,value,"ReadonlyMap<string, DateTime.Utc>","","What an in-memory registry holds: the moment each event id was first claimed.","Що тримає реєстр у пам'яті: мить, коли кожен ідентифікатор події зарезервували вперше.",testing-ProcessedEventsById-value
495
+ PublishedMessages,value,"readonly OutboxMessage[]","","What an in-memory publisher holds: every message it was handed, in the order the batches arrived.","Що тримає публікатор у пам'яті: кожне повідомлення, яке йому подали, у порядку, в якому приходили пачки.",testing-PublishedMessages-value
496
+ QueuedOutboxMessages,value,"readonly OutboxMessage[]","","What an in-memory outbox holds on the write side: every message enqueued, in the order it arrived.","Що тримає буфер трансмітера в пам'яті з боку запису: кожне поставлене в чергу повідомлення, у порядку, в якому воно прийшло.",testing-QueuedOutboxMessages-value
497
+ QuietReporter,value,class,"","A test-runner reporter that prints one summary line for a whole run: how many files, how many tests, how long it took.","Репортер виконавця тестів (test runner), який друкує один підсумковий рядок на цілий прогін: скільки файлів, скільки тестів, скільки це тривало.",testing-QuietReporter-value
498
+ Scenario,value,interface,"","A story told as data: the steps a world walks through, and the numbers that world ends on.","Історія, розказана даними: кроки, якими проходить світ, і числа, на яких той світ спиняється.",testing-Scenario-value
499
+ ScenarioPlayback,value,interface,"","What one run of a scenario leaves behind: the label of every step, and the snapshot the run ended on.","Що лишає по собі один прогін сценарію (scenario): мітка кожного кроку і знімок, на якому прогін скінчився.",testing-ScenarioPlayback-value
500
+ ScenarioService,value,interface,"","What a service gives the scenario player: how to run a step, and how to snapshot what followed.","Що сервіс дає програвачеві сценаріїв: як виконати крок і як зняти знімок того, що з нього вийшло.",testing-ScenarioService-value
501
+ ScenarioStep,value,interface,"",One step in a scenario.,Один крок у сценарії.,testing-ScenarioStep-value
502
+ SUITES_THAT_START_A_STAND,value,"readonly string[]","","The suites that start a live stand, by the file name A11 gives them.","Сьюти, які піднімають живий стенд (live stand), за іменем файлу, яке дає їм `A11`.",testing-SUITES-THAT-START-A-STAND-value
503
+ TransactionalState,value,interface,"","One participant in an in-memory transaction: it can capture its own state now and hand back the effect that puts it back.","Один учасник транзакції в пам'яті: він уміє захопити власний стан зараз і подати назад ефект, який його повертає.",testing-TransactionalState-value
504
+ advanceBy,procedure,"(duration: Duration.DurationInput) => Effect.Effect<void>","","Moves the controlled test clock on by the span handed in, so a test reaches a later moment without waiting for it.","Рухає керований тестовий годинник на подану тривалість, тож тест доходить до пізнішої миті, не чекаючи на неї.",testing-advanceBy-procedure
505
+ atTheMoment,procedure,"(isoTimestamp: string)","","Runs the given work \"at\" the given moment: every clock read inside it sees `isoTimestamp`.","Виконує подану роботу «в» подану мить: кожне читання годинника всередині бачить `isoTimestamp`.",testing-atTheMoment-procedure
506
+ clockPinnedAt,procedure,"(at: DateTime.Utc) => Clock.Clock","","Builds a Clock pinned to one moment: every time read inside returns that moment, while `sleep` still waits on the real clock.","Будує `Clock`, пришпилений до однієї миті: кожне читання часу всередині повертає ту мить, а `sleep` і далі чекає за справжнім годинником.",testing-clockPinnedAt-procedure
507
+ contextOf,procedure,"<Command, Snapshot, Context>(scenario: Scenario<Command, Snapshot, Context>) => Context","",Reads the cross-cutting data of a scenario that declares some.,"Читає наскрізні дані сценарію, який їх оголошує.",testing-contextOf-procedure
508
+ distinctMomentsIn,procedure,"(table: string, column: string) => Effect.Effect<readonly string[], never, SqlClient.SqlClient>","","Reads the distinct moments in one timestamp column, as sorted ISO strings in the same format `momentsOfSteps` returns for a scenario.","Читає різні миті з однієї колонки часових позначок як відсортовані рядки ISO в тому самому вигляді, який `momentsOfSteps` повертає для сценарію.",testing-distinctMomentsIn-procedure
509
+ emptiedTables,procedure,"(tables: readonly string[]) => Effect.Effect<void, never, SqlClient.SqlClient>","","Empties the given tables on the live stand so a scenario starts from zero, the way a freshly reset database does for the seeder.","Спорожнює подані таблиці на живому стенді, щоб сценарій починався з нуля так само, як щойно скинута база починається для сіяча (seeder).",testing-emptiedTables-procedure
510
+ ensureStepsAreInOrder,procedure,"<C, S, X>(scenario: Scenario<C, S, X>) => Effect.Effect<void>","","Fails loudly when a scenario's steps are not in strictly increasing time order — that is a broken scenario, not a run outcome.","Гучно валить, коли кроки сценарію стоять не в строго зростальному порядку часу: це зламаний сценарій, а не результат прогону.",testing-ensureStepsAreInOrder-procedure
511
+ firstPassLabelsOf,procedure,"<C, S, X>(scenario: Scenario<C, S, X>) => readonly string[]","","The labels a scenario expects the first time it runs, in order.","Мітки, яких сценарій чекає першого разу, по порядку.",testing-firstPassLabelsOf-procedure
512
+ labelOf,procedure,"<R>(program: Effect.Effect<string, unknown, R>) => Effect.Effect<string, never, R>","","Runs one step and labels it: what it returned, or the name of the failure it met.","Виконує один крок і ставить йому мітку: що він повернув або як зветься відмова, яку він зустрів.",testing-labelOf-procedure
513
+ labelOfFailure,procedure,"(cause: Cause.Cause<unknown>) => string","","Labels a failure, so a scenario reads the same on every run.","Ставить мітку відмові, тож сценарій читається однаково на кожному прогоні.",testing-labelOfFailure-procedure
514
+ makeInMemoryBlobStoreWith,procedure,"(blobs: Ref.Ref<BlobsByKey>) => BlobStoreShape","","An in-memory blob store over a `Ref` you keep, so a test can seed it before the run and read it after.","Сховище об'єктів у пам'яті над `Ref`, який ви тримаєте, тож тест засіває його перед прогоном і читає після.",testing-makeInMemoryBlobStoreWith-procedure
515
+ makeInMemoryDocumentNumberCounterWith,procedure,"(counts: Ref.Ref<DocumentCountsByClientAndMonth>) => DocumentNumberCounterShape","","An in-memory counter over a reference you keep, so a test can seed it and read it back.","Лічильник у пам'яті над посиланням, яке ви тримаєте, тож тест засіває його і читає назад.",testing-makeInMemoryDocumentNumberCounterWith-procedure
516
+ makeInMemoryEventPublisherWith,procedure,"(published: Ref.Ref<PublishedMessages>) => EventPublisherShape","","An in-memory publisher over a `Ref` you keep, so a test reads what was published after the run.","Публікатор у пам'яті над `Ref`, який ви тримаєте, тож тест читає опубліковане після прогону.",testing-makeInMemoryEventPublisherWith-procedure
517
+ makeInMemoryExternalHttpClient,procedure,"(answers: AnswersByPath) => Effect.Effect<ExternalHttpClientShape>","","An in-memory client over a `Ref` of its own, seeded with the answers you hand it.","Клієнт у пам'яті над власним `Ref`, засіяний відповідями, які ви йому подали.",testing-makeInMemoryExternalHttpClient-procedure
518
+ makeInMemoryExternalHttpClientWith,procedure,"(answers: Ref.Ref<AnswersByPath>) => ExternalHttpClientShape","","An in-memory client over a `Ref` you keep, so a test rewrites what the service answers between two calls of the same scenario.","Клієнт у пам'яті над `Ref`, який ви тримаєте, тож тест переписує відповідь сервісу між двома викликами одного сценарію.",testing-makeInMemoryExternalHttpClientWith-procedure
519
+ makeInMemoryIntegrationEventOutboxWith,procedure,"(queued: Ref.Ref<QueuedOutboxMessages>, dispatched: Ref.Ref<DispatchedMessageIds>) => IntegrationEventOutboxShape","","An in-memory outbox over two `Ref`s you keep, so a test can seed what is waiting and read back what the relay dispatched.","Буфер трансмітера в пам'яті над двома `Ref`, які ви тримаєте, тож тест засіває те, що чекає, і читає назад те, що трансмітер відправив.",testing-makeInMemoryIntegrationEventOutboxWith-procedure
520
+ makeInMemoryProcessedEventRegistryWith,procedure,"(processed: Ref.Ref<ProcessedEventsById>) => ProcessedEventRegistryShape","","An in-memory registry over a `Ref` you keep, so a test can seed what was already claimed and read back what the run added.","Реєстр у пам'яті над `Ref`, який ви тримаєте, тож тест засіває вже зарезервоване і читає назад додане прогоном.",testing-makeInMemoryProcessedEventRegistryWith-procedure
521
+ makeInMemoryQueueMessageProducerWith,procedure,"(pending: Ref.Ref<PendingQueueMessages>) => QueueMessageProducerShape","",An in-memory producer over the same reference an in-memory source reads.,"Відправник у пам'яті над тим самим посиланням, яке читає джерело в пам'яті.",testing-makeInMemoryQueueMessageProducerWith-procedure
522
+ makeInMemoryQueueMessageSourceWith,procedure,"(pending: Ref.Ref<PendingQueueMessages>) => QueueMessageSourceShape","","An in-memory message source over a `Ref` you keep, so a test seeds the queue before the run and reads what is left after it.","Джерело повідомлень у пам'яті над `Ref`, який ви тримаєте, тож тест засіває чергу перед прогоном і читає, що лишилось після.",testing-makeInMemoryQueueMessageSourceWith-procedure
523
+ makeInMemoryTransactionBoundary,procedure,"(participants: readonly TransactionalState[]) => TransactionBoundaryShape","","Builds an in-memory transaction boundary: it captures each participant's state on entry and restores it if the work fails.","Будує межу транзакції в пам'яті: вона захоплює стан кожного учасника на вході і повертає його, коли робота падає.",testing-makeInMemoryTransactionBoundary-procedure
524
+ makeScriptedMessageSource,procedure,"(script: readonly (readonly RawQueueMessage[])[]) => Effect.Effect<ScriptedQueue>","",Builds the scripted source and the reader for what it acknowledged.,"Будує джерело за сценарієм і читача того, що воно підтвердило.",testing-makeScriptedMessageSource-procedure
525
+ messageOf,procedure,"(messageId: string, body: string) => RawQueueMessage","","One raw message, built the way a queue hands it over: an id, the receipt an acknowledgement quotes, and the body.","Одне сире повідомлення, збудоване так, як його віддає черга: ідентифікатор, квитанція, яку цитує підтвердження, і тіло.",testing-messageOf-procedure
526
+ momentsOfSteps,procedure,"<C, S, X>(scenario: Scenario<C, S, X>, chosen: (step: ScenarioStep<C>) => boolean) => readonly string[]","","Returns the moments of the chosen steps as ISO strings, in the format a database round-trip returns them.","Повертає миті обраних кроків рядками ISO, у тому вигляді, в якому їх повертає похід у базу і назад.",testing-momentsOfSteps-procedure
527
+ mutationSettings,procedure,"(options: MutationSettingsOptions) => MutationSettings","","Everything a mutation run needs, with the waits bounded and the live stands kept out.","Усе, що потрібно мутаційному прогону, з обмеженим очікуванням і без живих стендів.",testing-mutationSettings-procedure
528
+ playScenario,procedure,"<C, S, R, X>(scenario: Scenario<C, S, X>, service: ScenarioService<C, S, R, X>) => Effect.Effect<ScenarioPlayback<S>, never, R>","","Plays a scenario: each step runs at its own moment, and the snapshot is taken at the last step's moment.","Програє сценарій: кожен крок біжить у власну мить, а знімок беруть у мить останнього кроку.",testing-playScenario-procedure
529
+ quietReporters,procedure,"(options: QuietReporterOptions & { readonly verbose?: boolean } = {}) => ('default' | QuietReporter)[]","",The `reporters` a test-runner configuration takes.,"Значення `reporters`, яке бере конфігурація виконавця тестів.",testing-quietReporters-procedure
530
+ replayLabelsOf,procedure,"<C, S, X>(scenario: Scenario<C, S, X>) => readonly string[]","","The labels a scenario expects when the same steps run a second time, in order.","Мітки, яких сценарій чекає, коли ті самі кроки біжать удруге, по порядку.",testing-replayLabelsOf-procedure
531
+ setNowTo,procedure,"(isoTimestamp: string) => Effect.Effect<void>","",Sets the controlled test clock to the given ISO moment.,Ставить керований тестовий годинник на подану мить ISO.,testing-setNowTo-procedure
532
+ stateOfRef,procedure,"<A>(ref: Ref.Ref<A>) => TransactionalState","","Makes a `Ref` a participant, so an in-memory boundary can put it back where it was when the work fails.","Робить `Ref` учасником, тож межа в пам'яті вміє повернути його туди, де він був, коли робота падає.",testing-stateOfRef-procedure
533
+ typedFailureOf,procedure,"<A, E>(effect: Effect.Effect<A, E>) => Effect.Effect<E>","","Extracts a use case's typed failure (Fail) through `Effect.exit` and `Cause`, rather than by matching an error message string.","Дістає типізовану відмову (Data.TaggedError) процедури через `Effect.exit` і `Cause`, а не звіркою тексту повідомлення про помилку.",testing-typedFailureOf-procedure
534
+ verboseOutputWanted,procedure,"(environment: Readonly<Record<string, string | undefined>> = process.env) => boolean","",Whether the runner should print everything.,Чи має виконавець друкувати все.,testing-verboseOutputWanted-procedure
535
+ BlobStoreUnavailableLive,adapter,Layer.Layer<BlobStore>,"","A blob store that answers nothing: every operation fails with `BlobStoreUnavailableError`.","Сховище об'єктів, яке ні на що не відповідає: кожна операція падає з `BlobStoreUnavailableError`.",testing-BlobStoreUnavailableLive-adapter
536
+ DocumentNumberCounterUnavailableLive,adapter,Layer.Layer<DocumentNumberCounter>,"","A counter that counts nothing: every request comes back as a refusal.","Лічильник, який нічого не рахує: кожен запит повертається відмовою.",testing-DocumentNumberCounterUnavailableLive-adapter
537
+ EventPublisherUnavailableLive,adapter,Layer.Layer<EventPublisher>,"","A publisher that takes nothing: every publish fails with `EventPublisherUnavailableError`.","Публікатор, який нічого не бере: кожна публікація падає з `EventPublisherUnavailableError`.",testing-EventPublisherUnavailableLive-adapter
538
+ ExternalHttpClientUnavailableLive,adapter,Layer.Layer<ExternalHttpClient>,"","A client that reaches nothing: every call fails with `ExternalServiceUnavailableError`.","Клієнт, який нікуди не дістає: кожен виклик падає з `ExternalServiceUnavailableError`.",testing-ExternalHttpClientUnavailableLive-adapter
539
+ inMemoryExternalHttpClientLive,adapter,"(answers: AnswersByPath) => Layer.Layer<ExternalHttpClient>","","The in-memory client, mounted, answering the paths you seeded it with.","Змонтований клієнт у пам'яті, який відповідає на шляхи, якими ви його засіяли.",testing-inMemoryExternalHttpClientLive-adapter
540
+ InMemoryReadinessProbeLive,adapter,Layer.Layer<ReadinessProbe>,"","The in-memory probe, mounted.",Змонтована проба готовності в пам'яті.,testing-InMemoryReadinessProbeLive-adapter
541
+ inMemoryTransactionBoundaryLive,adapter,"(participants: readonly TransactionalState[]) => Layer.Layer<TransactionBoundary>","","The in-memory transaction boundary, mounted over the participants you name.","Змонтована межа транзакції в пам'яті, над названими вами учасниками.",testing-inMemoryTransactionBoundaryLive-adapter
542
+ IntegrationEventOutboxUnavailableLive,adapter,Layer.Layer<IntegrationEventOutbox>,"","An outbox that accepts nothing: `enqueue` refuses, so a use case's write and its message go down together.","Буфер трансмітера, який нічого не приймає: `enqueue` відмовляє, тож запис процедури і її повідомлення падають разом.",testing-IntegrationEventOutboxUnavailableLive-adapter
543
+ IntegrationEventOutboxUnreadableLive,adapter,Layer.Layer<IntegrationEventOutbox>,"","An outbox that takes messages and then refuses to hand them back: `pending` fails while `enqueue` succeeds.","Буфер трансмітера, який бере повідомлення і потім відмовляється їх віддати: `pending` падає, а `enqueue` вдається.",testing-IntegrationEventOutboxUnreadableLive-adapter
544
+ ProcessedEventRegistryUnavailableLive,adapter,Layer.Layer<ProcessedEventRegistry>,"","A registry that claims nothing: every claim comes back as a refusal.","Реєстр, який нічого не резервує: кожна резервація повертається відмовою.",testing-ProcessedEventRegistryUnavailableLive-adapter
545
+ QueueMessageProducerUnavailableLive,adapter,Layer.Layer<QueueMessageProducer>,"","A producer that answers nothing: every send fails with `QueueMessageProducerUnavailableError`.","Відправник, який ні на що не відповідає: кожне надсилання падає з `QueueMessageProducerUnavailableError`.",testing-QueueMessageProducerUnavailableLive-adapter
546
+ QueueMessageSourceUnavailableLive,adapter,Layer.Layer<QueueMessageSource>,"","A message source that answers nothing: every operation fails with `QueueMessageSourceUnavailableError`.","Джерело повідомлень, яке ні на що не відповідає: кожна операція падає з `QueueMessageSourceUnavailableError`.",testing-QueueMessageSourceUnavailableLive-adapter
547
+ ReadinessProbeUnavailableLive,adapter,Layer.Layer<ReadinessProbe>,"",A probe whose database never answers.,"Проба, чия база ніколи не відповідає.",testing-ReadinessProbeUnavailableLive-adapter
548
+ scriptedQueueMessageSourceLive,adapter,"(script: readonly (readonly RawQueueMessage[])[]) => Layer.Layer<QueueMessageSource>","","The scripted source, mounted: each `receive` answers with the next batch of the script.","Змонтоване джерело за сценарієм: кожен `receive` відповідає наступною пачкою сценарію.",testing-scriptedQueueMessageSourceLive-adapter
549
+ TransactionBoundaryUnavailableLive,adapter,Layer.Layer<TransactionBoundary>,"","A transaction boundary that opens nothing: the work never runs and the caller reads the refusal.","Межа транзакції, яка нічого не відкриває: робота ніколи не біжить, і викликач читає відмову.",testing-TransactionBoundaryUnavailableLive-adapter
550
+ - mechanism: vitest
551
+ import: @satorio/machinery/vitest
552
+ kind: test kit
553
+ page: mechanisms/vitest
554
+ what: "Public entry to the vitest mechanism: live stands, port contracts, and the guards that read the test runtime."
555
+ whatUk: "Публічний вхід до механізму vitest: живі стенди, контракти портів і три перевірки збірки (guard), які тримають рантайм цих тестів."
556
+ rows[38]{name,kind,signature,fallback,caption,captionUk,anchor}:
557
+ AwsStand,value,interface,"",The address and the region of the live AWS stand a suite talks to.,"Адреса і регіон живого стенда AWS, з яким говорить сьют.",vitest-AwsStand-value
558
+ FILES_THAT_FORK_A_FIBER_AND_ADJUST_TEST_CLOCK,value,"readonly string[]","","The test files that need their own fresh module state, because they fork a fiber and move the clock.","Тестові файли, яким потрібен власний свіжий стан модулів, бо вони форкають файбер і рухають годинник.",vitest-FILES-THAT-FORK-A-FIBER-AND-ADJUST-TEST-CLOCK-value
559
+ LOCALSTACK_REGION,value,const,"",The one region every client and resource in a suite agrees on.,"Єдиний регіон, про який домовляються кожен клієнт і кожен ресурс у сьюті.",vitest-LOCALSTACK-REGION-value
560
+ PortContractTester,value,type,"",The subset of vitest test methods a port contract needs from its tester.,"Той підмножинний набір тестових методів vitest, якого контракт порту потребує від свого тестувальника.",vitest-PortContractTester-value
561
+ POSTGRES_IMAGE,value,const,"",The Postgres image every live-stand test starts through testcontainers.,"Образ Postgres, який кожен тест на живому стенді піднімає через testcontainers.",vitest-POSTGRES-IMAGE-value
562
+ ReaderPortUnderTest,value,interface,"",What a reader port's own test hands the contract.,Що власний тест порту-читача подає контрактові.,vitest-ReaderPortUnderTest-value
563
+ RecordedStubRequest,value,interface,"","One request the stub server received, as a test reads it back: the method and the path.","Один запит, який отримав стаб-сервер (stub server), у тому вигляді, в якому тест читає його назад: метод і шлях.",vitest-RecordedStubRequest-value
564
+ StubResponse,value,interface,"","One answer the stub server gives: the status, the body and content type where there is one, and the delay before it answers.","Одна відповідь стаб-сервера: статус, тіло і тип вмісту, коли вони є, і затримка перед відповіддю.",vitest-StubResponse-value
565
+ StubRoute,value,interface,"","One route the stub server serves: the method, the path, and the answers it gives in turn.","Один маршрут, який обслуговує стаб-сервер: метод, шлях і відповіді, які він дає по черзі.",vitest-StubRoute-value
566
+ blobStoreContract,procedure,"(it: PortContractTester, implementationName: string, layer: Layer.Layer<BlobStore>, unavailable?: Layer.Layer<BlobStore>) => void","","One contract, every blob store.","Один контракт, кожне сховище об'єктів.",vitest-blobStoreContract-procedure
567
+ documentNumberCounterContract,procedure,"(it: PortContractTester, implementationName: string, layer: Layer.Layer<DocumentNumberCounter>, unavailable?: Layer.Layer<DocumentNumberCounter>) => void","","One contract, every counter implementation.","Один контракт, кожна реалізація лічильника.",vitest-documentNumberCounterContract-procedure
568
+ eventPublisherContract,procedure,"(it: PortContractTester, implementationName: string, publisher: PublisherUnderTest, unavailable?: Layer.Layer<EventPublisher>) => void","","One contract, every event publisher.","Один контракт, кожен публікатор подій.",vitest-eventPublisherContract-procedure
569
+ externalHttpClientContract,procedure,"(it: PortContractTester, implementationName: string, service: ExternalServiceUnderTest, unavailable?: Layer.Layer<ExternalHttpClient>) => void","","One contract, every external HTTP client.","Один контракт, кожен зовнішній HTTP-клієнт.",vitest-externalHttpClientContract-procedure
570
+ integrationEventOutboxContract,procedure,"(it: PortContractTester, implementationName: string, layer: Layer.Layer<IntegrationEventOutbox>, unavailable?: Layer.Layer<IntegrationEventOutbox>) => void","","One contract, every integration event outbox.","Один контракт, кожен буфер трансмітера.",vitest-integrationEventOutboxContract-procedure
571
+ onLocalstack,procedure,"(options: LocalstackSuiteOptions, subject: string, checks: SuiteChecks) => void","",Runs a suite against a real AWS stand (localstack) for `subject`.,Крутить сьют проти справжнього стенда AWS (localstack) для `subject`.,vitest-onLocalstack-procedure
572
+ onPostgres,procedure,"(options: PostgresSuiteOptions, subject: string, checks: SuiteChecks) => void","","Runs a suite against a real Postgres — the container, or an externally configured database when `PGHOST` is set.","Крутить сьют проти справжнього Postgres — контейнера або зовні налаштованої бази, коли поставлено `PGHOST`.",vitest-onPostgres-procedure
573
+ onPostgresContainer,procedure,"(options: PostgresSuiteOptions, subject: string, checks: SuiteChecks) => void","","Runs a suite against a container-only Postgres, ignoring any `PG*` environment variables.","Крутить сьют проти Postgres лише в контейнері, ігноруючи будь-які змінні оточення `PG*`.",vitest-onPostgresContainer-procedure
574
+ outboxEvent,procedure,"(messageId: string, payload: { readonly [key: string]: unknown }) => OutboxMessage","","One message, built the way an outbox hands it over.","Одне повідомлення, збудоване так, як його віддає буфер трансмітера.",vitest-outboxEvent-procedure
575
+ outboxMessage,procedure,"(messageId: string) => OutboxMessage","","One outbox message a contract enqueues and reads back, so every implementation is asked the same question.","Одне повідомлення буфера, яке контракт ставить у чергу і читає назад, тож кожній реалізації ставлять те саме питання.",vitest-outboxMessage-procedure
576
+ processedEventRegistryContract,procedure,"(it: PortContractTester, implementationName: string, layer: Layer.Layer<ProcessedEventRegistry>, unavailable?: Layer.Layer<ProcessedEventRegistry>) => void","","One contract, every processed event registry.","Один контракт, кожен реєстр відпрацьованих подій.",vitest-processedEventRegistryContract-procedure
577
+ queueMessageProducerContract,procedure,"(it: PortContractTester, implementationName: string, producer: ProducerUnderTest, unavailable?: Layer.Layer<QueueMessageProducer>) => void","","One contract, every message producer.","Один контракт, кожен відправник повідомлень.",vitest-queueMessageProducerContract-procedure
578
+ queueMessageSourceContract,procedure,"(it: PortContractTester, implementationName: string, queue: QueueUnderTest, unavailable?: Layer.Layer<QueueMessageSource>) => void","","One contract, every message source.","Один контракт, кожне джерело повідомлень.",vitest-queueMessageSourceContract-procedure
579
+ readerPortContract,procedure,"<Subject, Value>(it: PortContractTester, port: ReaderPortUnderTest<Subject, Value>) => void","",One contract for a port that only reads.,"Один контракт для порту, який лише читає.",vitest-readerPortContract-procedure
580
+ readinessProbeContract,procedure,"(it: PortContractTester, implementationName: string, layer: Layer.Layer<ReadinessProbe>, unavailable?: Layer.Layer<ReadinessProbe>) => void","","One contract, every readiness probe.","Один контракт, кожна проба готовності.",vitest-readinessProbeContract-procedure
581
+ repoCommittableFiles,procedure,"(root: string = repoRoot()) => readonly string[]","",Every file git would commit as it stands under `root`.,"Кожен файл, який git закомітив би таким, яким той стоїть під `root`.",vitest-repoCommittableFiles-procedure
582
+ repoFilesUnder,procedure,"(root: string, directories: readonly string[], extension: string) => readonly string[]","","Lists files with `extension` recursively under `directories`, relative to `root`.","Перелічує файли з розширенням `extension` рекурсивно під `directories`, відносно `root`.",vitest-repoFilesUnder-procedure
583
+ repoRoot,procedure,"(cwd: string = process.cwd()) => string","",Root of the git repository that contains `cwd` (`process.cwd()` by default).,"Корінь git-репозиторію, який містить `cwd` (за замовчуванням `process.cwd()`).",vitest-repoRoot-procedure
584
+ scopedStubServer,procedure,"(routes: readonly StubRoute[]) => Effect.Effect<StubServerShape, never, Scope.Scope>","",Runs the stub server for the lifetime of a scope.,"Крутить стаб-сервер стільки, скільки живе скоуп.",vitest-scopedStubServer-procedure
585
+ settingsContract,procedure,"<A>(mechanism: string, environment: readonly EnvironmentEntry[], settings: Config.Config<A>, variablePrefix = '') => void","","One contract, every adapter that names variables.","Один контракт, кожен адаптер, який називає змінні.",vitest-settingsContract-procedure
586
+ storedBlob,procedure,"(text: string) => StoredBlob","","One blob a contract stores and reads back, so every implementation is asked the same question.","Один об'єкт, який контракт зберігає і читає назад, тож кожній реалізації ставлять те саме питання.",vitest-storedBlob-procedure
587
+ transactionBoundaryContract,procedure,"(it: PortContractTester, implementationName: string, layer: Layer.Layer<TransactionBoundary>, unavailable?: Layer.Layer<TransactionBoundary>) => void","","One contract, every transaction boundary.","Один контракт, кожна межа транзакції.",vitest-transactionBoundaryContract-procedure
588
+ truncateTables,procedure,"(tableNames: readonly string[]) => Effect.Effect<void, SqlError, SqlClient.SqlClient>","","Empties the named tables in one query, for a test that needs a familiar initial state.","Спорожнює названі таблиці одним запитом — для тесту, якому потрібен знайомий початковий стан.",vitest-truncateTables-procedure
589
+ postgresInContainerLive,adapter,"(options: PostgresSuiteOptions) => Layer.Layer<never>","","Builds the Postgres layer for a suite from a fresh container only, ignoring any `PG*` environment variables.","Будує шар Postgres для сьюта лише зі свіжого контейнера, ігноруючи будь-які змінні оточення `PG*`.",vitest-postgresInContainerLive-adapter
590
+ PostgresPortsUnderTestLive,adapter,Layer.Layer<PostgresPorts | PgClient.PgClient | SqlClient.SqlClient>,"","The Postgres mechanism's own ports, on the suite's database.",Власні порти механізму postgres на базі цього сьюта.,vitest-PostgresPortsUnderTestLive-adapter
591
+ postgresUnderTestLive,adapter,"(options: PostgresSuiteOptions) => Layer.Layer<never>","","The Postgres layer a suite runs on: the configured database when the environment names one, a fresh container when it does not, migrated either way.","Шар Postgres, на якому біжить сьют: налаштована база, коли оточення її називає, свіжий контейнер, коли ні, і мігровані обидва.",vitest-postgresUnderTestLive-adapter
592
+ oneEffectInstanceGuard,guard,"(options: SingleEffectInstanceOptions = {}) => void","",Registers a vitest suite that fails when a tree holds more than one copy of Effect.,"Реєструє сьют vitest, який валить прогін, коли дерево тримає більш ніж одну копію Effect.",vitest-oneEffectInstanceGuard-guard
593
+ oneFastCheckInstanceGuard,guard,() => void,"",Registers a vitest suite that fails when the property library resolves to two module instances.,"Реєструє сьют vitest, який валить прогін, коли бібліотека властивостей резолвиться у два примірники модуля.",vitest-oneFastCheckInstanceGuard-guard
594
+ testclockForkIsolationGuard,guard,"(knownIsolatedFiles: readonly string[], options: TestclockForkIsolationOptions) => void","",Registers a vitest suite that fails when a test moves the clock in a forked fiber outside its own list.,"Реєструє сьют vitest, який валить прогін, коли тест рухає годинник у форкнутому файбері поза власним списком.",vitest-testclockForkIsolationGuard-guard
595
+ terms[44]{term,meaning}:
596
+ adapter,The one concrete implementation of a port a composition root mounts for one running app.
597
+ allocation,"Splitting an amount by proportions so the parts add back to what went in, and the remainder goes out one minor unit at a time."
598
+ blob store,"The S3-shaped port for put, get, exists, and delete on a byte payload identified by a key."
599
+ calendar day,"One day of the calendar, with no time and no zone in it, written the way a person writes it or the way a machine does."
600
+ check digit,"One extra digit computed from the others, so a number somebody mistyped fails on the doorstep instead of in an account."
601
+ claim-once,"The shared exactly-once lock every \"take this exactly once\" use case calls, keyed by an idempotency key the use case itself builds."
602
+ closed set,"A named list of allowed values with nothing outside it: the type refuses any value the list does not name."
603
+ composition root,"The one place that knows an app's whole makeup: which driver backs which port, which queue is mounted, which server starts."
604
+ consumer,"The loop that takes a message from the queue and gives it one of three outcomes: acknowledged, retried later, or refused for good; your handler only decides, the consumer carries out."
605
+ creditor reference,"The ISO 11649 payment reference a payer types into a bank: the letters RF, two check digits, and the digits of the document number."
606
+ series,"The kind of document a number stands for, taken from a closed set the service names: a proforma, an invoice, a credit note."
607
+ external perimeter,"The line between the machinery and something outside its own process — an HTTP service, an object store, a message bus — that the integration, storage, and publishing mechanisms hold against."
608
+ federation,"The Apollo-shaped composition of several GraphQL subgraphs, each owned by its own service, into one schema a client reads as one."
609
+ full check,"The repository's whole `bun run check` run — formatter, types, dependency boundaries, Effect diagnostics, and the whole test suite — that must pass green before a commit."
610
+ guard,"A vitest suite, packaged as a callable function, that fails a build on one specific rule, proven by breaking that rule on purpose."
611
+ implant,"The business module a service carries on this machinery: one bounded piece of business logic that never imports a neighbour. This package supports that shape and recommends it; the platform's own pages carry the detail, at [Business Machinery](https://docs.satorio.dev/business-machinery/)."
612
+ instant,"One moment on the world's clock, held as whole milliseconds and carrying no zone of its own."
613
+ live stand,"A real dependency started in a container for a test to run against, never mocked and never skipped when the container fails to start."
614
+ the machinery,"This package: the engine half of a backend service, with no knowledge of the business domain it carries."
615
+ mechanism,"One npm subpath export of the package, with its own public entry point, that no import reaches around from outside."
616
+ migration,"One numbered, forward-only SQL file that changes the Postgres schema, applied by the package's own migration runner."
617
+ minor unit,"The smallest unit a currency counts in, the cent of a dollar, and the whole number an amount is held as."
618
+ outbox,"The table a use case writes an event to, in the same transaction as its own state change."
619
+ outbox relay,"The process that reads the messages waiting in the outbox, hands them to a publisher, and marks them delivered only after the publisher accepted them."
620
+ package,"The npm package this documentation describes: one published name that hands out one subpath export per mechanism."
621
+ peer dependency,"A package the machinery expects your service to install itself, so one copy serves both instead of two copies quietly disagreeing."
622
+ period,"A run of calendar days with both bounds inside it: the first day and the last day both belong to the period."
623
+ port,"A boundary the machinery defines and a service depends on, without knowing which driver answers it in production, a test, or a seeder."
624
+ publisher,The adapter that hands an event to the world outside the service and reports back whether it was accepted.
625
+ readiness probe,"An `Effect` that fails when a dependency does not answer, so `/readyz` reports `down` instead of `200` while it is out."
626
+ refusal,"A message outcome that stops a consumer from retrying, because retrying the same message would never succeed."
627
+ reporting month,"The month a document reports on, written as two digits of year and two of month, which is also the month its count runs in."
628
+ runtime guard,"A function derived from a closed set or a tagged union that checks a value against it while the program runs, not only at compile time."
629
+ scale,"How many decimal places an amount keeps, so a calculation that earns more digits does not lose them early."
630
+ scenario,"A named sequence of steps written as data, not as a hand-written test script: the story a service should be able to tell, which the scenario player runs."
631
+ scenario player,"The function that runs a scenario's steps in order, each at its own moment, through a service's own `perform` and `snapshot` functions."
632
+ seeder,"The scenario player run outside the test runner, against a real database, so a local or demo environment fills through the same path production takes."
633
+ share,"A part of an amount, written as a percentage or as a ratio, and held exactly rather than as a rounded number."
634
+ stub server,"A real HTTP server on a local port, used to prove the actual wire shape a client sends and reads, including a real network timeout."
635
+ test,One named check that runs the code and fails out loud when the result differs from what the check states.
636
+ test runner,"The program that finds every test file, runs the tests in it, reports each result, and fails the whole run when one test fails; here it is vitest."
637
+ time zone,"One named place on the map of clocks, which decides what day and what wall time a moment reads as."
638
+ typed failure,"One `Data.TaggedError` subclass per distinct way an operation can fail, so a caller matches on `_tag` instead of guessing a cause from an error message."
639
+ use case,"A sequence with an intent and a result: the steps by which a service carries out one intent; in code, one Effect describes it."