@satorio/machinery 0.2.1

package/dictionary/ports.json

@@ -0,0 +1,392 @@
+{
+  "package": "@satorio/machinery",
+  "version": "0.2.1",
+  "mechanism": {
+    "mechanism": "ports",
+    "import": "@satorio/machinery/ports",
+    "kind": "foundation",
+    "page": "mechanisms/ports",
+    "what": "Public entry to the ports mechanism: every boundary a use case may ask for, and the failure each one raises.",
+    "whatUk": "Публічний вхід до механізму ports: кожна межа, яку може попросити процедура (use case), і відмова (refusal), яку піднімає кожна з них.",
+    "rows": [
+      {
+        "name": "BlobStoreShape",
+        "kind": "value",
+        "signature": "interface",
+        "fallback": "",
+        "caption": "The blob store's operations.",
+        "captionUk": "Операції сховища об'єктів (blob store).",
+        "anchor": "ports-BlobStoreShape-value"
+      },
+      {
+        "name": "claimAccepted",
+        "kind": "value",
+        "signature": "ProcessedEventClaim",
+        "fallback": "",
+        "caption": "The claim nobody had taken yet, so this run is the one that does the work.",
+        "captionUk": "Резервація (claim-once), якої ще ніхто не взяв, тож саме цей прогін робить роботу.",
+        "anchor": "ports-claimAccepted-value"
+      },
+      {
+        "name": "ClaimProcessedEventInput",
+        "kind": "value",
+        "signature": "interface",
+        "fallback": "",
+        "caption": "What a claim needs: which event is being claimed, and the moment it is claimed at.",
+        "captionUk": "Що потрібно резервації: яку подію резервують і в яку мить це роблять.",
+        "anchor": "ports-ClaimProcessedEventInput-value"
+      },
+      {
+        "name": "DocumentNumberCounterShape",
+        "kind": "value",
+        "signature": "interface",
+        "fallback": "",
+        "caption": "What the counter offers: one call that moves a client's month on and hands back the count the next document takes.",
+        "captionUk": "Що пропонує лічильник: один виклик, який рухає місяць клієнта далі й подає лічбу, яку візьме наступний документ.",
+        "anchor": "ports-DocumentNumberCounterShape-value"
+      },
+      {
+        "name": "DocumentNumberCountInput",
+        "kind": "value",
+        "signature": "interface",
+        "fallback": "",
+        "caption": "Which counter to move on: one client, one reporting month.",
+        "captionUk": "Який лічильник рухати далі: один клієнт, один звітний місяць (reporting month).",
+        "anchor": "ports-DocumentNumberCountInput-value"
+      },
+      {
+        "name": "EventPublisherShape",
+        "kind": "value",
+        "signature": "interface",
+        "fallback": "",
+        "caption": "What a publisher offers: one call that sends a batch of outbox messages out of this service.",
+        "captionUk": "Що пропонує публікатор: один виклик, який надсилає пачку повідомлень із буфера трансмітера (outbox) геть із цього сервісу.",
+        "anchor": "ports-EventPublisherShape-value"
+      },
+      {
+        "name": "ExternalHttpClientShape",
+        "kind": "value",
+        "signature": "interface",
+        "fallback": "",
+        "caption": "One external HTTP service, read through one operation.",
+        "captionUk": "Один зовнішній HTTP-сервіс, прочитаний однією операцією.",
+        "anchor": "ports-ExternalHttpClientShape-value"
+      },
+      {
+        "name": "IntegrationEventOutboxShape",
+        "kind": "value",
+        "signature": "interface",
+        "fallback": "",
+        "caption": "The outbox holds messages a use case enqueues in the same transaction as its state change.",
+        "captionUk": "Буфер трансмітера тримає повідомлення, які процедура ставить у чергу тією самою транзакцією, що й свою зміну стану.",
+        "anchor": "ports-IntegrationEventOutboxShape-value"
+      },
+      {
+        "name": "OutboxMessage",
+        "kind": "value",
+        "signature": "interface",
+        "fallback": "",
+        "caption": "One message waiting in the outbox: its own id, what it is, which schema shaped it, when it happened, and what it carries.",
+        "captionUk": "Одне повідомлення, що чекає в буфері трансмітера: власний ідентифікатор, що воно таке, яка схема надала йому форми, коли воно сталось і що воно несе.",
+        "anchor": "ports-OutboxMessage-value"
+      },
+      {
+        "name": "PORT_FAILURES_IN_THE_EVENTS_LANGUAGE",
+        "kind": "value",
+        "signature": "Readonly<Record<string, string>>",
+        "fallback": "",
+        "caption": "A port failure named in the event's language rather than as `<Port>UnavailableError`, with the sentence that earns the exception.",
+        "captionUk": "Відмова порту, названа мовою події, а не як `<Port>UnavailableError`, разом із реченням, яке заслуговує на цей виняток.",
+        "anchor": "ports-PORT-FAILURES-IN-THE-EVENTS-LANGUAGE-value"
+      },
+      {
+        "name": "ProcessedEventClaim",
+        "kind": "value",
+        "signature": "type",
+        "fallback": "",
+        "caption": "The two states of the claim-once lock: this run took the event, or somebody already had.",
+        "captionUk": "Два стани замка резервації: цей прогін узяв подію, або хтось уже взяв її раніше.",
+        "anchor": "ports-ProcessedEventClaim-value"
+      },
+      {
+        "name": "ProcessedEventRegistryShape",
+        "kind": "value",
+        "signature": "interface",
+        "fallback": "",
+        "caption": "What the claim-once lock offers: one call that either takes an event for the first time or says when it was taken before.",
+        "captionUk": "Що пропонує замок резервації: один виклик, який або бере подію вперше, або каже, коли її взяли раніше.",
+        "anchor": "ports-ProcessedEventRegistryShape-value"
+      },
+      {
+        "name": "QueueMessageProducerShape",
+        "kind": "value",
+        "signature": "interface",
+        "fallback": "",
+        "caption": "What a producer offers: one call that puts a message body onto the queue.",
+        "captionUk": "Що пропонує відправник: один виклик, який кладе тіло повідомлення в чергу.",
+        "anchor": "ports-QueueMessageProducerShape-value"
+      },
+      {
+        "name": "QueueMessageSourceShape",
+        "kind": "value",
+        "signature": "interface",
+        "fallback": "",
+        "caption": "A source of queue messages: it receives a batch and acknowledges what was taken.",
+        "captionUk": "Джерело повідомлень черги: воно отримує пачку і підтверджує взяте.",
+        "anchor": "ports-QueueMessageSourceShape-value"
+      },
+      {
+        "name": "RawQueueMessage",
+        "kind": "value",
+        "signature": "interface",
+        "fallback": "",
+        "caption": "One message as the queue hands it over: its own id, the receipt an acknowledgement quotes, and the body, still text.",
+        "captionUk": "Одне повідомлення таким, яким його віддає черга: власний ідентифікатор, квитанція, яку цитує підтвердження, і тіло, ще текстом.",
+        "anchor": "ports-RawQueueMessage-value"
+      },
+      {
+        "name": "ReadinessProbeShape",
+        "kind": "value",
+        "signature": "interface",
+        "fallback": "",
+        "caption": "What a readiness probe offers: one check that the database answers, so the endpoint reports a dependency rather than a guess.",
+        "captionUk": "Що пропонує проба готовності: одна перевірка того, що база відповідає, тож точка звітує про залежність, а не про здогад.",
+        "anchor": "ports-ReadinessProbeShape-value"
+      },
+      {
+        "name": "StoredBlob",
+        "kind": "value",
+        "signature": "interface",
+        "fallback": "",
+        "caption": "A stored blob's bytes, content type, and free-form text metadata.",
+        "captionUk": "Байти збереженого об'єкта, його тип вмісту і довільні текстові метадані.",
+        "anchor": "ports-StoredBlob-value"
+      },
+      {
+        "name": "TransactionBoundaryShape",
+        "kind": "value",
+        "signature": "interface",
+        "fallback": "",
+        "caption": "What a transaction boundary offers: one call that runs work inside a transaction, and rolls the whole of it back when the work fails.",
+        "captionUk": "Що пропонує межа транзакції: один виклик, який виконує роботу всередині транзакції і відкочує її цілком, коли робота падає.",
+        "anchor": "ports-TransactionBoundaryShape-value"
+      },
+      {
+        "name": "alreadyProcessed",
+        "kind": "procedure",
+        "signature": "(processedAt: DateTime.Utc) => ProcessedEventClaim",
+        "fallback": "",
+        "caption": "The claim somebody else already took, with the moment they took it.",
+        "captionUk": "Резервація, яку хтось уже взяв, разом із миттю, коли він її взяв.",
+        "anchor": "ports-alreadyProcessed-procedure"
+      },
+      {
+        "name": "portUnavailable",
+        "kind": "procedure",
+        "signature": "<E>(Unavailable: new (fields: { readonly operation: string; readonly cause: unknown }) => E)",
+        "fallback": "",
+        "caption": "Builds the \"did not answer\" failure factory around one port's own `<Port>UnavailableError` constructor.",
+        "captionUk": "Будує фабрику відмов «не відповів» навколо власного конструктора `<Port>UnavailableError` одного порту.",
+        "anchor": "ports-portUnavailable-procedure"
+      },
+      {
+        "name": "BlobStore",
+        "kind": "port",
+        "signature": "Context.Tag('BlobStore')",
+        "fallback": "",
+        "caption": "The port a use case asks for when it stores whole objects under a key and reads them back.",
+        "captionUk": "Порт, який просить процедура, коли зберігає цілі об'єкти під ключем і читає їх назад.",
+        "anchor": "ports-BlobStore-port"
+      },
+      {
+        "name": "DocumentNumberCounter",
+        "kind": "port",
+        "signature": "Context.Tag('DocumentNumberCounter')",
+        "fallback": "",
+        "caption": "The port a use case asks for when it numbers a document a person will read.",
+        "captionUk": "Порт, який просить процедура, коли нумерує документ, що його читатиме людина.",
+        "anchor": "ports-DocumentNumberCounter-port"
+      },
+      {
+        "name": "EventPublisher",
+        "kind": "port",
+        "signature": "Context.Tag('EventPublisher')",
+        "fallback": "",
+        "caption": "The port the outbox relay asks for when it announces what has already happened.",
+        "captionUk": "Порт, який просить трансмітер вихідних подій (outbox relay), коли оголошує те, що вже сталось.",
+        "anchor": "ports-EventPublisher-port"
+      },
+      {
+        "name": "ExternalHttpClient",
+        "kind": "port",
+        "signature": "Context.Tag('ExternalHttpClient')",
+        "fallback": "",
+        "caption": "The port a use case asks for when it reads reference data from a service outside this one.",
+        "captionUk": "Порт, який просить процедура, коли читає довідкові дані із сервісу поза цим.",
+        "anchor": "ports-ExternalHttpClient-port"
+      },
+      {
+        "name": "IntegrationEventOutbox",
+        "kind": "port",
+        "signature": "Context.Tag( 'IntegrationEventOutbox', )",
+        "fallback": "",
+        "caption": "The port a use case asks for when it enqueues an event in the same transaction as the state change that caused it.",
+        "captionUk": "Порт, який просить процедура, коли ставить подію в чергу тією самою транзакцією, що й зміну стану, яка її спричинила.",
+        "anchor": "ports-IntegrationEventOutbox-port"
+      },
+      {
+        "name": "ProcessedEventRegistry",
+        "kind": "port",
+        "signature": "Context.Tag( 'ProcessedEventRegistry', )",
+        "fallback": "",
+        "caption": "The port a use case asks for when an event must be acted on exactly once, however many times it arrives.",
+        "captionUk": "Порт, який просить процедура, коли подію треба відпрацювати рівно раз, хоч би скільки разів вона прийшла.",
+        "anchor": "ports-ProcessedEventRegistry-port"
+      },
+      {
+        "name": "QueueMessageProducer",
+        "kind": "port",
+        "signature": "Context.Tag('QueueMessageProducer')",
+        "fallback": "",
+        "caption": "The port a use case asks for when it sends a message to a queue.",
+        "captionUk": "Порт, який просить процедура, коли надсилає повідомлення в чергу.",
+        "anchor": "ports-QueueMessageProducer-port"
+      },
+      {
+        "name": "QueueMessageSource",
+        "kind": "port",
+        "signature": "Context.Tag('QueueMessageSource')",
+        "fallback": "",
+        "caption": "The port a consumer asks for when it receives messages from a queue and acknowledges what it took.",
+        "captionUk": "Порт, який просить робітник, коли отримує повідомлення з черги і підтверджує взяте.",
+        "anchor": "ports-QueueMessageSource-port"
+      },
+      {
+        "name": "ReadinessProbe",
+        "kind": "port",
+        "signature": "Context.Tag('ReadinessProbe')",
+        "fallback": "",
+        "caption": "The port the readiness endpoint asks for when it has to say whether this service can take traffic.",
+        "captionUk": "Порт, який просить точка готовності, коли має сказати, чи цей сервіс може брати трафік.",
+        "anchor": "ports-ReadinessProbe-port"
+      },
+      {
+        "name": "TransactionBoundary",
+        "kind": "port",
+        "signature": "Context.Tag('TransactionBoundary')",
+        "fallback": "",
+        "caption": "The port a use case asks for when its writes must land together or not at all.",
+        "captionUk": "Порт, який просить процедура, коли її записи мають лягти разом або не лягти зовсім.",
+        "anchor": "ports-TransactionBoundary-port"
+      },
+      {
+        "name": "BlobStoreUnavailableError",
+        "kind": "failure",
+        "signature": "Data.TaggedError<{ readonly operation: string; readonly cause: unknown }>",
+        "fallback": "",
+        "caption": "The object store did not answer; a key that is not there at all is never this failure.",
+        "captionUk": "Сховище об'єктів не відповіло; ключ, якого там просто немає, ніколи не є цією відмовою.",
+        "anchor": "ports-BlobStoreUnavailableError-failure"
+      },
+      {
+        "name": "DatabaseDidNotAnswerError",
+        "kind": "failure",
+        "signature": "Data.TaggedError<{ readonly reason: string }>",
+        "fallback": "",
+        "caption": "The readiness check against the database did not come back; `reason` says what stopped it.",
+        "captionUk": "Перевірка готовності проти бази не повернулась; `reason` каже, що її спинило.",
+        "anchor": "ports-DatabaseDidNotAnswerError-failure"
+      },
+      {
+        "name": "DocumentNumberCounterUnavailableError",
+        "kind": "failure",
+        "signature": "Data.TaggedError<{ readonly operation: string; readonly cause: unknown }>",
+        "fallback": "",
+        "caption": "The counter behind a document number did not answer; `operation` names the call and `cause` carries the driver's own error.",
+        "captionUk": "Лічильник за номером документа не відповів; `operation` називає виклик, а `cause` несе власну помилку драйвера.",
+        "anchor": "ports-DocumentNumberCounterUnavailableError-failure"
+      },
+      {
+        "name": "EventPublisherUnavailableError",
+        "kind": "failure",
+        "signature": "Data.TaggedError<{ readonly operation: string; readonly cause: unknown }>",
+        "fallback": "",
+        "caption": "The publisher did not answer, or no topic is configured; `cause` says which of the two it was.",
+        "captionUk": "Публікатор не відповів, або топік не налаштований; `cause` каже, що з двох сталось.",
+        "anchor": "ports-EventPublisherUnavailableError-failure"
+      },
+      {
+        "name": "ExternalServiceRefusedError",
+        "kind": "failure",
+        "signature": "Data.TaggedError<{ readonly service: string; readonly operation: string; readonly status: number }>",
+        "fallback": "",
+        "caption": "The external service answered with a refusal of its own, so the same request will fail again until the request changes.",
+        "captionUk": "Зовнішній сервіс відповів власною відмовою, тож той самий запит падатиме знову, доки запит не зміниться.",
+        "anchor": "ports-ExternalServiceRefusedError-failure"
+      },
+      {
+        "name": "ExternalServiceResponseMalformedError",
+        "kind": "failure",
+        "signature": "Data.TaggedError<{ readonly service: string; readonly operation: string; readonly cause: unknown }>",
+        "fallback": "",
+        "caption": "The external service answered, but the body did not fit the schema the caller handed in.",
+        "captionUk": "Зовнішній сервіс відповів, але тіло не лягло в схему, яку подав викликач.",
+        "anchor": "ports-ExternalServiceResponseMalformedError-failure"
+      },
+      {
+        "name": "ExternalServiceUnavailableError",
+        "kind": "failure",
+        "signature": "Data.TaggedError<{ readonly service: string; readonly operation: string; readonly cause: unknown }>",
+        "fallback": "",
+        "caption": "A network failure, a timeout, or a server error after the retries ran out; the same request may well succeed later.",
+        "captionUk": "Мережева невдача, вичерпаний строк або помилка сервера після того, як скінчились спроби; той самий запит цілком може вдатись пізніше.",
+        "anchor": "ports-ExternalServiceUnavailableError-failure"
+      },
+      {
+        "name": "IntegrationEventOutboxUnavailableError",
+        "kind": "failure",
+        "signature": "Data.TaggedError<{ readonly operation: string; readonly cause: unknown }>",
+        "fallback": "",
+        "caption": "The outbox driver did not answer; `operation` names the call and `cause` carries the driver's own error.",
+        "captionUk": "Драйвер буфера трансмітера не відповів; `operation` називає виклик, а `cause` несе власну помилку драйвера.",
+        "anchor": "ports-IntegrationEventOutboxUnavailableError-failure"
+      },
+      {
+        "name": "ProcessedEventRegistryUnavailableError",
+        "kind": "failure",
+        "signature": "Data.TaggedError<{ readonly operation: string; readonly cause: unknown }>",
+        "fallback": "",
+        "caption": "The claim-once driver did not answer; `operation` names the call and `cause` carries the driver's own error.",
+        "captionUk": "Драйвер резервації не відповів; `operation` називає виклик, а `cause` несе власну помилку драйвера.",
+        "anchor": "ports-ProcessedEventRegistryUnavailableError-failure"
+      },
+      {
+        "name": "QueueMessageProducerUnavailableError",
+        "kind": "failure",
+        "signature": "Data.TaggedError<{ readonly operation: string; readonly cause: unknown }>",
+        "fallback": "",
+        "caption": "The queue producer did not answer; `operation` names the call and `cause` carries the driver's own error.",
+        "captionUk": "Відправник черги не відповів; `operation` називає виклик, а `cause` несе власну помилку драйвера.",
+        "anchor": "ports-QueueMessageProducerUnavailableError-failure"
+      },
+      {
+        "name": "QueueMessageSourceUnavailableError",
+        "kind": "failure",
+        "signature": "Data.TaggedError<{ readonly operation: string; readonly cause: unknown }>",
+        "fallback": "",
+        "caption": "The queue source did not answer; `operation` names the call and `cause` carries the driver's own error.",
+        "captionUk": "Джерело черги не відповіло; `operation` називає виклик, а `cause` несе власну помилку драйвера.",
+        "anchor": "ports-QueueMessageSourceUnavailableError-failure"
+      },
+      {
+        "name": "TransactionBoundaryUnavailableError",
+        "kind": "failure",
+        "signature": "Data.TaggedError<{ readonly operation: string; readonly cause: unknown }>",
+        "fallback": "",
+        "caption": "The transaction driver did not answer; `operation` names the call and `cause` carries the driver's own error.",
+        "captionUk": "Драйвер транзакції не відповів; `operation` називає виклик, а `cause` несе власну помилку драйвера.",
+        "anchor": "ports-TransactionBoundaryUnavailableError-failure"
+      }
+    ]
+  }
+}

