@satorio/machinery 0.2.1

package/dictionary/http.toon

@@ -0,0 +1,21 @@
+package: @satorio/machinery
+version: 0.2.1
+mechanism:
+  mechanism: http
+  import: @satorio/machinery/http
+  kind: foundation
+  page: mechanisms/http
+  what: "Public entry to the http mechanism: readiness probes mounted on the same port as GraphQL."
+  whatUk: "Публічний вхід до механізму http: проби готовності (ReadinessProbe), змонтовані на тому самому порту (port), що й GraphQL."
+  rows[11]{name,kind,signature,fallback,caption,captionUk,anchor}:
+    DEFAULT_HEALTH_CHECK_DEADLINE_MILLIS,value,const,"",How long one check gets before it counts as down.,"Скільки часу дістає одна перевірка, перш ніж рахуватись як недоступна.",http-DEFAULT-HEALTH-CHECK-DEADLINE-MILLIS-value
+    HealthCheckStatus,value,'ok' | 'down',"","How one dependency came back: it answered, or it is down.","Як відповіла одна залежність: вона відповіла, або вона лежить.",http-HealthCheckStatus-value
+    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
+    HEALTHZ_PATH,value,const,"","Same check as READYZ_PATH, under a second name.","Та сама перевірка, що й `READYZ_PATH`, під другою назвою.",http-HEALTHZ-PATH-value
+    LIVEZ_PATH,value,const,"","The path that answers whether this process is alive at all, without checking a single dependency.","Шлях, який відповідає, чи цей процес узагалі живий, не питаючи жодної залежності.",http-LIVEZ-PATH-value
+    NamedHealthCheck,value,interface,"","One dependency to check, under the name the answer reports it by.","Одна залежність до перевірки, під назвою, якою відповідь про неї звітує.",http-NamedHealthCheck-value
+    ReadinessOutcome,value,interface,"","What the readiness endpoint answers: whether the service is ready, and how each dependency came back.","Що відповідає точка готовності: чи сервіс готовий і як відповіла кожна залежність.",http-ReadinessOutcome-value
+    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
+    RunHealthCheck,value,type,"",Runs a readiness check and returns its Exit.,Виконує перевірку готовності і повертає її `Exit`.,http-RunHealthCheck-value
+    checkReadiness,procedure,"<R>(options: HealthRoutesOptions<R>) => Effect.Effect<ReadinessOutcome>","","Runs every check independently, in parallel, under its own deadline.","Виконує кожну перевірку незалежно, паралельно, під її власним строком.",http-checkReadiness-procedure
+    healthRoutesFetch,procedure,"<R>(options: HealthRoutesOptions<R>) => ((request: Request) => Promise<Response | null>)","",Handles the three readiness endpoints.,Обробляє три точки готовності.,http-healthRoutesFetch-procedure

package/dictionary/identifiers.json

