letopis 1.4.1 → 2.0.0

package/dist/messages/codes.js

@@ -0,0 +1,173 @@
+export const codes = {
+    'codes.no_session': {
+        code: 'no_session',
+        ru: 'нет действующей сессии',
+        hint: 'войти заново: истёкшую или отозванную сессию не вернуть',
+    },
+    'codes.target_not_found': {
+        code: 'target_not_found',
+        ru: 'цель не найдена — одинаково для несуществующей, чужой и невидимой',
+        hint: 'проверить id и права: чужой и невидимый объект неотличим от несуществующего',
+    },
+    'codes.invalid_data': {
+        code: 'invalid_data',
+        ru: 'данные не подходят к описанию класса; подробности — в `issues`',
+        hint: 'исправить данные по `issues` (путь, правило, сообщение); проверить до отправки — `compileValidator`',
+    },
+    'codes.undeclared_end': {
+        code: 'undeclared_end',
+        ru: 'у класса нет такого конца (ссылки)',
+        hint: 'объявить конец в модели класса (`ends`) или исправить имя роли',
+    },
+    'codes.tenant_denied': {
+        code: 'tenant_denied',
+        ru: 'чужой арендатор или нет членства в нём',
+        hint: 'работать в арендаторе, где у пользователя есть членство, — сменить его `auth.switch()`',
+    },
+    'codes.acl_denied': {
+        code: 'acl_denied',
+        ru: 'правила доступа запрещают это действие',
+        hint: 'добавить правило доступа (`Rule`) или выполнить действие от пользователя, которому оно разрешено; проверить заранее — `db.acl.checkData`, `db.acl.check`',
+    },
+    'codes.id_mismatch': {
+        code: 'id_mismatch',
+        ru: 'переданный id не совпадает с id, вычисленным из ключа',
+        hint: 'не передавать `id` у класса с ключом — база вычислит его из ключа; узнать заранее — `db.idOf(класс, ключ)`',
+    },
+    'codes.id_from_db': {
+        code: 'id_from_db',
+        ru: 'у класса без ключа id выдаёт база — свой id передавать нельзя',
+        hint: 'не передавать `id` — база выдаст его сама; нужен постоянный id — дать классу ключ',
+    },
+    'codes.immutable_key': {
+        code: 'immutable_key',
+        ru: 'ключевые поля, класс, id, арендатора и владельца правкой не изменить',
+        hint: 'ключ, класс, id, арендатор и владелец строки неизменны: объект с другим ключом или классом — новый объект (`create`)',
+    },
+    'codes.invalid_class': {
+        code: 'invalid_class',
+        ru: 'описание класса отклонено, класс не найден или абстрактный, либо удаляют класс, у которого есть строки, потомки или история',
+        hint: 'проверить имя (`db.registry.has`) и описание класса (`syncModels` без `apply` покажет план); удалить класс можно только без строк, потомков и истории',
+    },
+    'codes.tightening_conflict': {
+        code: 'tightening_conflict',
+        ru: 'ужесточению модели мешают строки, которые ей не подходят',
+        hint: 'исправить или удалить строки из списка ошибки и снова вызвать `syncModels`',
+    },
+    'codes.isolation_level': {
+        code: 'isolation_level',
+        ru: 'удаление работает только на уровне `read committed`',
+        hint: 'удалять в транзакции уровня `read committed` — он стоит по умолчанию',
+    },
+    'codes.recreated_in_statement': {
+        code: 'recreated_in_statement',
+        ru: 'объект удалён и создан заново одним оператором',
+        hint: 'удалить и создать объект разными операторами',
+    },
+    'codes.delete_restricted': {
+        code: 'delete_restricted',
+        ru: 'удалить нельзя: на объект ссылаются строки с действием при удалении `restrict`',
+        hint: 'сначала удалить или перевести ссылающиеся строки — или сменить у их конца действие при удалении (`onDelete`)',
+    },
+    'codes.not_deleted': {
+        code: 'not_deleted',
+        ru: '`restore` работает только для удалённых объектов',
+        hint: 'сначала `delete()`, потом `restore()`',
+    },
+    'codes.exists': {
+        code: 'exists',
+        ru: 'объект с таким id уже существует',
+        hint: 'при повторе операции с ключом это ответ «уже записано»; иначе — `update`, `upsert` или другой ключ',
+    },
+    'codes.duplicate': {
+        code: 'duplicate',
+        ru: 'загрузчик: id повторяется во входных данных',
+        hint: 'убрать повторы id из входных данных: первые 100 — в `detail.rows`',
+    },
+    'codes.deleted': {
+        code: 'deleted',
+        ru: 'загрузчик: объект с этим id уже жил раньше и был удалён',
+        hint: "загрузить с `existing: 'update'` — объект оживёт новой версией — или дать ему другой id",
+    },
+    'codes.conflict': {
+        code: 'conflict',
+        ru: '`update` с `{ rev }`: строку уже изменили после того, как вы её прочли',
+        hint: 'перечитать строку и повторить правку с новым `rev`; для чисел — `inc` вместо записи итога',
+    },
+    'codes.rev_ambiguous': {
+        code: 'rev_ambiguous',
+        ru: '`{ rev }` указан у шага, который выбрал больше одного объекта',
+        hint: 'сузить шаг до одной строки (id или ключ) или убрать `{ rev }`',
+    },
+    'codes.tx_required': {
+        code: 'tx_required',
+        ru: '`forUpdate()`, `lock()`, `commit()` и `rollback()` работают только внутри `db.begin()`',
+        hint: 'вызывать внутри транзакции: `const tr = await db.begin()` … `await tr.commit()`',
+    },
+    'codes.lock_unsupported': {
+        code: 'lock_unsupported',
+        ru: '`forUpdate()` нельзя сочетать с агрегатом, `asOf`, `versions`, `withDeleted`, `deep` или глаголом',
+        hint: 'брать `forUpdate()` в простом чтении строк, а итоги, срезы и правки делать отдельными шагами',
+    },
+    'codes.commit_unknown': {
+        code: 'commit_unknown',
+        ru: 'связь оборвалась во время `COMMIT` — неизвестно, записалась ли транзакция',
+        hint: 'повторить ту же операцию с тем же ключом: `exists` — она уже записана, успех — в первый раз не записалась; без ключа исход не выяснить, поэтому операциям с деньгами нужен ключ',
+    },
+    'codes.tx_rolled_back': {
+        code: 'tx_rolled_back',
+        ru: 'PostgreSQL откатил транзакцию на `COMMIT`: ошибку перехватили внутри `tr.transaction(fn)`',
+        hint: 'не глушить ошибки внутри `tr.transaction(fn)`: устранить причину и повторить весь блок',
+    },
+    'codes.no_key': {
+        code: 'no_key',
+        ru: 'у класса нет ключа, а `upsert` и `idOf` без ключа не работают',
+        hint: 'дать классу ключ (`key` в модели) или работать по id: `update` вместо `upsert`',
+    },
+    'codes.no_path': {
+        code: 'no_path',
+        ru: 'между классами соседних шагов цепочки нет перехода',
+        hint: 'переходить по объявленным концам: между классами шагов нужна ссылка, роль конца — имя шага',
+    },
+    'codes.invalid_query': {
+        code: 'invalid_query',
+        ru: 'цепочка или вызов API построены неверно',
+        hint: 'исправить цепочку или вызов: текст ошибки называет неверный шаг или аргумент',
+    },
+    'codes.admin_required': {
+        code: 'admin_required',
+        ru: 'нужно подключение администратора: его требует загрузчик',
+        hint: 'запускать загрузчик на администраторском подключении (`allowBypassRls: true`) в отдельном процессе',
+    },
+    'codes.not_empty': {
+        code: 'not_empty',
+        ru: 'первая заливка возможна только в пустую схему',
+        hint: 'первую заливку делать в новую схему (`up({ fresh: true })`), в заполненную — загрузка без `initial`',
+    },
+    'codes.class_not_loadable': {
+        code: 'class_not_loadable',
+        ru: 'загрузчик не принимает строки классов (`Class`) — классы записывает `syncModels`',
+        hint: 'классы записывать `syncModels`, а загрузчику передавать только строки данных',
+    },
+    'codes.bypass_rls': {
+        code: 'bypass_rls',
+        ru: 'роль подключения обходит RLS: `connect()` без `allowBypassRls` или сервер MCP поверх такого подключения',
+        hint: 'подключать приложение отдельной ролью из группы `letopis_app`; администраторскому подключению — `allowBypassRls: true`; сервер MCP — только поверх подключения приложения',
+    },
+    'codes.user_session_required': {
+        code: 'user_session_required',
+        ru: 'серверу MCP нужна сессия пользователя, а не ключ сервиса или пустое подключение',
+        hint: 'создавать сервер MCP на подключении пользователя (`svc.as(…)` или `connect({ token })`), а не на корне сервиса',
+    },
+    'codes.confirmation_required': {
+        code: 'confirmation_required',
+        ru: 'MCP: удаление не подтвердил человек',
+        hint: 'подтвердить удаление в клиенте MCP; клиенту, который не умеет спрашивать человека, удаление недоступно',
+    },
+    // SQLSTATE XX000 с ключом каталога в DETAIL: база не держит условие, которое обязана держать сама (строка-замок)
+    'codes.internal': {
+        code: 'internal',
+        ru: 'внутренняя ошибка letopis: база не держит условие, которое обязана держать сама (например, нет строки-замка)',
+        hint: 'это ошибка letopis: сообщите о ней с текстом, кодом и версией пакета',
+    },
+};

