@satorio/machinery 0.2.1

package/dictionary/core.json

@@ -0,0 +1,221 @@
+{
+  "package": "@satorio/machinery",
+  "version": "0.2.1",
+  "mechanism": {
+    "mechanism": "core",
+    "import": "@satorio/machinery/core",
+    "kind": "foundation",
+    "page": "mechanisms/core",
+    "what": "Public entry to the core mechanism: the few pieces every other mechanism leans on, and which lean on nothing themselves.",
+    "whatUk": "Публічний вхід до механізму core: кілька частин, на які спирається кожен інший механізм і які самі не спираються ні на що.",
+    "rows": [
+      {
+        "name": "ClosedSet",
+        "kind": "value",
+        "signature": "interface",
+        "fallback": "",
+        "caption": "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.",
+        "captionUk": "Чітко визначений перелік (closed set) із одного джерела: значення, тип-об'єднання його членів і перевірка `is`.",
+        "anchor": "core-ClosedSet-value"
+      },
+      {
+        "name": "EnvironmentEntry",
+        "kind": "value",
+        "signature": "interface",
+        "fallback": "",
+        "caption": "One variable a mechanism reads, and the one state it stands in.",
+        "captionUk": "Одна змінна, яку читає механізм, і один стан, у якому вона стоїть.",
+        "anchor": "core-EnvironmentEntry-value"
+      },
+      {
+        "name": "EnvironmentState",
+        "kind": "value",
+        "signature": "type",
+        "fallback": "",
+        "caption": "Which of three states a variable stands in.",
+        "captionUk": "Котрий із трьох станів має змінна.",
+        "anchor": "core-EnvironmentState-value"
+      },
+      {
+        "name": "Refusal",
+        "kind": "value",
+        "signature": "interface",
+        "fallback": "",
+        "caption": "A refusal in the three parts a reader needs: what happened, why this mechanism cannot go on without it, and what to do next.",
+        "captionUk": "Відмова у трьох частинах, яких потребує читач: що сталось, чому механізм без цього не піде далі і що робити.",
+        "anchor": "core-Refusal-value"
+      },
+      {
+        "name": "Ulid",
+        "kind": "value",
+        "signature": "string & { readonly [ulidBrand]: 'Ulid' }",
+        "fallback": "",
+        "caption": "A ULID: the identifier a machine mints for a record, sortable by the moment it was minted, and a plain string everywhere it travels.",
+        "captionUk": "ULID: ідентифікатор, який машина карбує для запису, сортовний за миттю карбування і звичайний рядок усюди, куди мандрує.",
+        "anchor": "core-Ulid-value"
+      },
+      {
+        "name": "bigIntsAsDecimalStrings",
+        "kind": "procedure",
+        "signature": "(_key: string, value: unknown) => unknown",
+        "fallback": "",
+        "caption": "Use as the replacer argument to `JSON.stringify`.",
+        "captionUk": "Подавайте це аргументом-заміною до `JSON.stringify`.",
+        "anchor": "core-bigIntsAsDecimalStrings-procedure"
+      },
+      {
+        "name": "closedSet",
+        "kind": "procedure",
+        "signature": "<const T extends readonly string[]>(values: T) => ClosedSet<T>",
+        "fallback": "",
+        "caption": "Builds a closed set from an array of string literals, so the guard and the list it guards come from one source.",
+        "captionUk": "Будує чітко визначений перелік зі списку рядкових літералів, тож перевірка і список, який вона стереже, приходять з одного джерела.",
+        "anchor": "core-closedSet-procedure"
+      },
+      {
+        "name": "fallsBackTo",
+        "kind": "procedure",
+        "signature": "(value: string) => EnvironmentState",
+        "fallback": "",
+        "caption": "The variable is safe to omit, and this is what happens instead.",
+        "captionUk": "Змінну безпечно не ставити, і ось що стається натомість.",
+        "anchor": "core-fallsBackTo-procedure"
+      },
+      {
+        "name": "handedOn",
+        "kind": "procedure",
+        "signature": "(consequence: string) => EnvironmentState",
+        "fallback": "",
+        "caption": "The variable is legitimately optional with no default, because somebody else decides it, and this is what follows from leaving it unset.",
+        "captionUk": "Змінна законно необов'язкова і не має значення за замовчуванням, бо її вирішує хтось інший; ось що випливає, якщо її не поставити.",
+        "anchor": "core-handedOn-procedure"
+      },
+      {
+        "name": "isUlid",
+        "kind": "procedure",
+        "signature": "(value: string) => value is Ulid",
+        "fallback": "",
+        "caption": "Whether a string is a ULID, as a type guard, so a caller narrows the type without raising anything.",
+        "captionUk": "Чи є рядок ULID, як перевірка типу, тож викликач звужує тип і нічого не піднімає.",
+        "anchor": "core-isUlid-procedure"
+      },
+      {
+        "name": "optionalSecret",
+        "kind": "procedure",
+        "signature": "(name: string) => Config.Config<Option.Option<Redacted.Redacted>>",
+        "fallback": "",
+        "caption": "Reads a secret that is legitimately optional, and hands back `Option.none` when it is unset or blank.",
+        "captionUk": "Читає секрет, який законно необов'язковий, і подає `Option.none`, коли той не поставлений або порожній.",
+        "anchor": "core-optionalSecret-procedure"
+      },
+      {
+        "name": "optionalText",
+        "kind": "procedure",
+        "signature": "(name: string) => Config.Config<Option.Option<string>>",
+        "fallback": "",
+        "caption": "Reads a variable that is legitimately optional with no default, because somebody outside this process decides it.",
+        "captionUk": "Читає змінну, яка законно необов'язкова і не має значення за замовчуванням, бо її вирішує хтось поза цим процесом.",
+        "anchor": "core-optionalText-procedure"
+      },
+      {
+        "name": "refusalFor",
+        "kind": "procedure",
+        "signature": "(name: string, refusal: Refusal) => ConfigError.ConfigError",
+        "fallback": "",
+        "caption": "The one failure a refusing variable raises, with its three parts sewn into a single line.",
+        "captionUk": "Одна відмова, яку піднімає змінна, що відмовляє, з трьома її частинами, зшитими в один рядок.",
+        "anchor": "core-refusalFor-procedure"
+      },
+      {
+        "name": "refusalText",
+        "kind": "procedure",
+        "signature": "(refusal: Refusal) => string",
+        "fallback": "",
+        "caption": "Sews a refusal into the one line an operator reads in a log or a startup failure.",
+        "captionUk": "Зшиває відмову в один рядок, який оператор читає в лозі або у відмові на старті.",
+        "anchor": "core-refusalText-procedure"
+      },
+      {
+        "name": "refuses",
+        "kind": "procedure",
+        "signature": "(refusal: Refusal) => EnvironmentState",
+        "fallback": "",
+        "caption": "The mechanism cannot work without the variable, and this is the three-part text a reader meets when it is missing.",
+        "captionUk": "Механізм без цієї змінної не працює, і ось той текст із трьох частин, який читач зустріне, коли її немає.",
+        "anchor": "core-refuses-procedure"
+      },
+      {
+        "name": "requiredSecret",
+        "kind": "procedure",
+        "signature": "(name: string, refusal: Refusal) => Config.Config<Redacted.Redacted>",
+        "fallback": "",
+        "caption": "Reads a secret a mechanism cannot work without, and refuses in the same three parts when it is missing or blank.",
+        "captionUk": "Читає секрет, без якого механізм не працює, і відмовляє тими самими трьома частинами, коли той відсутній або порожній.",
+        "anchor": "core-requiredSecret-procedure"
+      },
+      {
+        "name": "requiredText",
+        "kind": "procedure",
+        "signature": "(name: string, refusal: Refusal) => Config.Config<string>",
+        "fallback": "",
+        "caption": "Reads a variable that a mechanism cannot work without, and refuses in three parts when it is missing or blank.",
+        "captionUk": "Читає змінну, без якої механізм не працює, і відмовляє трьома частинами, коли та відсутня або порожня.",
+        "anchor": "core-requiredText-procedure"
+      },
+      {
+        "name": "ulid",
+        "kind": "procedure",
+        "signature": "(raw: string) => Ulid",
+        "fallback": "",
+        "caption": "Reads a string as a ULID and throws `NotAUlidError` when it is not one, so a raw string comes through one door.",
+        "captionUk": "Читає рядок як ULID і кидає `NotAUlidError`, коли це не ULID, тож сирий рядок заходить одними дверима.",
+        "anchor": "core-ulid-procedure"
+      },
+      {
+        "name": "variableNameOf",
+        "kind": "procedure",
+        "signature": "(entry: EnvironmentEntry) => string",
+        "fallback": "",
+        "caption": "The name an operator sets, with `<PREFIX>` standing in front of a suffix the application chooses at mount time.",
+        "captionUk": "Назва, яку ставить оператор, де `<PREFIX>` стоїть перед суфіксом, що його застосунок обирає під час монтування.",
+        "anchor": "core-variableNameOf-procedure"
+      },
+      {
+        "name": "wholeNumberFallingBackTo",
+        "kind": "procedure",
+        "signature": "(name: string, lowest: number, highest: number, fallback: number, refusal: Refusal) => Config.Config<number>",
+        "fallback": "",
+        "caption": "Reads a whole number a mechanism is happy to do without, and falls back to the value it names when nobody set the variable.",
+        "captionUk": "Читає ціле число, без якого механізм радо обійдеться, і падає на назване значення, коли змінну ніхто не поставив.",
+        "anchor": "core-wholeNumberFallingBackTo-procedure"
+      },
+      {
+        "name": "wholeNumberWithin",
+        "kind": "procedure",
+        "signature": "(name: string, lowest: number, highest: number, refusal: Refusal) => Config.Config<number>",
+        "fallback": "",
+        "caption": "Reads a whole number inside a range, and refuses in three parts when it is not one.",
+        "captionUk": "Читає ціле число всередині діапазону і відмовляє трьома частинами, коли це не воно.",
+        "anchor": "core-wholeNumberWithin-procedure"
+      },
+      {
+        "name": "DomainError",
+        "kind": "failure",
+        "signature": "Error",
+        "fallback": "",
+        "caption": "Base class for domain errors.",
+        "captionUk": "Базовий клас доменних помилок.",
+        "anchor": "core-DomainError-failure"
+      },
+      {
+        "name": "NotAUlidError",
+        "kind": "failure",
+        "signature": "DomainError",
+        "fallback": "",
+        "caption": "What a caller meets when a string that is not a ULID reaches `ulid`; the message quotes the exact value received.",
+        "captionUk": "Що зустрічає викликач, коли до `ulid` дійшов рядок, який не є ULID; повідомлення цитує точне отримане значення.",
+        "anchor": "core-NotAUlidError-failure"
+      }
+    ]
+  }
+}