@@ -0,0 +1,266 @@
+{
+  "package": "@satorio/machinery",
+  "version": "0.2.1",
+  "mechanism": {
+    "mechanism": "identifiers",
+    "import": "@satorio/machinery/identifiers",
+    "kind": "foundation",
+    "page": "mechanisms/identifiers",
+    "what": "Public entry to the identifiers mechanism: the id a machine mints, and the numbers a person reads off a document.",
+    "whatUk": "Публічний вхід до механізму identifiers: ідентифікатор, який карбує машина, і номери, які людина читає з документа.",
+    "rows": [
+      {
+        "name": "ClientCode",
+        "kind": "value",
+        "signature": "string & { readonly [clientCodeBrand]: 'ClientCode' }",
+        "fallback": "",
+        "caption": "The number a client quotes back to you: eight digits, the last of which checks the other seven.",
+        "captionUk": "Номер, який клієнт диктує вам назад: вісім цифр, остання з яких перевіряє сім інших.",
+        "anchor": "identifiers-ClientCode-value"
+      },
+      {
+        "name": "CreditorReference",
+        "kind": "value",
+        "signature": "type",
+        "fallback": "",
+        "caption": "The reference a payer copies into a bank transfer, with its own check digits.",
+        "captionUk": "Референс, який платник копіює в банківський переказ, із власними контрольними цифрами (check digit).",
+        "anchor": "identifiers-CreditorReference-value"
+      },
+      {
+        "name": "DocumentNumber",
+        "kind": "value",
+        "signature": "type",
+        "fallback": "",
+        "caption": "The number printed on a document, in the form a person reads it.",
+        "captionUk": "Номер, надрукований на документі, у формі, якою його читає людина.",
+        "anchor": "identifiers-DocumentNumber-value"
+      },
+      {
+        "name": "DocumentNumberParts",
+        "kind": "value",
+        "signature": "interface",
+        "fallback": "",
+        "caption": "What a document number is made of.",
+        "captionUk": "З чого складається номер документа.",
+        "anchor": "identifiers-DocumentNumberParts-value"
+      },
+      {
+        "name": "DocumentNumbers",
+        "kind": "value",
+        "signature": "interface",
+        "fallback": "",
+        "caption": "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.",
+        "captionUk": "Номери документів одного переліку серій (series): карбування, прив'язане до того переліку, читання, яке відмовляє будь-якій серії поза ним, і сам перелік.",
+        "anchor": "identifiers-DocumentNumbers-value"
+      },
+      {
+        "name": "newClientCode",
+        "kind": "value",
+        "signature": "Effect.Effect<ClientCode>",
+        "fallback": "",
+        "caption": "A fresh client code, drawn from the randomness the service already shares.",
+        "captionUk": "Свіжий код клієнта, взятий із випадковості, яку сервіс уже поділяє.",
+        "anchor": "identifiers-newClientCode-value"
+      },
+      {
+        "name": "newUlid",
+        "kind": "value",
+        "signature": "Effect.Effect<Ulid>",
+        "fallback": "",
+        "caption": "A fresh identifier, minted from the clock and the randomness the service already shares.",
+        "captionUk": "Свіжий ідентифікатор, викарбуваний із годинника й випадковості, які сервіс уже поділяє.",
+        "anchor": "identifiers-newUlid-value"
+      },
+      {
+        "name": "NextDocumentNumberInput",
+        "kind": "value",
+        "signature": "interface",
+        "fallback": "",
+        "caption": "Which document to number: its series, who it goes to, and the month it reports on.",
+        "captionUk": "Який документ нумерувати: його серія, кому він іде і за який місяць звітує.",
+        "anchor": "identifiers-NextDocumentNumberInput-value"
+      },
+      {
+        "name": "ulidsInOrder",
+        "kind": "value",
+        "signature": "Effect.Effect<Effect.Effect<Ulid>>",
+        "fallback": "",
+        "caption": "A maker of identifiers that keep their order even when two of them land inside one millisecond.",
+        "captionUk": "Породжувач ідентифікаторів, які тримають свій порядок навіть тоді, коли два з них падають в одну мілісекунду.",
+        "anchor": "identifiers-ulidsInOrder-value"
+      },
+      {
+        "name": "clientCodeFrom",
+        "kind": "procedure",
+        "signature": "(text: string) => Either.Either<ClientCode, NotAClientCodeError>",
+        "fallback": "",
+        "caption": "Reads a client code somebody typed, forgiving the spaces and hyphens a person puts between the groups.",
+        "captionUk": "Читає код клієнта, який хтось набрав, прощаючи пробіли й дефіси, що їх людина ставить між групами.",
+        "anchor": "identifiers-clientCodeFrom-procedure"
+      },
+      {
+        "name": "clientCodeInGroupedForm",
+        "kind": "procedure",
+        "signature": "(code: ClientCode) => string",
+        "fallback": "",
+        "caption": "The form a person reads off a document: two groups of four.",
+        "captionUk": "Форма, якою людина читає код із документа: дві групи по чотири.",
+        "anchor": "identifiers-clientCodeInGroupedForm-procedure"
+      },
+      {
+        "name": "clientCodeOfDocumentNumber",
+        "kind": "procedure",
+        "signature": "(number: DocumentNumber) => ClientCode",
+        "fallback": "",
+        "caption": "The client code printed inside a document number.",
+        "captionUk": "Код клієнта, надрукований усередині номера документа.",
+        "anchor": "identifiers-clientCodeOfDocumentNumber-procedure"
+      },
+      {
+        "name": "creditorReferenceFrom",
+        "kind": "procedure",
+        "signature": "(text: string) => Either.Either<CreditorReference, NotACreditorReferenceError>",
+        "fallback": "",
+        "caption": "Reads a reference somebody typed, forgiving case, spaces and the hyphens a person copies along with it.",
+        "captionUk": "Читає референс, який хтось набрав, прощаючи регістр, пробіли й дефіси, що їх людина копіює разом із ним.",
+        "anchor": "identifiers-creditorReferenceFrom-procedure"
+      },
+      {
+        "name": "creditorReferenceInGroupedForm",
+        "kind": "procedure",
+        "signature": "(reference: CreditorReference) => string",
+        "fallback": "",
+        "caption": "The form a person reads off a document and types into a bank: groups of four, the way ISO 11649 prints one.",
+        "captionUk": "Форма, якою людина читає референс із документа і набирає його в банку: групи по чотири, як їх друкує ISO 11649.",
+        "anchor": "identifiers-creditorReferenceInGroupedForm-procedure"
+      },
+      {
+        "name": "creditorReferenceOf",
+        "kind": "procedure",
+        "signature": "(number: DocumentNumber) => CreditorReference",
+        "fallback": "",
+        "caption": "The payment reference for a document that somebody has to pay.",
+        "captionUk": "Платіжний референс (creditor reference) для документа, який комусь треба сплатити.",
+        "anchor": "identifiers-creditorReferenceOf-procedure"
+      },
+      {
+        "name": "dammCheckDigit",
+        "kind": "procedure",
+        "signature": "(digits: string) => string | null",
+        "fallback": "",
+        "caption": "The check digit that makes a run of digits self-checking, by Damm's algorithm.",
+        "captionUk": "Контрольна цифра, яка робить пробіг цифр самоперевірним, за алгоритмом Дамма.",
+        "anchor": "identifiers-dammCheckDigit-procedure"
+      },
+      {
+        "name": "dammHolds",
+        "kind": "procedure",
+        "signature": "(digits: string) => boolean",
+        "fallback": "",
+        "caption": "Whether a run of digits already carries a check digit that holds.",
+        "captionUk": "Чи пробіг цифр уже несе контрольну цифру, яка тримає.",
+        "anchor": "identifiers-dammHolds-procedure"
+      },
+      {
+        "name": "digitsOfClientCode",
+        "kind": "procedure",
+        "signature": "(code: ClientCode) => string",
+        "fallback": "",
+        "caption": "The eight digits with nothing between them, which is the form a document number and a payment reference are built from.",
+        "captionUk": "Вісім цифр без нічого між ними — та форма, з якої будують номер документа і платіжний референс.",
+        "anchor": "identifiers-digitsOfClientCode-procedure"
+      },
+      {
+        "name": "digitsOfCreditorReference",
+        "kind": "procedure",
+        "signature": "(reference: CreditorReference) => string",
+        "fallback": "",
+        "caption": "The digits of the document number this reference points at.",
+        "captionUk": "Цифри номера документа, на який показує цей референс.",
+        "anchor": "identifiers-digitsOfCreditorReference-procedure"
+      },
+      {
+        "name": "digitsOfDocumentNumber",
+        "kind": "procedure",
+        "signature": "(number: DocumentNumber) => string",
+        "fallback": "",
+        "caption": "The digits of a document number with the series and the hyphens taken off, which is what a payment reference is built over.",
+        "captionUk": "Цифри номера документа зі знятою серією і дефісами — те, над чим будують платіжний референс.",
+        "anchor": "identifiers-digitsOfDocumentNumber-procedure"
+      },
+      {
+        "name": "makeDocumentNumbers",
+        "kind": "procedure",
+        "signature": "<const Series extends readonly string[]>(series: ClosedSet<Series>) => DocumentNumbers<Series>",
+        "fallback": "",
+        "caption": "Binds document numbers to the series one service issues.",
+        "captionUk": "Прив'язує номери документів до серій, які видає один сервіс: які види документів існують — це канон того сервісу, а не цього пакета.",
+        "anchor": "identifiers-makeDocumentNumbers-procedure"
+      },
+      {
+        "name": "reportingMonthOf",
+        "kind": "procedure",
+        "signature": "(day: CalendarDay) => string",
+        "fallback": "",
+        "caption": "The two digits of year and two of month a reporting period is written as: March 2026 reads `2603`.",
+        "captionUk": "Дві цифри року і дві місяця, якими пишуть звітний період: березень 2026 читається як `2603`.",
+        "anchor": "identifiers-reportingMonthOf-procedure"
+      },
+      {
+        "name": "ulidOfSeed",
+        "kind": "procedure",
+        "signature": "(moment: DateTime.Utc, seed: string) => Ulid",
+        "fallback": "",
+        "caption": "The identifier a moment and a seed always mint the same way.",
+        "captionUk": "Ідентифікатор, який мить і зерно завжди карбують однаково.",
+        "anchor": "identifiers-ulidOfSeed-procedure"
+      },
+      {
+        "name": "withDammCheckDigit",
+        "kind": "procedure",
+        "signature": "(digits: string) => string | null",
+        "fallback": "",
+        "caption": "The same digits with their check digit written on the end.",
+        "captionUk": "Ті самі цифри з контрольною цифрою, дописаною в кінці.",
+        "anchor": "identifiers-withDammCheckDigit-procedure"
+      },
+      {
+        "name": "IdentifierFailure",
+        "kind": "failure",
+        "signature": "type",
+        "fallback": "",
+        "caption": "Every way this mechanism refuses a value.",
+        "captionUk": "Кожен спосіб, яким цей механізм відмовляє значенню.",
+        "anchor": "identifiers-IdentifierFailure-failure"
+      },
+      {
+        "name": "NotAClientCodeError",
+        "kind": "failure",
+        "signature": "Data.TaggedError<{ readonly text: string }>",
+        "fallback": "",
+        "caption": "The text handed in is not a client code.",
+        "captionUk": "Поданий текст не є кодом клієнта.",
+        "anchor": "identifiers-NotAClientCodeError-failure"
+      },
+      {
+        "name": "NotACreditorReferenceError",
+        "kind": "failure",
+        "signature": "Data.TaggedError<{ readonly text: string }>",
+        "fallback": "",
+        "caption": "The text handed in is not a payment reference this mechanism issued.",
+        "captionUk": "Поданий текст не є платіжним референсом, який видав цей механізм.",
+        "anchor": "identifiers-NotACreditorReferenceError-failure"
+      },
+      {
+        "name": "NotADocumentNumberError",
+        "kind": "failure",
+        "signature": "Data.TaggedError<{ readonly text: string }>",
+        "fallback": "",
+        "caption": "The parts handed in cannot make a document number, or the text handed in does not read as one.",
+        "captionUk": "Подані частини не складають номера документа, або поданий текст не читається як номер.",
+        "anchor": "identifiers-NotADocumentNumberError-failure"
+      }
+    ]
+  }
+}

