@satorio/machinery 0.2.1

package/dictionary/postgres.json

@@ -0,0 +1,473 @@
+{
+  "package": "@satorio/machinery",
+  "version": "0.2.1",
+  "mechanism": {
+    "mechanism": "postgres",
+    "import": "@satorio/machinery/postgres",
+    "kind": "adapter",
+    "page": "mechanisms/postgres",
+    "what": "Public entry to the postgres mechanism: every port this machinery defines, bound to a real database.",
+    "whatUk": "Публічний вхід до механізму postgres: кожен порт, який визначає ця машинерія (machinery), прив'язаний до справжньої бази.",
+    "rows": [
+      {
+        "name": "AdvisoryLock",
+        "kind": "value",
+        "signature": "interface",
+        "fallback": "",
+        "caption": "A lock somebody else may already hold: its name, the attempt to take it, and the release that follows.",
+        "captionUk": "Замок, який хтось інший може вже тримати: його назва, спроба взяти його і звільнення, що йде слідом.",
+        "anchor": "postgres-AdvisoryLock-value"
+      },
+      {
+        "name": "DEFAULT_APPLICATION_NAME",
+        "kind": "value",
+        "signature": "const",
+        "fallback": "",
+        "caption": "The name this service shows under in the database's own list of connections when nobody names it.",
+        "captionUk": "Назва, під якою цей сервіс видно у власному списку з'єднань бази, коли її ніхто не називає.",
+        "anchor": "postgres-DEFAULT-APPLICATION-NAME-value"
+      },
+      {
+        "name": "DEFAULT_AUTH_MODE",
+        "kind": "value",
+        "signature": "'iam' | 'password'",
+        "fallback": "",
+        "caption": "How a service proves who it is when nothing says otherwise.",
+        "captionUk": "Як сервіс доводить, хто він, коли ніщо не каже інакше.",
+        "anchor": "postgres-DEFAULT-AUTH-MODE-value"
+      },
+      {
+        "name": "DEFAULT_POSTGRES_PORT",
+        "kind": "value",
+        "signature": "const",
+        "fallback": "",
+        "caption": "The port a Postgres server listens on when nobody says otherwise.",
+        "captionUk": "Порт, на якому слухає сервер Postgres, коли ніхто не каже інакше.",
+        "anchor": "postgres-DEFAULT-POSTGRES-PORT-value"
+      },
+      {
+        "name": "DEFAULT_POSTGRES_SCHEMA",
+        "kind": "value",
+        "signature": "const",
+        "fallback": "",
+        "caption": "The schema every statement runs against when nobody names one.",
+        "captionUk": "Схема, проти якої біжить кожен запит, коли ніхто її не називає.",
+        "anchor": "postgres-DEFAULT-POSTGRES-SCHEMA-value"
+      },
+      {
+        "name": "DEFAULT_POSTGRES_SSL_MODE",
+        "kind": "value",
+        "signature": "PostgresSslMode",
+        "fallback": "",
+        "caption": "How a connection is encrypted when nobody says otherwise: the chain is verified, so the safe choice is the one you get by saying nothing.",
+        "captionUk": "Як шифрується з'єднання, коли ніхто не каже інакше: ланцюг перевіряють, тож безпечний вибір — той, який ви дістаєте, не сказавши нічого.",
+        "anchor": "postgres-DEFAULT-POSTGRES-SSL-MODE-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": "postgres-ENVIRONMENT-value"
+      },
+      {
+        "name": "MACHINERY_MIGRATIONS_DIRECTORY",
+        "kind": "value",
+        "signature": "const",
+        "fallback": "",
+        "caption": "Directory holding the machinery's shared migrations: the processed-event registry and the outbox.",
+        "captionUk": "Директорія зі спільними міграціями (migration) машинерії: реєстр відпрацьованих подій і буфер трансмітера.",
+        "anchor": "postgres-MACHINERY-MIGRATIONS-DIRECTORY-value"
+      },
+      {
+        "name": "MIGRATION_LOCK_NAME",
+        "kind": "value",
+        "signature": "const",
+        "fallback": "",
+        "caption": "The name every migration lock is built from, so one reader finds them all.",
+        "captionUk": "Назва, з якої будують кожен замок міграцій, тож один читач знаходить їх усі.",
+        "anchor": "postgres-MIGRATION-LOCK-NAME-value"
+      },
+      {
+        "name": "POSTGRES_SSL_MODES",
+        "kind": "value",
+        "signature": "const",
+        "fallback": "",
+        "caption": "Every way a connection can be encrypted and verified, from no encryption at all to a fully verified chain.",
+        "captionUk": "Кожен спосіб зашифрувати й перевірити з'єднання — від жодного шифрування до цілком перевіреного ланцюга.",
+        "anchor": "postgres-POSTGRES-SSL-MODES-value"
+      },
+      {
+        "name": "PostgresAuthentication",
+        "kind": "value",
+        "signature": "type",
+        "fallback": "",
+        "caption": "The two ways to prove to the database who you are: a short-lived IAM token or a password.",
+        "captionUk": "Два способи довести базі, хто ви: короткоживучий токен IAM або пароль.",
+        "anchor": "postgres-PostgresAuthentication-value"
+      },
+      {
+        "name": "PostgresConnectionSettings",
+        "kind": "value",
+        "signature": "interface",
+        "fallback": "",
+        "caption": "Everything one connection needs, read in one go: where the server is, who connects, and how the connection is proven and encrypted.",
+        "captionUk": "Усе, що потрібно одному з'єднанню, прочитане за раз: де сервер, хто під'єднується і як з'єднання доводять та шифрують.",
+        "anchor": "postgres-PostgresConnectionSettings-value"
+      },
+      {
+        "name": "postgresConnectionSettings",
+        "kind": "value",
+        "signature": "Config.Config<PostgresConnectionSettings>",
+        "fallback": "",
+        "caption": "Every variable of `ENVIRONMENT`, read in one go.",
+        "captionUk": "Кожна змінна з `ENVIRONMENT`, прочитана за раз.",
+        "anchor": "postgres-postgresConnectionSettings-value"
+      },
+      {
+        "name": "PostgresPorts",
+        "kind": "value",
+        "signature": "type",
+        "fallback": "",
+        "caption": "The ports this mechanism implements, named together as one type.",
+        "captionUk": "Порти, які реалізує цей механізм, названі разом одним типом.",
+        "anchor": "postgres-PostgresPorts-value"
+      },
+      {
+        "name": "PostgresSslMode",
+        "kind": "value",
+        "signature": "(typeof POSTGRES_SSL_MODES)[number]",
+        "fallback": "",
+        "caption": "One of the ways a connection can be encrypted and verified.",
+        "captionUk": "Один зі способів зашифрувати й перевірити з'єднання.",
+        "anchor": "postgres-PostgresSslMode-value"
+      },
+      {
+        "name": "READINESS_QUERY_DEADLINE_MILLIS",
+        "kind": "value",
+        "signature": "const",
+        "fallback": "",
+        "caption": "How long the probe waits for its query before it reports \"down\".",
+        "captionUk": "Скільки проба чекає на свій запит, перш ніж звітувати «лежить».",
+        "anchor": "postgres-READINESS-QUERY-DEADLINE-MILLIS-value"
+      },
+      {
+        "name": "READINESS_REASON_WHEN_THE_DATABASE_STAYS_SILENT",
+        "kind": "value",
+        "signature": "const",
+        "fallback": "",
+        "caption": "Reason reported when the readiness query answers with a failure.",
+        "captionUk": "Причина, про яку звітують, коли запит готовності відповідає відмовою.",
+        "anchor": "postgres-READINESS-REASON-WHEN-THE-DATABASE-STAYS-SILENT-value"
+      },
+      {
+        "name": "READINESS_REASON_WHEN_THE_QUERY_TIMES_OUT",
+        "kind": "value",
+        "signature": "const",
+        "fallback": "",
+        "caption": "Reason reported when the readiness query times out.",
+        "captionUk": "Причина, про яку звітують, коли запитові готовності виходить строк.",
+        "anchor": "postgres-READINESS-REASON-WHEN-THE-QUERY-TIMES-OUT-value"
+      },
+      {
+        "name": "applyMigrations",
+        "kind": "procedure",
+        "signature": "(directories: readonly string[] = [MACHINERY_MIGRATIONS_DIRECTORY])",
+        "fallback": "",
+        "caption": "Applies pending migrations from the given directories, the machinery's own directory first, then the caller's.",
+        "captionUk": "Застосовує міграції, що чекають, із поданих директорій: спершу власна директорія машинерії, тоді директорія викликача.",
+        "anchor": "postgres-applyMigrations-procedure"
+      },
+      {
+        "name": "configProviderPreferring",
+        "kind": "procedure",
+        "signature": "(primary: ConfigProvider.ConfigProvider, fallbackKey: string, fallbackValue: string) => ConfigProvider.ConfigProvider",
+        "fallback": "",
+        "caption": "Builds a config provider that reads from `primary`, falling back to one fixed value when `primary` has no such key.",
+        "captionUk": "Будує постачальника конфігурації, який читає з `primary` і падає на одне фіксоване значення, коли в `primary` такого ключа немає.",
+        "anchor": "postgres-configProviderPreferring-procedure"
+      },
+      {
+        "name": "firstRow",
+        "kind": "procedure",
+        "signature": "<A>(rows: readonly A[]) => Option.Option<A>",
+        "fallback": "",
+        "caption": "Returns the first row, or `Option.none()` for an empty result.",
+        "captionUk": "Повертає перший рядок або `Option.none()` для порожнього результату.",
+        "anchor": "postgres-firstRow-procedure"
+      },
+      {
+        "name": "holdingAdvisoryLock",
+        "kind": "procedure",
+        "signature": "<ELock, RLock, ScheduleOut, RSchedule>(lock: AdvisoryLock<ELock, RLock>, retryWhileBusy: Schedule.Schedule<ScheduleOut, unknown, RSchedule>)",
+        "fallback": "",
+        "caption": "Runs an effect while holding the lock, waiting on the given schedule while somebody else holds it, and letting go however the effect ends.",
+        "captionUk": "Виконує ефект, тримаючи замок, чекає за поданим розкладом, поки замок тримає хтось інший, і відпускає його, хай як ефект скінчиться.",
+        "anchor": "postgres-holdingAdvisoryLock-procedure"
+      },
+      {
+        "name": "isUniqueViolation",
+        "kind": "procedure",
+        "signature": "(error: SqlError) => boolean",
+        "fallback": "",
+        "caption": "Whether this driver failure is a duplicate key rather than anything else the database could refuse.",
+        "captionUk": "Чи ця відмова драйвера є дублем ключа, а не чимось іншим, чому база могла б відмовити.",
+        "anchor": "postgres-isUniqueViolation-procedure"
+      },
+      {
+        "name": "jsonbValue",
+        "kind": "procedure",
+        "signature": "(sql: SqlClient.SqlClient, value: unknown) => Fragment",
+        "fallback": "",
+        "caption": "Hands a value to a `jsonb` column as JSON, whatever its shape.",
+        "captionUk": "Подає значення в колонку `jsonb` як JSON, хай яка в нього форма.",
+        "anchor": "postgres-jsonbValue-procedure"
+      },
+      {
+        "name": "migrationLockNameFor",
+        "kind": "procedure",
+        "signature": "(schema: string) => string",
+        "fallback": "",
+        "caption": "The lock one schema's migrations take, so two services migrating two schemas never wait on each other.",
+        "captionUk": "Замок, який беруть міграції однієї схеми, тож два сервіси, що мігрують дві схеми, ніколи не чекають один одного.",
+        "anchor": "postgres-migrationLockNameFor-procedure"
+      },
+      {
+        "name": "onUniqueViolation",
+        "kind": "procedure",
+        "signature": "<Conflict, Unavailable>(operation: string, branches: { readonly unique: () => Conflict; readonly unavailable: ( operation: string, ) => (cause: unknown) => Unavailable })",
+        "fallback": "",
+        "caption": "Splits a write path at the database boundary: a unique violation becomes a domain conflict, any other SqlError becomes \"store unavailable\".",
+        "captionUk": "Ділить шлях запису на межі бази: порушення унікальності стає доменним конфліктом, будь-який інший `SqlError` стає «сховище недоступне».",
+        "anchor": "postgres-onUniqueViolation-procedure"
+      },
+      {
+        "name": "postgresAdvisoryLock",
+        "kind": "procedure",
+        "signature": "(name: string) => AdvisoryLock<SqlError.SqlError, SqlClient.SqlClient>",
+        "fallback": "",
+        "caption": "A named advisory lock on the connection's own database.",
+        "captionUk": "Названий консультативний замок на власній базі цього з'єднання.",
+        "anchor": "postgres-postgresAdvisoryLock-procedure"
+      },
+      {
+        "name": "readinessProbeAsking",
+        "kind": "procedure",
+        "signature": "(aQueryTheDatabaseMustAnswer: Effect.Effect<unknown, SqlError>)",
+        "fallback": "",
+        "caption": "Builds a probe around one query the database must answer, with a deadline over it so an unreachable database reports \"down\" instead of hanging.",
+        "captionUk": "Будує пробу навколо одного запиту, на який має відповісти база, зі строком над ним, тож недосяжна база звітує «лежить», а не зависає.",
+        "anchor": "postgres-readinessProbeAsking-procedure"
+      },
+      {
+        "name": "reportApplied",
+        "kind": "procedure",
+        "signature": "(applied: ReadonlyArray<readonly [number, string]>) => Effect.Effect<void>",
+        "fallback": "",
+        "caption": "Says in one line what the run applied, or that the database was already current.",
+        "captionUk": "Каже одним рядком, що прогін застосував, або що база вже поточна.",
+        "anchor": "postgres-reportApplied-procedure"
+      },
+      {
+        "name": "schemaDefaultingTo",
+        "kind": "procedure",
+        "signature": "(schema: string) => ConfigProvider.ConfigProvider",
+        "fallback": "",
+        "caption": "Default schema for one service when `PGSCHEMA` isn't set.",
+        "captionUk": "Схема за замовчуванням для одного сервісу, коли `PGSCHEMA` не поставлено.",
+        "anchor": "postgres-schemaDefaultingTo-procedure"
+      },
+      {
+        "name": "MigrationPgClientLive",
+        "kind": "adapter",
+        "signature": "Layer.Layer<PgClient.PgClient | SqlClient.SqlClient, ConfigError | PlatformError | SqlError, FileSystem.FileSystem>",
+        "fallback": "",
+        "caption": "The client the migration runner uses: one connection, under its own name.",
+        "captionUk": "Клієнт, яким користується виконавець міграцій: одне з'єднання під власною назвою.",
+        "anchor": "postgres-MigrationPgClientLive-adapter"
+      },
+      {
+        "name": "PgDocumentNumberCounterLive",
+        "kind": "adapter",
+        "signature": "Layer.Layer<DocumentNumberCounter, never, PgClient.PgClient>",
+        "fallback": "",
+        "caption": "The document number counter on a real `document_number_counter` table.",
+        "captionUk": "Лічильник номерів документів на справжній таблиці `document_number_counter`.",
+        "anchor": "postgres-PgDocumentNumberCounterLive-adapter"
+      },
+      {
+        "name": "PgIntegrationEventOutboxLive",
+        "kind": "adapter",
+        "signature": "Layer.Layer<IntegrationEventOutbox, never, PgClient.PgClient>",
+        "fallback": "",
+        "caption": "The outbox on a real `integration_event_outbox` table.",
+        "captionUk": "Буфер трансмітера на справжній таблиці `integration_event_outbox`.",
+        "anchor": "postgres-PgIntegrationEventOutboxLive-adapter"
+      },
+      {
+        "name": "PgProcessedEventRegistryLive",
+        "kind": "adapter",
+        "signature": "Layer.Layer<ProcessedEventRegistry, never, PgClient.PgClient>",
+        "fallback": "",
+        "caption": "The exactly-once claim on a real `processed_event` table.",
+        "captionUk": "Резервація рівно один раз на справжній таблиці `processed_event`.",
+        "anchor": "postgres-PgProcessedEventRegistryLive-adapter"
+      },
+      {
+        "name": "PgReadinessProbeLive",
+        "kind": "adapter",
+        "signature": "Layer.Layer<ReadinessProbe, never, SqlClient.SqlClient>",
+        "fallback": "",
+        "caption": "The readiness probe on one `SELECT 1` against the service's own pool.",
+        "captionUk": "Проба готовності на одному `SELECT 1` проти власного пулу сервісу.",
+        "anchor": "postgres-PgReadinessProbeLive-adapter"
+      },
+      {
+        "name": "PgTransactionBoundaryLive",
+        "kind": "adapter",
+        "signature": "Layer.Layer<TransactionBoundary, never, SqlClient.SqlClient>",
+        "fallback": "",
+        "caption": "The transaction boundary on a real Postgres transaction.",
+        "captionUk": "Межа транзакції на справжній транзакції Postgres.",
+        "anchor": "postgres-PgTransactionBoundaryLive-adapter"
+      },
+      {
+        "name": "PostgresClientLive",
+        "kind": "adapter",
+        "signature": "Layer.Layer<PgClient.PgClient | SqlClient.SqlClient, ConfigError | PlatformError | SqlError, FileSystem.FileSystem>",
+        "fallback": "",
+        "caption": "The `@effect/sql-pg` client every other layer here builds on, opened from the environment `settings.ts` names.",
+        "captionUk": "Клієнт `@effect/sql-pg`, на якому стоїть кожен інший шар тут, відкритий з оточення, яке називає `settings.ts`.",
+        "anchor": "postgres-PostgresClientLive-adapter"
+      },
+      {
+        "name": "PostgresPortsLive",
+        "kind": "adapter",
+        "signature": "Layer.Layer<PostgresPorts | PgClient.PgClient | SqlClient.SqlClient, ConfigError | PlatformError | SqlError, FileSystem.FileSystem>",
+        "fallback": "",
+        "caption": "Every port this mechanism implements, on one client, for a service that supplies its own `FileSystem`.",
+        "captionUk": "Кожен порт, який реалізує цей механізм, на одному клієнті, для сервісу, що подає власну `FileSystem`.",
+        "anchor": "postgres-PostgresPortsLive-adapter"
+      },
+      {
+        "name": "PostgresPortsOnBunLive",
+        "kind": "adapter",
+        "signature": "Layer.Layer<PostgresPorts | PgClient.PgClient | SqlClient.SqlClient, ConfigError | PlatformError | SqlError>",
+        "fallback": "",
+        "caption": "The same bundle on Bun's own file system, which is the whole Postgres side of the machinery in one layer.",
+        "captionUk": "Той самий набір на власній файловій системі Bun, і це вся частина машинерії з боку Postgres в одному шарі.",
+        "anchor": "postgres-PostgresPortsOnBunLive-adapter"
+      },
+      {
+        "name": "MigrationLockBusyError",
+        "kind": "failure",
+        "signature": "Data.TaggedError<{ readonly lockName: string }>",
+        "fallback": "",
+        "caption": "A second process already holds the migration lock and did not let go within the retry window.",
+        "captionUk": "Другий процес уже тримає замок міграцій і не відпустив його у вікні спроб.",
+        "anchor": "postgres-MigrationLockBusyError-failure"
+      },
+      {
+        "name": "PGHOST",
+        "kind": "environment variable",
+        "signature": "refuses",
+        "fallback": "",
+        "caption": "The host this service opens its connection pool against.",
+        "captionUk": "Хост, проти якого цей сервіс відкриває свій пул з'єднань.",
+        "anchor": "postgres-PGHOST-environment-variable"
+      },
+      {
+        "name": "PGPORT",
+        "kind": "environment variable",
+        "signature": "falls back",
+        "fallback": "5432",
+        "caption": "The TCP port the database listens on.",
+        "captionUk": "Порт TCP, на якому слухає база.",
+        "anchor": "postgres-PGPORT-environment-variable"
+      },
+      {
+        "name": "PGUSER",
+        "kind": "environment variable",
+        "signature": "refuses",
+        "fallback": "",
+        "caption": "The Postgres role this service connects as.",
+        "captionUk": "Роль Postgres, під якою під'єднується цей сервіс.",
+        "anchor": "postgres-PGUSER-environment-variable"
+      },
+      {
+        "name": "PGDATABASE",
+        "kind": "environment variable",
+        "signature": "refuses",
+        "fallback": "",
+        "caption": "The database this service reads and writes.",
+        "captionUk": "База, яку цей сервіс читає і пише.",
+        "anchor": "postgres-PGDATABASE-environment-variable"
+      },
+      {
+        "name": "PGSCHEMA",
+        "kind": "environment variable",
+        "signature": "falls back",
+        "fallback": "app",
+        "caption": "The schema every statement runs against, set as the connection's search_path.",
+        "captionUk": "Схема, проти якої біжить кожен запит, поставлена як `search_path` з'єднання.",
+        "anchor": "postgres-PGSCHEMA-environment-variable"
+      },
+      {
+        "name": "PGAPPNAME",
+        "kind": "environment variable",
+        "signature": "falls back",
+        "fallback": "machinery",
+        "caption": "The name this service shows under in pg_stat_activity.",
+        "captionUk": "Назва, під якою цей сервіс видно в `pg_stat_activity`.",
+        "anchor": "postgres-PGAPPNAME-environment-variable"
+      },
+      {
+        "name": "PGSSLMODE",
+        "kind": "environment variable",
+        "signature": "falls back",
+        "fallback": "verify-full",
+        "caption": "How the connection is encrypted and verified, one of disable, allow, prefer, require, verify-ca, verify-full.",
+        "captionUk": "Як з'єднання шифрують і перевіряють; один із `disable`, `allow`, `prefer`, `require`, `verify-ca`, `verify-full`.",
+        "anchor": "postgres-PGSSLMODE-environment-variable"
+      },
+      {
+        "name": "PGSSLROOTCERT",
+        "kind": "environment variable",
+        "signature": "handed on",
+        "fallback": "",
+        "caption": "The path to a certificate authority file the database chain is verified against.",
+        "captionUk": "Шлях до файлу центру сертифікації, проти якого перевіряють ланцюг бази.",
+        "anchor": "postgres-PGSSLROOTCERT-environment-variable"
+      },
+      {
+        "name": "AUTH_MODE",
+        "kind": "environment variable",
+        "signature": "falls back",
+        "fallback": "password",
+        "caption": "Which of the two ways this service proves who it is, iam or password.",
+        "captionUk": "Котрим із двох способів цей сервіс доводить, хто він: `iam` чи `password`.",
+        "anchor": "postgres-AUTH-MODE-environment-variable"
+      },
+      {
+        "name": "PGPASSWORD",
+        "kind": "environment variable",
+        "signature": "refuses",
+        "fallback": "",
+        "caption": "The database password, read under the default password mode.",
+        "captionUk": "Пароль бази, який читають у режимі `password` за замовчуванням.",
+        "anchor": "postgres-PGPASSWORD-environment-variable"
+      },
+      {
+        "name": "AWS_REGION",
+        "kind": "environment variable",
+        "signature": "handed on",
+        "fallback": "",
+        "caption": "The region the IAM token signer signs against, read under AUTH_MODE=iam.",
+        "captionUk": "Регіон, проти якого підписує підписувач токенів IAM; його читають при `AUTH_MODE=iam`.",
+        "anchor": "postgres-AWS-REGION-environment-variable"
+      }
+    ]
+  }
+}