package/dictionary/core.toon

@@ -0,0 +1,33 @@
+package: @satorio/machinery
+version: 0.2.1
+mechanism:
+  mechanism: core
+  import: @satorio/machinery/core
+  kind: foundation
+  page: mechanisms/core
+  what: "Public entry to the core mechanism: the few pieces every other mechanism leans on, and which lean on nothing themselves."
+  whatUk: "Публічний вхід до механізму core: кілька частин, на які спирається кожен інший механізм і які самі не спираються ні на що."
+  rows[23]{name,kind,signature,fallback,caption,captionUk,anchor}:
+    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
+    EnvironmentEntry,value,interface,"","One variable a mechanism reads, and the one state it stands in.","Одна змінна, яку читає механізм, і один стан, у якому вона стоїть.",core-EnvironmentEntry-value
+    EnvironmentState,value,type,"",Which of three states a variable stands in.,Котрий із трьох станів має змінна.,core-EnvironmentState-value
+    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
+    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
+    bigIntsAsDecimalStrings,procedure,"(_key: string, value: unknown) => unknown","",Use as the replacer argument to `JSON.stringify`.,Подавайте це аргументом-заміною до `JSON.stringify`.,core-bigIntsAsDecimalStrings-procedure
+    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
+    fallsBackTo,procedure,"(value: string) => EnvironmentState","","The variable is safe to omit, and this is what happens instead.","Змінну безпечно не ставити, і ось що стається натомість.",core-fallsBackTo-procedure
+    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
+    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
+    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
+    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
+    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
+    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
+    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
+    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
+    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
+    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
+    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
+    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
+    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
+    DomainError,failure,Error,"",Base class for domain errors.,Базовий клас доменних помилок.,core-DomainError-failure
+    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