package/dictionary/identifiers.toon

@@ -0,0 +1,38 @@
+package: @satorio/machinery
+version: 0.2.1
+mechanism:
+  mechanism: identifiers
+  import: @satorio/machinery/identifiers
+  kind: foundation
+  page: mechanisms/identifiers
+  what: "Public entry to the identifiers mechanism: the id a machine mints, and the numbers a person reads off a document."
+  whatUk: "Публічний вхід до механізму identifiers: ідентифікатор, який карбує машина, і номери, які людина читає з документа."
+  rows[28]{name,kind,signature,fallback,caption,captionUk,anchor}:
+    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
+    CreditorReference,value,type,"","The reference a payer copies into a bank transfer, with its own check digits.","Референс, який платник копіює в банківський переказ, із власними контрольними цифрами (check digit).",identifiers-CreditorReference-value
+    DocumentNumber,value,type,"","The number printed on a document, in the form a person reads it.","Номер, надрукований на документі, у формі, якою його читає людина.",identifiers-DocumentNumber-value
+    DocumentNumberParts,value,interface,"",What a document number is made of.,З чого складається номер документа.,identifiers-DocumentNumberParts-value
+    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
+    newClientCode,value,Effect.Effect<ClientCode>,"","A fresh client code, drawn from the randomness the service already shares.","Свіжий код клієнта, взятий із випадковості, яку сервіс уже поділяє.",identifiers-newClientCode-value
+    newUlid,value,Effect.Effect<Ulid>,"","A fresh identifier, minted from the clock and the randomness the service already shares.","Свіжий ідентифікатор, викарбуваний із годинника й випадковості, які сервіс уже поділяє.",identifiers-newUlid-value
+    NextDocumentNumberInput,value,interface,"","Which document to number: its series, who it goes to, and the month it reports on.","Який документ нумерувати: його серія, кому він іде і за який місяць звітує.",identifiers-NextDocumentNumberInput-value
+    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
+    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
+    clientCodeInGroupedForm,procedure,"(code: ClientCode) => string","","The form a person reads off a document: two groups of four.","Форма, якою людина читає код із документа: дві групи по чотири.",identifiers-clientCodeInGroupedForm-procedure
+    clientCodeOfDocumentNumber,procedure,"(number: DocumentNumber) => ClientCode","",The client code printed inside a document number.,"Код клієнта, надрукований усередині номера документа.",identifiers-clientCodeOfDocumentNumber-procedure
+    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
+    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
+    creditorReferenceOf,procedure,"(number: DocumentNumber) => CreditorReference","",The payment reference for a document that somebody has to pay.,"Платіжний референс (creditor reference) для документа, який комусь треба сплатити.",identifiers-creditorReferenceOf-procedure
+    dammCheckDigit,procedure,"(digits: string) => string | null","","The check digit that makes a run of digits self-checking, by Damm's algorithm.","Контрольна цифра, яка робить пробіг цифр самоперевірним, за алгоритмом Дамма.",identifiers-dammCheckDigit-procedure
+    dammHolds,procedure,"(digits: string) => boolean","",Whether a run of digits already carries a check digit that holds.,"Чи пробіг цифр уже несе контрольну цифру, яка тримає.",identifiers-dammHolds-procedure
+    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
+    digitsOfCreditorReference,procedure,"(reference: CreditorReference) => string","",The digits of the document number this reference points at.,"Цифри номера документа, на який показує цей референс.",identifiers-digitsOfCreditorReference-procedure
+    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
+    makeDocumentNumbers,procedure,"<const Series extends readonly string[]>(series: ClosedSet<Series>) => DocumentNumbers<Series>","",Binds document numbers to the series one service issues.,"Прив'язує номери документів до серій, які видає один сервіс: які види документів існують — це канон того сервісу, а не цього пакета.",identifiers-makeDocumentNumbers-procedure
+    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
+    ulidOfSeed,procedure,"(moment: DateTime.Utc, seed: string) => Ulid","",The identifier a moment and a seed always mint the same way.,"Ідентифікатор, який мить і зерно завжди карбують однаково.",identifiers-ulidOfSeed-procedure
+    withDammCheckDigit,procedure,"(digits: string) => string | null","",The same digits with their check digit written on the end.,"Ті самі цифри з контрольною цифрою, дописаною в кінці.",identifiers-withDammCheckDigit-procedure
+    IdentifierFailure,failure,type,"",Every way this mechanism refuses a value.,"Кожен спосіб, яким цей механізм відмовляє значенню.",identifiers-IdentifierFailure-failure
+    NotAClientCodeError,failure,"Data.TaggedError<{ readonly text: string }>","",The text handed in is not a client code.,Поданий текст не є кодом клієнта.,identifiers-NotAClientCodeError-failure
+    NotACreditorReferenceError,failure,"Data.TaggedError<{ readonly text: string }>","",The text handed in is not a payment reference this mechanism issued.,"Поданий текст не є платіжним референсом, який видав цей механізм.",identifiers-NotACreditorReferenceError-failure
+    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