package/dictionary/ports.toon

@@ -0,0 +1,52 @@
+package: @satorio/machinery
+version: 0.2.1
+mechanism:
+  mechanism: ports
+  import: @satorio/machinery/ports
+  kind: foundation
+  page: mechanisms/ports
+  what: "Public entry to the ports mechanism: every boundary a use case may ask for, and the failure each one raises."
+  whatUk: "Публічний вхід до механізму ports: кожна межа, яку може попросити процедура (use case), і відмова (refusal), яку піднімає кожна з них."
+  rows[42]{name,kind,signature,fallback,caption,captionUk,anchor}:
+    BlobStoreShape,value,interface,"",The blob store's operations.,Операції сховища об'єктів (blob store).,ports-BlobStoreShape-value
+    claimAccepted,value,ProcessedEventClaim,"","The claim nobody had taken yet, so this run is the one that does the work.","Резервація (claim-once), якої ще ніхто не взяв, тож саме цей прогін робить роботу.",ports-claimAccepted-value
+    ClaimProcessedEventInput,value,interface,"","What a claim needs: which event is being claimed, and the moment it is claimed at.","Що потрібно резервації: яку подію резервують і в яку мить це роблять.",ports-ClaimProcessedEventInput-value
+    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
+    DocumentNumberCountInput,value,interface,"","Which counter to move on: one client, one reporting month.","Який лічильник рухати далі: один клієнт, один звітний місяць (reporting month).",ports-DocumentNumberCountInput-value
+    EventPublisherShape,value,interface,"","What a publisher offers: one call that sends a batch of outbox messages out of this service.","Що пропонує публікатор: один виклик, який надсилає пачку повідомлень із буфера трансмітера (outbox) геть із цього сервісу.",ports-EventPublisherShape-value
+    ExternalHttpClientShape,value,interface,"","One external HTTP service, read through one operation.","Один зовнішній HTTP-сервіс, прочитаний однією операцією.",ports-ExternalHttpClientShape-value
+    IntegrationEventOutboxShape,value,interface,"",The outbox holds messages a use case enqueues in the same transaction as its state change.,"Буфер трансмітера тримає повідомлення, які процедура ставить у чергу тією самою транзакцією, що й свою зміну стану.",ports-IntegrationEventOutboxShape-value
+    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
+    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
+    ProcessedEventClaim,value,type,"","The two states of the claim-once lock: this run took the event, or somebody already had.","Два стани замка резервації: цей прогін узяв подію, або хтось уже взяв її раніше.",ports-ProcessedEventClaim-value
+    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
+    QueueMessageProducerShape,value,interface,"","What a producer offers: one call that puts a message body onto the queue.","Що пропонує відправник: один виклик, який кладе тіло повідомлення в чергу.",ports-QueueMessageProducerShape-value
+    QueueMessageSourceShape,value,interface,"","A source of queue messages: it receives a batch and acknowledges what was taken.","Джерело повідомлень черги: воно отримує пачку і підтверджує взяте.",ports-QueueMessageSourceShape-value
+    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
+    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
+    StoredBlob,value,interface,"","A stored blob's bytes, content type, and free-form text metadata.","Байти збереженого об'єкта, його тип вмісту і довільні текстові метадані.",ports-StoredBlob-value
+    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
+    alreadyProcessed,procedure,"(processedAt: DateTime.Utc) => ProcessedEventClaim","","The claim somebody else already took, with the moment they took it.","Резервація, яку хтось уже взяв, разом із миттю, коли він її взяв.",ports-alreadyProcessed-procedure
+    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
+    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
+    DocumentNumberCounter,port,Context.Tag('DocumentNumberCounter'),"",The port a use case asks for when it numbers a document a person will read.,"Порт, який просить процедура, коли нумерує документ, що його читатиме людина.",ports-DocumentNumberCounter-port
+    EventPublisher,port,Context.Tag('EventPublisher'),"",The port the outbox relay asks for when it announces what has already happened.,"Порт, який просить трансмітер вихідних подій (outbox relay), коли оголошує те, що вже сталось.",ports-EventPublisher-port
+    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
+    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
+    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
+    QueueMessageProducer,port,Context.Tag('QueueMessageProducer'),"",The port a use case asks for when it sends a message to a queue.,"Порт, який просить процедура, коли надсилає повідомлення в чергу.",ports-QueueMessageProducer-port
+    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
+    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
+    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
+    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
+    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
+    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
+    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
+    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
+    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
+    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
+    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
+    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
+    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
+    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
+    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