package/dictionary/graphql.json

@@ -0,0 +1,212 @@
+{
+  "package": "@satorio/machinery",
+  "version": "0.2.1",
+  "mechanism": {
+    "mechanism": "graphql",
+    "import": "@satorio/machinery/graphql",
+    "kind": "adapter",
+    "page": "mechanisms/graphql",
+    "what": "Public entry to the graphql mechanism: one server that answers your operations and the readiness probes beside them.",
+    "whatUk": "Публічний вхід до механізму graphql: один сервер, який відповідає на ваші операції і на проби готовності поруч із ними.",
+    "rows": [
+      {
+        "name": "ENVIRONMENT",
+        "kind": "value",
+        "signature": "readonly EnvironmentEntry[]",
+        "fallback": "",
+        "caption": "Every variable this adapter reads, and the one state each of them stands in.",
+        "captionUk": "Кожна змінна, яку читає цей адаптер (adapter), і один стан, у якому стоїть кожна з них.",
+        "anchor": "graphql-ENVIRONMENT-value"
+      },
+      {
+        "name": "EveryFailureIsClassified",
+        "kind": "value",
+        "signature": "type",
+        "fallback": "",
+        "caption": "The proof that every failure a service can raise is mapped at this boundary.",
+        "captionUk": "Доказ того, що кожну відмову, яку може підняти сервіс, замаплено на цій межі.",
+        "anchor": "graphql-EveryFailureIsClassified-value"
+      },
+      {
+        "name": "graphiqlEnabledFromEnvironment",
+        "kind": "value",
+        "signature": "Config.Config<boolean>",
+        "fallback": "",
+        "caption": "Whether to serve the editor page.",
+        "captionUk": "Чи віддавати сторінку редактора.",
+        "anchor": "graphql-graphiqlEnabledFromEnvironment-value"
+      },
+      {
+        "name": "GraphiqlPage",
+        "kind": "value",
+        "signature": "interface",
+        "fallback": "",
+        "caption": "A GraphiQL page: a title and a pre-filled document.",
+        "captionUk": "Сторінка GraphiQL: заголовок і наперед заповнений документ.",
+        "anchor": "graphql-GraphiqlPage-value"
+      },
+      {
+        "name": "GRAPHQL_ENDPOINT",
+        "kind": "value",
+        "signature": "const",
+        "fallback": "",
+        "caption": "The one path the GraphQL endpoint answers on.",
+        "captionUk": "Єдиний шлях, на якому відповідає точка GraphQL.",
+        "anchor": "graphql-GRAPHQL-ENDPOINT-value"
+      },
+      {
+        "name": "GraphQLContext",
+        "kind": "value",
+        "signature": "interface",
+        "fallback": "",
+        "caption": "What a resolver reads from its context: one call that runs a use case's program and answers with its value or a `GraphQLError`.",
+        "captionUk": "Що резолвер читає зі свого контексту: один виклик, який виконує програму процедури і відповідає її значенням або `GraphQLError`.",
+        "anchor": "graphql-GraphQLContext-value"
+      },
+      {
+        "name": "graphqlPortFromEnvironment",
+        "kind": "value",
+        "signature": "Config.Config<number>",
+        "fallback": "",
+        "caption": "The port to listen on.",
+        "captionUk": "Порт, на якому слухати.",
+        "anchor": "graphql-graphqlPortFromEnvironment-value"
+      },
+      {
+        "name": "RunOperationsExit",
+        "kind": "value",
+        "signature": "type",
+        "fallback": "",
+        "caption": "The minimal capability a resolver borrows from the runtime: run a program that needs `R` and return its `Exit`.",
+        "captionUk": "Найменша спроможність, яку резолвер позичає в рантайму: виконати програму, що потребує `R`, і повернути її `Exit`.",
+        "anchor": "graphql-RunOperationsExit-value"
+      },
+      {
+        "name": "asGraphQLError",
+        "kind": "procedure",
+        "signature": "(failure: OperationFailure | ParseResult.ParseError) => GraphQLError",
+        "fallback": "",
+        "caption": "Maps a GraphQL failure to a `GraphQLError`: the same three-class operation failure channel, plus input decoder failures — no second catalog.",
+        "captionUk": "Мапить відмову GraphQL на `GraphQLError`: той самий канал відмов операції з трьох класів плюс відмови декодера входу — жодного другого каталогу.",
+        "anchor": "graphql-asGraphQLError-procedure"
+      },
+      {
+        "name": "graphiqlExampleProblems",
+        "kind": "procedure",
+        "signature": "(schema: GraphQLSchema, page: GraphiqlPage) => readonly GraphiqlExampleProblem[]",
+        "fallback": "",
+        "caption": "Checks a GraphiQL page's default query against a schema.",
+        "captionUk": "Звіряє типовий запит сторінки GraphiQL зі схемою.",
+        "anchor": "graphql-graphiqlExampleProblems-procedure"
+      },
+      {
+        "name": "graphqlContextFrom",
+        "kind": "procedure",
+        "signature": "<R>(runExit: RunOperationsExit<R>) => GraphQLContext<R>",
+        "fallback": "",
+        "caption": "Builds that context around the runtime's own `runPromiseExit`, so a resolver never touches the runtime directly.",
+        "captionUk": "Будує той контекст навколо власного `runPromiseExit` рантайму, тож резолвер ніколи не торкається рантайму напряму.",
+        "anchor": "graphql-graphqlContextFrom-procedure"
+      },
+      {
+        "name": "makeSubGraphSchemaBuilder",
+        "kind": "procedure",
+        "signature": "<Context extends object>()",
+        "fallback": "",
+        "caption": "Returns a builder factory carrying the resolver context type.",
+        "captionUk": "Повертає фабрику будівників, яка несе тип контексту резолвера.",
+        "anchor": "graphql-makeSubGraphSchemaBuilder-procedure"
+      },
+      {
+        "name": "makeYogaServer",
+        "kind": "procedure",
+        "signature": "<R>(options: GraphQLServerOptions<R>) => YogaServerInstance<Record<string, never>, GraphQLContext<R>>",
+        "fallback": "",
+        "caption": "Builds a Yoga GraphQL server for Bun.",
+        "captionUk": "Будує GraphQL-сервер Yoga для Bun.",
+        "anchor": "graphql-makeYogaServer-procedure"
+      },
+      {
+        "name": "serverCannotListen",
+        "kind": "procedure",
+        "signature": "(port: number, cause: unknown) => ServerCannotListenError",
+        "fallback": "",
+        "caption": "Turns whatever the runtime threw while opening the socket into the named failure a caller reads.",
+        "captionUk": "Перетворює те, що кинув рантайм, відкриваючи сокет, на названу відмову, яку читає викликач.",
+        "anchor": "graphql-serverCannotListen-procedure"
+      },
+      {
+        "name": "graphqlServerLive",
+        "kind": "adapter",
+        "signature": "<R>(options: GraphQLRequestHandlerOptions<R>) => Layer.Layer<never, ConfigError.ConfigError | ServerCannotListenError, R>",
+        "fallback": "",
+        "caption": "The one layer this mechanism mounts: the server that answers your operations.",
+        "captionUk": "Єдиний шар, який монтує цей механізм: сервер, що відповідає на ваші операції.",
+        "anchor": "graphql-graphqlServerLive-adapter"
+      },
+      {
+        "name": "OperationFailure",
+        "kind": "failure",
+        "signature": "type",
+        "fallback": "",
+        "caption": "Everything a resolver may fail with, as one closed set: not found, rejected, or unavailable.",
+        "captionUk": "Усе, чим резолвер може відмовити, як один чітко визначений перелік: не знайдено, відхилено або недоступно.",
+        "anchor": "graphql-OperationFailure-failure"
+      },
+      {
+        "name": "OperationRejectedError",
+        "kind": "failure",
+        "signature": "Data.TaggedError<{ readonly rule: string; readonly reason: string; readonly detail: string }>",
+        "fallback": "",
+        "caption": "A resolver's rule rejected the operation, and `reason` names the cause it recognized.",
+        "captionUk": "Правило резолвера відхилило операцію, і `reason` називає причину, яку воно розпізнало.",
+        "anchor": "graphql-OperationRejectedError-failure"
+      },
+      {
+        "name": "OperationsUnavailableError",
+        "kind": "failure",
+        "signature": "Data.TaggedError<{ readonly operation: string; readonly cause: unknown }>",
+        "fallback": "",
+        "caption": "A resolver's own dependency did not answer; `cause` carries the port's own failure.",
+        "captionUk": "Власна залежність резолвера не відповіла; `cause` несе відмову самого порту.",
+        "anchor": "graphql-OperationsUnavailableError-failure"
+      },
+      {
+        "name": "ServerCannotListenError",
+        "kind": "failure",
+        "signature": "Data.TaggedError<{ readonly port: number; readonly refusal: Refusal; readonly cause: unknown }>",
+        "fallback": "",
+        "caption": "The socket never opened.",
+        "captionUk": "Сокет так і не відкрився.",
+        "anchor": "graphql-ServerCannotListenError-failure"
+      },
+      {
+        "name": "SubjectNotFoundError",
+        "kind": "failure",
+        "signature": "Data.TaggedError<{ readonly subject: string; readonly id: string }>",
+        "fallback": "",
+        "caption": "One of exactly three operation failure classes below — the closed set a resolver maps to.",
+        "captionUk": "Один із рівно трьох класів відмови операції нижче — чітко визначений перелік, на який мапить резолвер.",
+        "anchor": "graphql-SubjectNotFoundError-failure"
+      },
+      {
+        "name": "GRAPHQL_PORT",
+        "kind": "environment variable",
+        "signature": "falls back",
+        "fallback": "4000",
+        "caption": "The port the GraphQL endpoint and the readiness probes listen on.",
+        "captionUk": "Порт, на якому слухають точка GraphQL і проби готовності.",
+        "anchor": "graphql-GRAPHQL-PORT-environment-variable"
+      },
+      {
+        "name": "GRAPHIQL_ENABLED",
+        "kind": "environment variable",
+        "signature": "falls back",
+        "fallback": "true",
+        "caption": "Whether the GraphiQL editor page is served on the same endpoint.",
+        "captionUk": "Чи віддається сторінка редактора GraphiQL на тій самій точці.",
+        "anchor": "graphql-GRAPHIQL-ENABLED-environment-variable"
+      }
+    ]
+  }
+}