package/dictionary/index.json

@@ -0,0 +1,96 @@
+{
+  "package": "@satorio/machinery",
+  "version": "0.2.1",
+  "index": [
+    {
+      "mechanism": "core",
+      "what": "Public entry to the core mechanism: the few pieces every other mechanism leans on, and which lean on nothing themselves.",
+      "whatUk": "Публічний вхід до механізму core: кілька частин, на які спирається кожен інший механізм і які самі не спираються ні на що.",
+      "import": "@satorio/machinery/core"
+    },
+    {
+      "mechanism": "http",
+      "what": "Public entry to the http mechanism: readiness probes mounted on the same port as GraphQL.",
+      "whatUk": "Публічний вхід до механізму http: проби готовності (ReadinessProbe), змонтовані на тому самому порту (port), що й GraphQL.",
+      "import": "@satorio/machinery/http"
+    },
+    {
+      "mechanism": "money",
+      "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.",
+      "whatUk": "Публічний вхід до механізму money, над dinero.js, спільною залежністю, яку ставить ваш сервіс: точні суми однієї валюти, частки, курси й округлення.",
+      "import": "@satorio/machinery/money"
+    },
+    {
+      "mechanism": "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), яку піднімає кожна з них.",
+      "import": "@satorio/machinery/ports"
+    },
+    {
+      "mechanism": "time",
+      "what": "Public entry to the time mechanism: a day a person reads and writes, a period of days, and a moment on the clock.",
+      "whatUk": "Публічний вхід до механізму time: день, який людина читає і пише, період (period) днів і мить на годиннику.",
+      "import": "@satorio/machinery/time"
+    },
+    {
+      "mechanism": "identifiers",
+      "what": "Public entry to the identifiers mechanism: the id a machine mints, and the numbers a person reads off a document.",
+      "whatUk": "Публічний вхід до механізму identifiers: ідентифікатор, який карбує машина, і номери, які людина читає з документа.",
+      "import": "@satorio/machinery/identifiers"
+    },
+    {
+      "mechanism": "workflow",
+      "what": "Public entry to the workflow mechanism: the combinators a use case composes its own beat from.",
+      "whatUk": "Публічний вхід до механізму workflow: комбінатори, з яких процедура складає власний такт.",
+      "import": "@satorio/machinery/workflow"
+    },
+    {
+      "mechanism": "graphql",
+      "what": "Public entry to the graphql mechanism: one server that answers your operations and the readiness probes beside them.",
+      "whatUk": "Публічний вхід до механізму graphql: один сервер, який відповідає на ваші операції і на проби готовності поруч із ними.",
+      "import": "@satorio/machinery/graphql"
+    },
+    {
+      "mechanism": "integration",
+      "what": "Public entry to the integration mechanism: one HTTP client for reference data outside this service.",
+      "whatUk": "Публічний вхід до механізму integration: один HTTP-клієнт до довідкових даних поза цим сервісом.",
+      "import": "@satorio/machinery/integration"
+    },
+    {
+      "mechanism": "postgres",
+      "what": "Public entry to the postgres mechanism: every port this machinery defines, bound to a real database.",
+      "whatUk": "Публічний вхід до механізму postgres: кожен порт, який визначає ця машинерія (machinery), прив'язаний до справжньої бази.",
+      "import": "@satorio/machinery/postgres"
+    },
+    {
+      "mechanism": "publishing",
+      "what": "Public entry to the publishing mechanism: the event publisher, bound to a topic or to one line on stdout.",
+      "whatUk": "Публічний вхід до механізму publishing: публікатор (publisher) подій, прив'язаний до топіка або до одного рядка на stdout.",
+      "import": "@satorio/machinery/publishing"
+    },
+    {
+      "mechanism": "queue",
+      "what": "Public entry to the queue mechanism: the envelope a message travels in, and the consumer that decides its fate.",
+      "whatUk": "Публічний вхід до механізму queue: конверт, у якому мандрує повідомлення, і робітник (consumer), який вирішує його долю.",
+      "import": "@satorio/machinery/queue"
+    },
+    {
+      "mechanism": "storage",
+      "what": "Public entry to the storage mechanism: whole objects stored under a key and read back.",
+      "whatUk": "Публічний вхід до механізму storage: цілі об'єкти, збережені під ключем і прочитані назад.",
+      "import": "@satorio/machinery/storage"
+    },
+    {
+      "mechanism": "testing",
+      "what": "Public entry to the testing mechanism: a stand-in for every port, a clock a test drives, and the scenario player.",
+      "whatUk": "Публічний вхід до механізму testing: замінник кожного порту, годинник, яким керує тест (test), і програвач сценаріїв (playScenario).",
+      "import": "@satorio/machinery/testing"
+    },
+    {
+      "mechanism": "vitest",
+      "what": "Public entry to the vitest mechanism: live stands, port contracts, and the guards that read the test runtime.",
+      "whatUk": "Публічний вхід до механізму vitest: живі стенди, контракти портів і три перевірки збірки (guard), які тримають рантайм цих тестів.",
+      "import": "@satorio/machinery/vitest"
+    }
+  ]
+}