package/dist/messages/index.d.ts

@@ -0,0 +1,95 @@
+/**
+ * Каталог сообщений letopis (план 2.0, этап 3, п. 3): ключ → код ошибки, шаблон текста и, если нужно, своя подсказка
+ * «что делать». Здесь разделы сливаются в MESSAGES (префикс ключа — имя раздела, ключи не повторяются), а render()
+ * подставляет параметры; ошибки и тексты строит errors.ts — lerr, lmsg, lwarn.
+ *
+ * Как перевести место на ключ каталога — инструкция исполнителям (образцы: записи разделов api, query, access, sql-core, sql-write,
+ * sql-time и места, которые их бросают).
+ *
+ * 1. Раздел — по файлу, где брошена ошибка:
+ *      api — index, chain, typed, errors, internal;  write — write, tx, load;  query — sql, ops;
+ *      time — watch, admin, cache, signals;  access — auth, acl;  model — model, registry, sync, cli, validate,
+ *      jsonschema, uuid;  boot — up, pglite;  mcp — mcp, describe;
+ *      sql-core — sql/10, 15, 20, 30, 40;  sql-write — sql/60;  sql-access — sql/50, 80;
+ *      sql-time — sql/70, 90, 95, 99 и sql/migrate.
+ *    codes.ts — запись на каждый код: заголовок и подсказка. Новый код — ещё ErrorCode (types.ts), для кода базы —
+ *    LT_NAMES (errors.ts) и error_catalog(), и строка таблицы «Ошибки» README с якорем `<a id="код"></a>`.
+ * 2. Ключ — `<раздел>.<snake_case>`: что случилось, а не где (api.unknown_step, query.sort_field). Одно место — один
+ *    ключ; одинаковый текст в разных разделах — разные ключи (api.validation_failed и sql-write.invalid_data).
+ * 3. Запись — { code, ru, hint? }, поля в этом порядке:
+ *    code — код, с которым место бросало ошибку: код не меняется (коды сверяет check:semver);
+ *    ru — прежний текст буква в букву, без префикса «letopis: <код>: »; подстановка ${x} → параметр {имя};
+ *    hint — только если подсказка кода из codes.ts к месту не подходит (образцы: api.connect_schema, sql-time.last_owner).
+ *    Параметр печатается как `${x}` в шаблонной строке, поэтому прежний текст не меняется; лучше скаляры (строка,
+ *    число). Похожие имена — params.similar (массив из similar() в errors.ts): «— похожие: a, b» lerr допишет сам, в
+ *    шаблон их не пишут.
+ *    Текст с двумя формами (род, число) — две записи или параметр без грамматики, а не склейка слов в коде.
+ * 4. Вызов в TS:
+ *      throw lerr('api.unknown_step', { name, similar: similar(name, names) });
+ *      throw lerr('access.switch_not_root');
+ *      throw lerr('<раздел>.<ключ>', { cls }, { detail: { id }, cause: e });   // detail и cause — как раньше
+ *    Текст не для ошибки (сообщение нарушения, описание) — lmsg(ключ, параметры); предупреждение — lwarn(ключ,
+ *    параметры, { once }). Подкласс и помощник вида fail(текст) переходят на ключ так же (образец — ValidationError в
+ *    errors.ts). Старый конструктор new LetopisError(код, текст) из переведённого места уходит целиком.
+ * 5. Вызов в SQL — перегрузка lt_fail(p_key text, p_params jsonb default '{}', p_detail jsonb default null)
+ *    (lib/sql/15-errors.sql): код ошибки — из записи, текст база собирает из шаблона ru (его видит и сырой SQL), в
+ *    DETAIL — поля p_detail и ещё key, params; их fromDbError переносит в поля ошибки (key, params):
+ *      perform @SCHEMA@.lt_fail('sql-core.no_membership');
+ *      perform @SCHEMA@.lt_fail('sql-write.invalid_data', jsonb_build_object('cls', NEW.class), jsonb_build_object('issues', bad));
+ *    Параметры — jsonb_build_object со скалярами (список — array_to_string); без параметров — один аргумент, а не null
+ *    (литерал без типа выбрал бы прежнюю lt_fail(имя, текст)). detail ошибки — прежний: без p_detail — {}, а место, где
+ *    был raise без detail, — p_detail => 'null' (detail нет). Свой SQLSTATE не из каталога — lt_raise(p_code, p_key,
+ *    p_params, p_detail). В функциях, которые исполняет приложение (inc, links_patch: lt_fail ему не выдан), — raise
+ *    как прежде (errcode — SQLSTATE кода, message — префикс «letopis: <код>: » и текст), только текст — lt_text(ключ,
+ *    параметры) (она выдана приложению), а detail — jsonb_build_object('key', ключ, 'params', параметры)::text; без
+ *    своих полей — ещё 'nodetail', true (detail нет, как у raise без detail).
+ *    Разделы sql-* установщик кладёт в базу при каждом up() (@MESSAGES@): новой ревизии и миграции не нужно.
+ * 6. Готовый файл — убрать из PENDING_LITERALS в lib/scripts/check-docs.mjs (проверка «в LetopisError, fail и lt_fail не
+ *    осталось литеральных текстов»). Затем cd lib && npm run typecheck, npm run check:docs, npm run api:contract и тесты
+ *    модуля по одному файлу: тест, который сверял русский текст, остаётся зелёным без правки.
+ * 7. Особые места. Разделы каталога контракт API читает регэкспами: код — из поля code: в кавычках, текст ошибки — из
+ *    строки с префиксом letopis и двоеточием; в комментариях их в таком виде не пишут. up.ts и pglite.ts бросают обычный Error('letopis.up: ' + lmsg(…)) — подходящего кода нет. Сообщения нарушений
+ *    (issues[].message: validate.ts, 30-validate.sql) — lmsg и lt_text с кодом invalid_data. Описания инструментов MCP и
+ *    instructions — строки в mcp.ts рядом со схемами, тексты ответов — раздел mcp.
+ */
+import { access } from './access.js';
+import { api } from './api.js';
+import { boot } from './boot.js';
+import { codes } from './codes.js';
+import { mcp } from './mcp.js';
+import { model } from './model.js';
+import { query } from './query.js';
+import { sqlAccess } from './sql-access.js';
+import { sqlCore } from './sql-core.js';
+import { sqlTime } from './sql-time.js';
+import { sqlWrite } from './sql-write.js';
+import { time } from './time.js';
+import { write } from './write.js';
+import type { ErrorCode, Msg, Params } from './types.js';
+export type { ErrorCode, Msg, Params, Section } from './types.js';
+/** Разделы, которые установщик кладёт в базу (message_catalog() в lib/sql/15-errors.sql). */
+export declare const SQL_SECTIONS: readonly ["sql-core", "sql-write", "sql-access", "sql-time"];
+type All = typeof codes & typeof api & typeof write & typeof query & typeof time & typeof access & typeof model & typeof boot & typeof mcp & typeof sqlCore & typeof sqlWrite & typeof sqlAccess & typeof sqlTime;
+/** Ключ каталога: опечатку в lerr('…') ловит проверка типов. */
+export type MsgKey = keyof All;
+/** Все записи каталога по ключу. */
+export declare const MESSAGES: Readonly<Record<MsgKey, Msg>>;
+/** Запись по ключу из любого источника (DETAIL базы, вызов из JS); нет такой — undefined. */
+export declare function msgOf(key: string): Msg | undefined;
+/** Подпись кода: заголовок и подсказка «что делать» (codes.ts). */
+export declare function codeOf(code: string): (Msg & {
+    hint: string;
+}) | undefined;
+/** Суффикс похожих имён (params.similar) — его дописывает lerr. */
+export declare const SIMILAR = " \u2014 \u043F\u043E\u0445\u043E\u0436\u0438\u0435: {similar}";
+/**
+ * Шаблон с параметрами: `{имя}` → значение, напечатанное как в шаблонной строке JS (`${x}`), поэтому перенос текста
+ * `…${x}…` в шаблон `…{x}…` его не меняет. `{имя}` без такого параметра остаётся как есть; так же — lt_text() в базе
+ * (там null — пусто, как у format('%s')).
+ */
+export declare function render(template: string, params?: Params): string;
+/** Разделы sql-* для базы: ключ → имя ошибки и русский шаблон (установщик подставляет в @MESSAGES@). */
+export declare function sqlCatalog(): Record<string, {
+    name: ErrorCode;
+    ru: string;
+}>;