package/dictionary/postgres.toon

@@ -0,0 +1,61 @@
+package: @satorio/machinery
+version: 0.2.1
+mechanism:
+  mechanism: postgres
+  import: @satorio/machinery/postgres
+  kind: adapter
+  page: mechanisms/postgres
+  what: "Public entry to the postgres mechanism: every port this machinery defines, bound to a real database."
+  whatUk: "Публічний вхід до механізму postgres: кожен порт, який визначає ця машинерія (machinery), прив'язаний до справжньої бази."
+  rows[51]{name,kind,signature,fallback,caption,captionUk,anchor}:
+    AdvisoryLock,value,interface,"","A lock somebody else may already hold: its name, the attempt to take it, and the release that follows.","Замок, який хтось інший може вже тримати: його назва, спроба взяти його і звільнення, що йде слідом.",postgres-AdvisoryLock-value
+    DEFAULT_APPLICATION_NAME,value,const,"",The name this service shows under in the database's own list of connections when nobody names it.,"Назва, під якою цей сервіс видно у власному списку з'єднань бази, коли її ніхто не називає.",postgres-DEFAULT-APPLICATION-NAME-value
+    DEFAULT_AUTH_MODE,value,'iam' | 'password',"",How a service proves who it is when nothing says otherwise.,"Як сервіс доводить, хто він, коли ніщо не каже інакше.",postgres-DEFAULT-AUTH-MODE-value
+    DEFAULT_POSTGRES_PORT,value,const,"",The port a Postgres server listens on when nobody says otherwise.,"Порт, на якому слухає сервер Postgres, коли ніхто не каже інакше.",postgres-DEFAULT-POSTGRES-PORT-value
+    DEFAULT_POSTGRES_SCHEMA,value,const,"",The schema every statement runs against when nobody names one.,"Схема, проти якої біжить кожен запит, коли ніхто її не називає.",postgres-DEFAULT-POSTGRES-SCHEMA-value
+    DEFAULT_POSTGRES_SSL_MODE,value,PostgresSslMode,"","How a connection is encrypted when nobody says otherwise: the chain is verified, so the safe choice is the one you get by saying nothing.","Як шифрується з'єднання, коли ніхто не каже інакше: ланцюг перевіряють, тож безпечний вибір — той, який ви дістаєте, не сказавши нічого.",postgres-DEFAULT-POSTGRES-SSL-MODE-value
+    ENVIRONMENT,value,"readonly EnvironmentEntry[]","","Every variable this adapter reads, and the one state each of them stands in.","Кожна змінна, яку читає цей адаптер, і один стан, у якому стоїть кожна з них.",postgres-ENVIRONMENT-value
+    MACHINERY_MIGRATIONS_DIRECTORY,value,const,"","Directory holding the machinery's shared migrations: the processed-event registry and the outbox.","Директорія зі спільними міграціями (migration) машинерії: реєстр відпрацьованих подій і буфер трансмітера.",postgres-MACHINERY-MIGRATIONS-DIRECTORY-value
+    MIGRATION_LOCK_NAME,value,const,"","The name every migration lock is built from, so one reader finds them all.","Назва, з якої будують кожен замок міграцій, тож один читач знаходить їх усі.",postgres-MIGRATION-LOCK-NAME-value
+    POSTGRES_SSL_MODES,value,const,"","Every way a connection can be encrypted and verified, from no encryption at all to a fully verified chain.",Кожен спосіб зашифрувати й перевірити з'єднання — від жодного шифрування до цілком перевіреного ланцюга.,postgres-POSTGRES-SSL-MODES-value
+    PostgresAuthentication,value,type,"","The two ways to prove to the database who you are: a short-lived IAM token or a password.","Два способи довести базі, хто ви: короткоживучий токен IAM або пароль.",postgres-PostgresAuthentication-value
+    PostgresConnectionSettings,value,interface,"","Everything one connection needs, read in one go: where the server is, who connects, and how the connection is proven and encrypted.","Усе, що потрібно одному з'єднанню, прочитане за раз: де сервер, хто під'єднується і як з'єднання доводять та шифрують.",postgres-PostgresConnectionSettings-value
+    postgresConnectionSettings,value,Config.Config<PostgresConnectionSettings>,"","Every variable of `ENVIRONMENT`, read in one go.","Кожна змінна з `ENVIRONMENT`, прочитана за раз.",postgres-postgresConnectionSettings-value
+    PostgresPorts,value,type,"","The ports this mechanism implements, named together as one type.","Порти, які реалізує цей механізм, названі разом одним типом.",postgres-PostgresPorts-value
+    PostgresSslMode,value,"(typeof POSTGRES_SSL_MODES)[number]","",One of the ways a connection can be encrypted and verified.,Один зі способів зашифрувати й перевірити з'єднання.,postgres-PostgresSslMode-value
+    READINESS_QUERY_DEADLINE_MILLIS,value,const,"","How long the probe waits for its query before it reports \"down\".","Скільки проба чекає на свій запит, перш ніж звітувати «лежить».",postgres-READINESS-QUERY-DEADLINE-MILLIS-value
+    READINESS_REASON_WHEN_THE_DATABASE_STAYS_SILENT,value,const,"",Reason reported when the readiness query answers with a failure.,"Причина, про яку звітують, коли запит готовності відповідає відмовою.",postgres-READINESS-REASON-WHEN-THE-DATABASE-STAYS-SILENT-value
+    READINESS_REASON_WHEN_THE_QUERY_TIMES_OUT,value,const,"",Reason reported when the readiness query times out.,"Причина, про яку звітують, коли запитові готовності виходить строк.",postgres-READINESS-REASON-WHEN-THE-QUERY-TIMES-OUT-value
+    applyMigrations,procedure,"(directories: readonly string[] = [MACHINERY_MIGRATIONS_DIRECTORY])","","Applies pending migrations from the given directories, the machinery's own directory first, then the caller's.","Застосовує міграції, що чекають, із поданих директорій: спершу власна директорія машинерії, тоді директорія викликача.",postgres-applyMigrations-procedure
+    configProviderPreferring,procedure,"(primary: ConfigProvider.ConfigProvider, fallbackKey: string, fallbackValue: string) => ConfigProvider.ConfigProvider","","Builds a config provider that reads from `primary`, falling back to one fixed value when `primary` has no such key.","Будує постачальника конфігурації, який читає з `primary` і падає на одне фіксоване значення, коли в `primary` такого ключа немає.",postgres-configProviderPreferring-procedure
+    firstRow,procedure,"<A>(rows: readonly A[]) => Option.Option<A>","","Returns the first row, or `Option.none()` for an empty result.",Повертає перший рядок або `Option.none()` для порожнього результату.,postgres-firstRow-procedure
+    holdingAdvisoryLock,procedure,"<ELock, RLock, ScheduleOut, RSchedule>(lock: AdvisoryLock<ELock, RLock>, retryWhileBusy: Schedule.Schedule<ScheduleOut, unknown, RSchedule>)","","Runs an effect while holding the lock, waiting on the given schedule while somebody else holds it, and letting go however the effect ends.","Виконує ефект, тримаючи замок, чекає за поданим розкладом, поки замок тримає хтось інший, і відпускає його, хай як ефект скінчиться.",postgres-holdingAdvisoryLock-procedure
+    isUniqueViolation,procedure,"(error: SqlError) => boolean","",Whether this driver failure is a duplicate key rather than anything else the database could refuse.,"Чи ця відмова драйвера є дублем ключа, а не чимось іншим, чому база могла б відмовити.",postgres-isUniqueViolation-procedure
+    jsonbValue,procedure,"(sql: SqlClient.SqlClient, value: unknown) => Fragment","","Hands a value to a `jsonb` column as JSON, whatever its shape.","Подає значення в колонку `jsonb` як JSON, хай яка в нього форма.",postgres-jsonbValue-procedure
+    migrationLockNameFor,procedure,"(schema: string) => string","","The lock one schema's migrations take, so two services migrating two schemas never wait on each other.","Замок, який беруть міграції однієї схеми, тож два сервіси, що мігрують дві схеми, ніколи не чекають один одного.",postgres-migrationLockNameFor-procedure
+    onUniqueViolation,procedure,"<Conflict, Unavailable>(operation: string, branches: { readonly unique: () => Conflict; readonly unavailable: ( operation: string, ) => (cause: unknown) => Unavailable })","","Splits a write path at the database boundary: a unique violation becomes a domain conflict, any other SqlError becomes \"store unavailable\".","Ділить шлях запису на межі бази: порушення унікальності стає доменним конфліктом, будь-який інший `SqlError` стає «сховище недоступне».",postgres-onUniqueViolation-procedure
+    postgresAdvisoryLock,procedure,"(name: string) => AdvisoryLock<SqlError.SqlError, SqlClient.SqlClient>","",A named advisory lock on the connection's own database.,Названий консультативний замок на власній базі цього з'єднання.,postgres-postgresAdvisoryLock-procedure
+    readinessProbeAsking,procedure,"(aQueryTheDatabaseMustAnswer: Effect.Effect<unknown, SqlError>)","","Builds a probe around one query the database must answer, with a deadline over it so an unreachable database reports \"down\" instead of hanging.","Будує пробу навколо одного запиту, на який має відповісти база, зі строком над ним, тож недосяжна база звітує «лежить», а не зависає.",postgres-readinessProbeAsking-procedure
+    reportApplied,procedure,"(applied: ReadonlyArray<readonly [number, string]>) => Effect.Effect<void>","","Says in one line what the run applied, or that the database was already current.","Каже одним рядком, що прогін застосував, або що база вже поточна.",postgres-reportApplied-procedure
+    schemaDefaultingTo,procedure,"(schema: string) => ConfigProvider.ConfigProvider","",Default schema for one service when `PGSCHEMA` isn't set.,"Схема за замовчуванням для одного сервісу, коли `PGSCHEMA` не поставлено.",postgres-schemaDefaultingTo-procedure
+    MigrationPgClientLive,adapter,"Layer.Layer<PgClient.PgClient | SqlClient.SqlClient, ConfigError | PlatformError | SqlError, FileSystem.FileSystem>","","The client the migration runner uses: one connection, under its own name.","Клієнт, яким користується виконавець міграцій: одне з'єднання під власною назвою.",postgres-MigrationPgClientLive-adapter
+    PgDocumentNumberCounterLive,adapter,"Layer.Layer<DocumentNumberCounter, never, PgClient.PgClient>","",The document number counter on a real `document_number_counter` table.,Лічильник номерів документів на справжній таблиці `document_number_counter`.,postgres-PgDocumentNumberCounterLive-adapter
+    PgIntegrationEventOutboxLive,adapter,"Layer.Layer<IntegrationEventOutbox, never, PgClient.PgClient>","",The outbox on a real `integration_event_outbox` table.,Буфер трансмітера на справжній таблиці `integration_event_outbox`.,postgres-PgIntegrationEventOutboxLive-adapter
+    PgProcessedEventRegistryLive,adapter,"Layer.Layer<ProcessedEventRegistry, never, PgClient.PgClient>","",The exactly-once claim on a real `processed_event` table.,Резервація рівно один раз на справжній таблиці `processed_event`.,postgres-PgProcessedEventRegistryLive-adapter
+    PgReadinessProbeLive,adapter,"Layer.Layer<ReadinessProbe, never, SqlClient.SqlClient>","",The readiness probe on one `SELECT 1` against the service's own pool.,Проба готовності на одному `SELECT 1` проти власного пулу сервісу.,postgres-PgReadinessProbeLive-adapter
+    PgTransactionBoundaryLive,adapter,"Layer.Layer<TransactionBoundary, never, SqlClient.SqlClient>","",The transaction boundary on a real Postgres transaction.,Межа транзакції на справжній транзакції Postgres.,postgres-PgTransactionBoundaryLive-adapter
+    PostgresClientLive,adapter,"Layer.Layer<PgClient.PgClient | SqlClient.SqlClient, ConfigError | PlatformError | SqlError, FileSystem.FileSystem>","","The `@effect/sql-pg` client every other layer here builds on, opened from the environment `settings.ts` names.","Клієнт `@effect/sql-pg`, на якому стоїть кожен інший шар тут, відкритий з оточення, яке називає `settings.ts`.",postgres-PostgresClientLive-adapter
+    PostgresPortsLive,adapter,"Layer.Layer<PostgresPorts | PgClient.PgClient | SqlClient.SqlClient, ConfigError | PlatformError | SqlError, FileSystem.FileSystem>","","Every port this mechanism implements, on one client, for a service that supplies its own `FileSystem`.","Кожен порт, який реалізує цей механізм, на одному клієнті, для сервісу, що подає власну `FileSystem`.",postgres-PostgresPortsLive-adapter
+    PostgresPortsOnBunLive,adapter,"Layer.Layer<PostgresPorts | PgClient.PgClient | SqlClient.SqlClient, ConfigError | PlatformError | SqlError>","","The same bundle on Bun's own file system, which is the whole Postgres side of the machinery in one layer.","Той самий набір на власній файловій системі Bun, і це вся частина машинерії з боку Postgres в одному шарі.",postgres-PostgresPortsOnBunLive-adapter
+    MigrationLockBusyError,failure,"Data.TaggedError<{ readonly lockName: string }>","",A second process already holds the migration lock and did not let go within the retry window.,Другий процес уже тримає замок міграцій і не відпустив його у вікні спроб.,postgres-MigrationLockBusyError-failure
+    PGHOST,environment variable,refuses,"",The host this service opens its connection pool against.,"Хост, проти якого цей сервіс відкриває свій пул з'єднань.",postgres-PGHOST-environment-variable
+    PGPORT,environment variable,falls back,"5432",The TCP port the database listens on.,"Порт TCP, на якому слухає база.",postgres-PGPORT-environment-variable
+    PGUSER,environment variable,refuses,"",The Postgres role this service connects as.,"Роль Postgres, під якою під'єднується цей сервіс.",postgres-PGUSER-environment-variable
+    PGDATABASE,environment variable,refuses,"",The database this service reads and writes.,"База, яку цей сервіс читає і пише.",postgres-PGDATABASE-environment-variable
+    PGSCHEMA,environment variable,falls back,app,"The schema every statement runs against, set as the connection's search_path.","Схема, проти якої біжить кожен запит, поставлена як `search_path` з'єднання.",postgres-PGSCHEMA-environment-variable
+    PGAPPNAME,environment variable,falls back,machinery,The name this service shows under in pg_stat_activity.,"Назва, під якою цей сервіс видно в `pg_stat_activity`.",postgres-PGAPPNAME-environment-variable
+    PGSSLMODE,environment variable,falls back,verify-full,"How the connection is encrypted and verified, one of disable, allow, prefer, require, verify-ca, verify-full.","Як з'єднання шифрують і перевіряють; один із `disable`, `allow`, `prefer`, `require`, `verify-ca`, `verify-full`.",postgres-PGSSLMODE-environment-variable
+    PGSSLROOTCERT,environment variable,handed on,"",The path to a certificate authority file the database chain is verified against.,"Шлях до файлу центру сертифікації, проти якого перевіряють ланцюг бази.",postgres-PGSSLROOTCERT-environment-variable
+    AUTH_MODE,environment variable,falls back,password,"Which of the two ways this service proves who it is, iam or password.","Котрим із двох способів цей сервіс доводить, хто він: `iam` чи `password`.",postgres-AUTH-MODE-environment-variable
+    PGPASSWORD,environment variable,refuses,"","The database password, read under the default password mode.","Пароль бази, який читають у режимі `password` за замовчуванням.",postgres-PGPASSWORD-environment-variable
+    AWS_REGION,environment variable,handed on,"","The region the IAM token signer signs against, read under AUTH_MODE=iam.","Регіон, проти якого підписує підписувач токенів IAM; його читають при `AUTH_MODE=iam`.",postgres-AWS-REGION-environment-variable