package/dictionary/index.toon

@@ -0,0 +1,18 @@
+package: @satorio/machinery
+version: 0.2.1
+index[15]{mechanism,what,whatUk,import}:
+  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
+  http,"Public entry to the http mechanism: readiness probes mounted on the same port as GraphQL.","Публічний вхід до механізму http: проби готовності (ReadinessProbe), змонтовані на тому самому порту (port), що й GraphQL.",@satorio/machinery/http
+  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
+  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
+  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
+  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
+  workflow,"Public entry to the workflow mechanism: the combinators a use case composes its own beat from.","Публічний вхід до механізму workflow: комбінатори, з яких процедура складає власний такт.",@satorio/machinery/workflow
+  graphql,"Public entry to the graphql mechanism: one server that answers your operations and the readiness probes beside them.","Публічний вхід до механізму graphql: один сервер, який відповідає на ваші операції і на проби готовності поруч із ними.",@satorio/machinery/graphql
+  integration,"Public entry to the integration mechanism: one HTTP client for reference data outside this service.","Публічний вхід до механізму integration: один HTTP-клієнт до довідкових даних поза цим сервісом.",@satorio/machinery/integration
+  postgres,"Public entry to the postgres mechanism: every port this machinery defines, bound to a real database.","Публічний вхід до механізму postgres: кожен порт, який визначає ця машинерія (machinery), прив'язаний до справжньої бази.",@satorio/machinery/postgres
+  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
+  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
+  storage,"Public entry to the storage mechanism: whole objects stored under a key and read back.","Публічний вхід до механізму storage: цілі об'єкти, збережені під ключем і прочитані назад.",@satorio/machinery/storage
+  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
+  vitest,"Public entry to the vitest mechanism: live stands, port contracts, and the guards that read the test runtime.","Публічний вхід до механізму vitest: живі стенди, контракти портів і три перевірки збірки (guard), які тримають рантайм цих тестів.",@satorio/machinery/vitest