package/dist/messages/index.js

@@ -0,0 +1,118 @@
+/**
+ * Каталог сообщений letopis (план 2.0, этап 3, п. 3): ключ → код ошибки, шаблон текста и, если нужно, своя подсказка
+ * «что делать». Здесь разделы сливаются в MESSAGES (префикс ключа — имя раздела, ключи не повторяются), а render()
+ * подставляет параметры; ошибки и тексты строит errors.ts — lerr, lmsg, lwarn.
+ *
+ * Как перевести место на ключ каталога — инструкция исполнителям (образцы: записи разделов api, query, access, sql-core, sql-write,
+ * sql-time и места, которые их бросают).
+ *
+ * 1. Раздел — по файлу, где брошена ошибка:
+ *      api — index, chain, typed, errors, internal;  write — write, tx, load;  query — sql, ops;
+ *      time — watch, admin, cache, signals;  access — auth, acl;  model — model, registry, sync, cli, validate,
+ *      jsonschema, uuid;  boot — up, pglite;  mcp — mcp, describe;
+ *      sql-core — sql/10, 15, 20, 30, 40;  sql-write — sql/60;  sql-access — sql/50, 80;
+ *      sql-time — sql/70, 90, 95, 99 и sql/migrate.
+ *    codes.ts — запись на каждый код: заголовок и подсказка. Новый код — ещё ErrorCode (types.ts), для кода базы —
+ *    LT_NAMES (errors.ts) и error_catalog(), и строка таблицы «Ошибки» README с якорем `<a id="код"></a>`.
+ * 2. Ключ — `<раздел>.<snake_case>`: что случилось, а не где (api.unknown_step, query.sort_field). Одно место — один
+ *    ключ; одинаковый текст в разных разделах — разные ключи (api.validation_failed и sql-write.invalid_data).
+ * 3. Запись — { code, ru, hint? }, поля в этом порядке:
+ *    code — код, с которым место бросало ошибку: код не меняется (коды сверяет check:semver);
+ *    ru — прежний текст буква в букву, без префикса «letopis: <код>: »; подстановка ${x} → параметр {имя};
+ *    hint — только если подсказка кода из codes.ts к месту не подходит (образцы: api.connect_schema, sql-time.last_owner).
+ *    Параметр печатается как `${x}` в шаблонной строке, поэтому прежний текст не меняется; лучше скаляры (строка,
+ *    число). Похожие имена — params.similar (массив из similar() в errors.ts): «— похожие: a, b» lerr допишет сам, в
+ *    шаблон их не пишут.
+ *    Текст с двумя формами (род, число) — две записи или параметр без грамматики, а не склейка слов в коде.
+ * 4. Вызов в TS:
+ *      throw lerr('api.unknown_step', { name, similar: similar(name, names) });
+ *      throw lerr('access.switch_not_root');
+ *      throw lerr('<раздел>.<ключ>', { cls }, { detail: { id }, cause: e });   // detail и cause — как раньше
+ *    Текст не для ошибки (сообщение нарушения, описание) — lmsg(ключ, параметры); предупреждение — lwarn(ключ,
+ *    параметры, { once }). Подкласс и помощник вида fail(текст) переходят на ключ так же (образец — ValidationError в
+ *    errors.ts). Старый конструктор new LetopisError(код, текст) из переведённого места уходит целиком.
+ * 5. Вызов в SQL — перегрузка lt_fail(p_key text, p_params jsonb default '{}', p_detail jsonb default null)
+ *    (lib/sql/15-errors.sql): код ошибки — из записи, текст база собирает из шаблона ru (его видит и сырой SQL), в
+ *    DETAIL — поля p_detail и ещё key, params; их fromDbError переносит в поля ошибки (key, params):
+ *      perform @SCHEMA@.lt_fail('sql-core.no_membership');
+ *      perform @SCHEMA@.lt_fail('sql-write.invalid_data', jsonb_build_object('cls', NEW.class), jsonb_build_object('issues', bad));
+ *    Параметры — jsonb_build_object со скалярами (список — array_to_string); без параметров — один аргумент, а не null
+ *    (литерал без типа выбрал бы прежнюю lt_fail(имя, текст)). detail ошибки — прежний: без p_detail — {}, а место, где
+ *    был raise без detail, — p_detail => 'null' (detail нет). Свой SQLSTATE не из каталога — lt_raise(p_code, p_key,
+ *    p_params, p_detail). В функциях, которые исполняет приложение (inc, links_patch: lt_fail ему не выдан), — raise
+ *    как прежде (errcode — SQLSTATE кода, message — префикс «letopis: <код>: » и текст), только текст — lt_text(ключ,
+ *    параметры) (она выдана приложению), а detail — jsonb_build_object('key', ключ, 'params', параметры)::text; без
+ *    своих полей — ещё 'nodetail', true (detail нет, как у raise без detail).
+ *    Разделы sql-* установщик кладёт в базу при каждом up() (@MESSAGES@): новой ревизии и миграции не нужно.
+ * 6. Готовый файл — убрать из PENDING_LITERALS в lib/scripts/check-docs.mjs (проверка «в LetopisError, fail и lt_fail не
+ *    осталось литеральных текстов»). Затем cd lib && npm run typecheck, npm run check:docs, npm run api:contract и тесты
+ *    модуля по одному файлу: тест, который сверял русский текст, остаётся зелёным без правки.
+ * 7. Особые места. Разделы каталога контракт API читает регэкспами: код — из поля code: в кавычках, текст ошибки — из
+ *    строки с префиксом letopis и двоеточием; в комментариях их в таком виде не пишут. up.ts и pglite.ts бросают обычный Error('letopis.up: ' + lmsg(…)) — подходящего кода нет. Сообщения нарушений
+ *    (issues[].message: validate.ts, 30-validate.sql) — lmsg и lt_text с кодом invalid_data. Описания инструментов MCP и
+ *    instructions — строки в mcp.ts рядом со схемами, тексты ответов — раздел mcp.
+ */
+import { access } from './access.js';
+import { api } from './api.js';
+import { boot } from './boot.js';
+import { codes } from './codes.js';
+import { mcp } from './mcp.js';
+import { model } from './model.js';
+import { query } from './query.js';
+import { sqlAccess } from './sql-access.js';
+import { sqlCore } from './sql-core.js';
+import { sqlTime } from './sql-time.js';
+import { sqlWrite } from './sql-write.js';
+import { time } from './time.js';
+import { write } from './write.js';
+/** Разделы каталога: имя — префикс ключа и имя файла. */
+const SECTIONS = {
+    codes, api, write, query, time, access, model, boot, mcp,
+    'sql-core': sqlCore, 'sql-write': sqlWrite, 'sql-access': sqlAccess, 'sql-time': sqlTime,
+};
+/** Разделы, которые установщик кладёт в базу (message_catalog() в lib/sql/15-errors.sql). */
+export const SQL_SECTIONS = ['sql-core', 'sql-write', 'sql-access', 'sql-time'];
+function merge(sections) {
+    const out = {};
+    for (const [name, section] of Object.entries(sections)) {
+        for (const [key, m] of Object.entries(section)) {
+            if (!key.startsWith(`${name}.`))
+                throw new Error(`letopis: ключ каталога ${key} — не из раздела ${name}`);
+            if (Object.hasOwn(out, key))
+                throw new Error(`letopis: ключ каталога ${key} повторяется`);
+            out[key] = m;
+        }
+    }
+    return out;
+}
+/** Все записи каталога по ключу. */
+export const MESSAGES = merge(SECTIONS);
+/** Запись по ключу из любого источника (DETAIL базы, вызов из JS); нет такой — undefined. */
+export function msgOf(key) {
+    return Object.hasOwn(MESSAGES, key) ? MESSAGES[key] : undefined;
+}
+/** Подпись кода: заголовок и подсказка «что делать» (codes.ts). */
+export function codeOf(code) {
+    return msgOf(`codes.${code}`);
+}
+/** Суффикс похожих имён (params.similar) — его дописывает lerr. */
+export const SIMILAR = ' — похожие: {similar}';
+/**
+ * Шаблон с параметрами: `{имя}` → значение, напечатанное как в шаблонной строке JS (`${x}`), поэтому перенос текста
+ * `…${x}…` в шаблон `…{x}…` его не меняет. `{имя}` без такого параметра остаётся как есть; так же — lt_text() в базе
+ * (там null — пусто, как у format('%s')).
+ */
+export function render(template, params) {
+    if (!params)
+        return template;
+    return template.replace(/\{([A-Za-z_][A-Za-z0-9_]*)\}/g, (m, k) => (Object.hasOwn(params, k) ? String(params[k]) : m));
+}
+/** Разделы sql-* для базы: ключ → имя ошибки и русский шаблон (установщик подставляет в @MESSAGES@). */
+export function sqlCatalog() {
+    const out = {};
+    for (const s of SQL_SECTIONS) {
+        for (const [key, m] of Object.entries(SECTIONS[s]))
+            out[key] = { name: m.code, ru: m.ru };
+    }
+    return out;
+}