package/dictionary/graphql.toon

@@ -0,0 +1,32 @@
+package: @satorio/machinery
+version: 0.2.1
+mechanism:
+  mechanism: graphql
+  import: @satorio/machinery/graphql
+  kind: adapter
+  page: mechanisms/graphql
+  what: "Public entry to the graphql mechanism: one server that answers your operations and the readiness probes beside them."
+  whatUk: "Публічний вхід до механізму graphql: один сервер, який відповідає на ваші операції і на проби готовності поруч із ними."
+  rows[22]{name,kind,signature,fallback,caption,captionUk,anchor}:
+    ENVIRONMENT,value,"readonly EnvironmentEntry[]","","Every variable this adapter reads, and the one state each of them stands in.","Кожна змінна, яку читає цей адаптер (adapter), і один стан, у якому стоїть кожна з них.",graphql-ENVIRONMENT-value
+    EveryFailureIsClassified,value,type,"",The proof that every failure a service can raise is mapped at this boundary.,"Доказ того, що кожну відмову, яку може підняти сервіс, замаплено на цій межі.",graphql-EveryFailureIsClassified-value
+    graphiqlEnabledFromEnvironment,value,Config.Config<boolean>,"",Whether to serve the editor page.,Чи віддавати сторінку редактора.,graphql-graphiqlEnabledFromEnvironment-value
+    GraphiqlPage,value,interface,"","A GraphiQL page: a title and a pre-filled document.","Сторінка GraphiQL: заголовок і наперед заповнений документ.",graphql-GraphiqlPage-value
+    GRAPHQL_ENDPOINT,value,const,"",The one path the GraphQL endpoint answers on.,"Єдиний шлях, на якому відповідає точка GraphQL.",graphql-GRAPHQL-ENDPOINT-value
+    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
+    graphqlPortFromEnvironment,value,Config.Config<number>,"",The port to listen on.,"Порт, на якому слухати.",graphql-graphqlPortFromEnvironment-value
+    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
+    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
+    graphiqlExampleProblems,procedure,"(schema: GraphQLSchema, page: GraphiqlPage) => readonly GraphiqlExampleProblem[]","",Checks a GraphiQL page's default query against a schema.,Звіряє типовий запит сторінки GraphiQL зі схемою.,graphql-graphiqlExampleProblems-procedure
+    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
+    makeSubGraphSchemaBuilder,procedure,<Context extends object>(),"",Returns a builder factory carrying the resolver context type.,"Повертає фабрику будівників, яка несе тип контексту резолвера.",graphql-makeSubGraphSchemaBuilder-procedure
+    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
+    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
+    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
+    OperationFailure,failure,type,"","Everything a resolver may fail with, as one closed set: not found, rejected, or unavailable.","Усе, чим резолвер може відмовити, як один чітко визначений перелік: не знайдено, відхилено або недоступно.",graphql-OperationFailure-failure
+    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
+    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
+    ServerCannotListenError,failure,"Data.TaggedError<{ readonly port: number; readonly refusal: Refusal; readonly cause: unknown }>","",The socket never opened.,Сокет так і не відкрився.,graphql-ServerCannotListenError-failure
+    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
+    GRAPHQL_PORT,environment variable,falls back,"4000",The port the GraphQL endpoint and the readiness probes listen on.,"Порт, на якому слухають точка GraphQL і проби готовності.",graphql-GRAPHQL-PORT-environment-variable
+    GRAPHIQL_ENABLED,environment variable,falls back,"true",Whether the GraphiQL editor page is served on the same endpoint.,Чи віддається сторінка редактора GraphiQL на тій самій точці.,graphql-GRAPHIQL-ENABLED-environment-variable

package/dictionary/http.json

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