package/dictionary/integration.json

@@ -0,0 +1,131 @@
+{
+  "package": "@satorio/machinery",
+  "version": "0.2.1",
+  "mechanism": {
+    "mechanism": "integration",
+    "import": "@satorio/machinery/integration",
+    "kind": "adapter",
+    "page": "mechanisms/integration",
+    "what": "Public entry to the integration mechanism: one HTTP client for reference data outside this service.",
+    "whatUk": "Публічний вхід до механізму integration: один HTTP-клієнт до довідкових даних поза цим сервісом.",
+    "rows": [
+      {
+        "name": "DEFAULT_TIMEOUT_MILLIS",
+        "kind": "value",
+        "signature": "const",
+        "fallback": "",
+        "caption": "How long one call may take when nobody names a number.",
+        "captionUk": "Скільки може тривати один виклик, коли ніхто не назвав числа.",
+        "anchor": "integration-DEFAULT-TIMEOUT-MILLIS-value"
+      },
+      {
+        "name": "defaultExternalRetrySchedule",
+        "kind": "value",
+        "signature": "Schedule.Schedule<unknown, unknown>",
+        "fallback": "",
+        "caption": "How a call waits and tries again: growing pauses, jittered, on a short budget.",
+        "captionUk": "Як виклик чекає і пробує знову: зростальні паузи, з джитером, на короткому бюджеті.",
+        "anchor": "integration-defaultExternalRetrySchedule-value"
+      },
+      {
+        "name": "ENVIRONMENT",
+        "kind": "value",
+        "signature": "readonly EnvironmentEntry[]",
+        "fallback": "",
+        "caption": "Every variable this adapter reads, and the one state each of them stands in.",
+        "captionUk": "Кожна змінна, яку читає цей адаптер, і один стан, у якому стоїть кожна з них.",
+        "anchor": "integration-ENVIRONMENT-value"
+      },
+      {
+        "name": "ExternalServiceSettings",
+        "kind": "value",
+        "signature": "interface",
+        "fallback": "",
+        "caption": "What a client needs before it can call: the address every request goes under, and how long one call may take.",
+        "captionUk": "Що потрібно клієнтові, перш ніж він подзвонить: адреса, під яку йде кожен запит, і скільки може тривати один виклик.",
+        "anchor": "integration-ExternalServiceSettings-value"
+      },
+      {
+        "name": "baseUrlVariable",
+        "kind": "procedure",
+        "signature": "(variablePrefix: string) => string",
+        "fallback": "",
+        "caption": "Builds the environment variable name from the prefix the application gives at mount time.",
+        "captionUk": "Будує назву змінної оточення з префікса, який застосунок дає під час монтування.",
+        "anchor": "integration-baseUrlVariable-procedure"
+      },
+      {
+        "name": "externalHttpClientUnavailableWithoutConfiguration",
+        "kind": "procedure",
+        "signature": "(service: string, refusal: Refusal) => ExternalHttpClientShape",
+        "fallback": "",
+        "caption": "The client that stands in when nobody set the address, and fails every call loudly.",
+        "captionUk": "Клієнт, який стоїть замість справжнього, коли адресу ніхто не поставив, і гучно валить кожен виклик.",
+        "anchor": "integration-externalHttpClientUnavailableWithoutConfiguration-procedure"
+      },
+      {
+        "name": "externalServiceSettings",
+        "kind": "procedure",
+        "signature": "(variablePrefix: string) => Config.Config<ExternalServiceSettings>",
+        "fallback": "",
+        "caption": "Reads every variable of `ENVIRONMENT` under one prefix.",
+        "captionUk": "Читає кожну змінну з `ENVIRONMENT` під одним префіксом.",
+        "anchor": "integration-externalServiceSettings-procedure"
+      },
+      {
+        "name": "makeExternalHttpClient",
+        "kind": "procedure",
+        "signature": "(service: string, settings: ExternalServiceSettings) => Effect.Effect<ExternalHttpClientShape, never, HttpClient.HttpClient>",
+        "fallback": "",
+        "caption": "A ready-to-use client, with its transport already captured.",
+        "captionUk": "Готовий до вжитку клієнт із уже захопленим транспортом.",
+        "anchor": "integration-makeExternalHttpClient-procedure"
+      },
+      {
+        "name": "timeoutVariable",
+        "kind": "procedure",
+        "signature": "(variablePrefix: string) => string",
+        "fallback": "",
+        "caption": "Builds the timeout variable's name from the same prefix, so each external service in one process keeps its own patience.",
+        "captionUk": "Будує назву змінної строку з того самого префікса, тож кожен зовнішній сервіс в одному процесі тримає власне терпіння.",
+        "anchor": "integration-timeoutVariable-procedure"
+      },
+      {
+        "name": "externalHttpClientFromEnvironmentLive",
+        "kind": "adapter",
+        "signature": "(service: string, variablePrefix: string, transport: Layer.Layer<HttpClient.HttpClient> = FetchHttpClient.layer) => Layer.Layer<ExternalHttpClient, ConfigError.ConfigError>",
+        "fallback": "",
+        "caption": "A client built from the environment variables under one prefix.",
+        "captionUk": "Клієнт, зібраний зі змінних оточення під одним префіксом.",
+        "anchor": "integration-externalHttpClientFromEnvironmentLive-adapter"
+      },
+      {
+        "name": "externalHttpClientLive",
+        "kind": "adapter",
+        "signature": "(service: string, variablePrefix: string) => Layer.Layer<ExternalHttpClient, ConfigError.ConfigError>",
+        "fallback": "",
+        "caption": "One external service on the real fetch transport, reading the variables its prefix names.",
+        "captionUk": "Один зовнішній сервіс на справжньому транспорті `fetch`, який читає змінні, названі його префіксом.",
+        "anchor": "integration-externalHttpClientLive-adapter"
+      },
+      {
+        "name": "<PREFIX>_BASE_URL",
+        "kind": "environment variable",
+        "signature": "refuses",
+        "fallback": "",
+        "caption": "The address every call to this external service goes under.",
+        "captionUk": "Адреса, під яку йде кожен виклик до цього зовнішнього сервісу.",
+        "anchor": "integration-PREFIX-BASE-URL-environment-variable"
+      },
+      {
+        "name": "<PREFIX>_TIMEOUT_MILLIS",
+        "kind": "environment variable",
+        "signature": "falls back",
+        "fallback": "3000",
+        "caption": "How many milliseconds one call may take before it counts as a network failure.",
+        "captionUk": "Скільки мілісекунд може тривати один виклик, перш ніж рахуватись мережевою невдачею.",
+        "anchor": "integration-PREFIX-TIMEOUT-MILLIS-environment-variable"
+      }
+    ]
+  }
+}