letopis 1.4.2 → 3.0.0

package/dist/messages/sql-write.js

@@ -0,0 +1,270 @@
+export const sqlWrite = {
+    // 60-write.sql, lock_row(), family_lock(): внутренняя ошибка (SQLSTATE XX000) — строки-замка нет и после вставки или
+    // блокировка её не нашла; name — имя строки-замка
+    'sql-write.lock_row_not_created': {
+        code: 'internal',
+        ru: 'строка-замок {name} не создана',
+    },
+    'sql-write.lock_row_not_found': {
+        code: 'internal',
+        ru: 'строка-замок {name} не найдена',
+    },
+    // 60-write.sql, триггеры вставки и правки, move_row: данные не проходят описание класса; detail.issues — нарушения
+    'sql-write.invalid_data': {
+        code: 'invalid_data',
+        ru: 'данные не проходят описание класса {cls}',
+    },
+    // links_shape(): разбор концов строки (триггеры вставки и правки; check_links — restore)
+    'sql-write.links_not_object': {
+        code: 'invalid_data',
+        ru: 'links — не объект',
+    },
+    'sql-write.end_undeclared': {
+        code: 'undeclared_end',
+        ru: 'конец {end} не объявлен в классе {cls}',
+    },
+    'sql-write.end_not_list': {
+        code: 'invalid_data',
+        ru: 'конец {end} — список id',
+    },
+    'sql-write.end_not_uuid': {
+        code: 'invalid_data',
+        ru: 'конец {end}: значение не uuid',
+    },
+    'sql-write.end_target_repeated': {
+        code: 'invalid_data',
+        ru: 'конец {end}: цель повторяется',
+    },
+    'sql-write.end_too_few': {
+        code: 'invalid_data',
+        ru: 'у конца {end} слишком мало целей',
+    },
+    'sql-write.end_too_many': {
+        code: 'invalid_data',
+        ru: 'у конца {end} слишком много целей',
+    },
+    'sql-write.end_required': {
+        code: 'invalid_data',
+        ru: 'обязательный конец {end} не задан',
+    },
+    // check_links(), триггеры после вставки и правки (targets_bad): цель конца не найдена
+    'sql-write.end_target_missing': {
+        code: 'target_not_found',
+        ru: 'цель конца {end} не найдена',
+    },
+    // family_conflicts(): чем строка семейства не проходит новое описание — поле problem в detail.rows отказа
+    // tightening_conflict (ужесточение класса); у строки ещё key и params — fromDbError их убирает
+    'sql-write.problem_abstract': {
+        code: 'tightening_conflict',
+        ru: 'класс абстрактный',
+    },
+    // issues — нарушения текстом JSON без key и params; в params строки — сами нарушения с ключами (массив)
+    'sql-write.problem_data': {
+        code: 'tightening_conflict',
+        ru: 'данные: {issues}',
+    },
+    'sql-write.problem_key': {
+        code: 'tightening_conflict',
+        ru: 'id не соответствует ключу класса',
+    },
+    // ссылающаяся строка видна актору — её роль и id; не видна — ни роли, ни id
+    'sql-write.problem_ref': {
+        code: 'tightening_conflict',
+        ru: 'на строку ссылается роль {role} строки {id}, которая не принимает класс',
+    },
+    'sql-write.problem_ref_hidden': {
+        code: 'tightening_conflict',
+        ru: 'на строку ссылается строка, которой актор не видит, и она не принимает класс',
+    },
+    // class_rows_admit(): нет права без условий на все строки класса {target} (сам класс {cls} или его потомок); что
+    // меняется — p_what: reparent, history, tighten; иной p_what — прежний готовый текст {what}
+    'sql-write.reparent_needs_all': {
+        code: 'acl_denied',
+        ru: 'класс {cls} меняет предков или алиас: нужно право {op} на все строки класса {target}',
+    },
+    'sql-write.history_needs_all': {
+        code: 'acl_denied',
+        ru: 'класс {cls} включает или выключает журнал (history): нужно право {op} на все строки класса {target}',
+    },
+    'sql-write.tighten_needs_all': {
+        code: 'acl_denied',
+        ru: 'ужесточение класса {cls}: нужно право {op} на все строки класса {target}',
+    },
+    'sql-write.change_needs_all': {
+        code: 'acl_denied',
+        ru: '{what}: нужно право {op} на все строки класса {target}',
+    },
+    // class_admit(): проверки строки Class сверх метасхемы
+    'sql-write.system_name_reserved': {
+        code: 'invalid_class',
+        ru: 'имя {name} зарезервировано за системным классом',
+    },
+    'sql-write.system_flag': {
+        code: 'invalid_class',
+        ru: 'признак system задаёт только установка',
+    },
+    'sql-write.system_name_taken': {
+        code: 'invalid_class',
+        ru: 'имя {name} занято системным классом',
+    },
+    'sql-write.link_name_reserved': {
+        code: 'invalid_class',
+        ru: 'имя связи {name} совпадает с методом цепочки',
+    },
+    // хаб с зарезервированным именем (план 2.0, этап 4, п. 2; 7.10 №3): прежние такие хабы up() оставляет и называет в
+    // предупреждении (boot.reserved_hubs), но описание их строки Class база больше не пишет
+    'sql-write.hub_name_reserved': {
+        code: 'invalid_class',
+        ru: 'имя хаба {name} совпадает с методом цепочки',
+    },
+    'sql-write.alias_taken': {
+        code: 'invalid_class',
+        ru: 'алиас {alias} класса {cls} совпадает с именем или алиасом другого класса',
+    },
+    'sql-write.name_is_alias': {
+        code: 'invalid_class',
+        ru: 'имя класса {cls} совпадает с алиасом другого класса',
+    },
+    'sql-write.alias_orphan_history': {
+        code: 'invalid_class',
+        ru: 'удалённые потомки класса {cls} хранят историю строк: алиас не меняется',
+    },
+    'sql-write.end_other_class': {
+        code: 'invalid_class',
+        ru: 'конец {end} в классе {cls} ведёт на другой класс',
+    },
+    // триггеры вставки и правки
+    'sql-write.no_session': {
+        code: 'no_session',
+        ru: 'нет действующей сессии',
+    },
+    'sql-write.foreign_tenant': {
+        code: 'tenant_denied',
+        ru: 'запись в чужого арендатора',
+    },
+    'sql-write.account_tenant': {
+        code: 'tenant_denied',
+        ru: 'аккаунты лежат в арендаторе System',
+    },
+    'sql-write.class_not_found': {
+        code: 'invalid_class',
+        ru: 'класс {cls} не найден',
+    },
+    // класс удалили, пока писатель ждал блокировку семейства
+    'sql-write.class_deleted': {
+        code: 'invalid_class',
+        ru: 'класс {cls} удалён',
+    },
+    'sql-write.class_abstract': {
+        code: 'invalid_class',
+        ru: 'класс {cls} абстрактный',
+    },
+    'sql-write.member_tenant': {
+        code: 'invalid_data',
+        ru: 'конец Tenant членства — арендатор строки',
+    },
+    'sql-write.id_from_db': {
+        code: 'id_from_db',
+        ru: 'id класса без ключа {cls} выдаёт база',
+    },
+    // detail.expected — id от ключа
+    'sql-write.id_mismatch': {
+        code: 'id_mismatch',
+        ru: 'id не равен v5 от ключа класса {cls}',
+    },
+    'sql-write.history_recreate': {
+        code: 'invalid_class',
+        ru: 'журнал хранит историю строк класса {cls} или его удалённых потомков: создать его можно только заново и с прежними parent, alias и history',
+    },
+    'sql-write.owner_not_found': {
+        code: 'target_not_found',
+        ru: 'владелец строки не найден',
+    },
+    'sql-write.immutable_columns': {
+        code: 'immutable_key',
+        ru: 'id, арендатора, владельца и время создания менять нельзя',
+    },
+    // класс строки неизменен (план 2.0, редакция 2): смены класса нет
+    'sql-write.class_immutable': {
+        code: 'immutable_key',
+        ru: 'класс строки {cls} неизменен: объект другого класса — новый объект',
+    },
+    'sql-write.key_changed': {
+        code: 'immutable_key',
+        ru: 'ключевое поле класса {cls} менять нельзя: id изменился бы',
+    },
+    // class_evolve(): detail — видимые нарушающие строки и число остальных (visible_detail)
+    'sql-write.tightening_mismatch': {
+        code: 'tightening_conflict',
+        ru: 'новому описанию класса {cls} не соответствуют строки',
+    },
+    // триггеры удаления
+    'sql-write.delete_isolation': {
+        code: 'isolation_level',
+        ru: 'удаление разрешено только в read committed',
+    },
+    'sql-write.system_account_delete': {
+        code: 'acl_denied',
+        ru: 'аккаунт System не удаляется: ему принадлежат служебные строки установки',
+    },
+    'sql-write.recreated_in_statement': {
+        code: 'recreated_in_statement',
+        ru: 'id удалён и создан заново одним оператором',
+    },
+    'sql-write.class_not_empty': {
+        code: 'invalid_class',
+        ru: 'у класса {cls} есть строки или потомки',
+    },
+    'sql-write.class_has_history': {
+        code: 'invalid_class',
+        ru: 'у класса {cls} есть история строк в журнале: класс с историей строк не удаляется',
+    },
+    // каскад и снятие конца: класс отказавшей строки — только если актор её видит (visible_class)
+    'sql-write.cascade_delete_denied': {
+        code: 'acl_denied',
+        ru: 'нет права DELETE на класс {cls} в каскаде удаления',
+    },
+    'sql-write.cascade_delete_denied_hidden': {
+        code: 'acl_denied',
+        ru: 'нет права DELETE на строки в каскаде удаления',
+    },
+    'sql-write.unset_write_denied': {
+        code: 'acl_denied',
+        ru: 'нет права WRITE на класс {cls}: снятие конца при удалении',
+    },
+    'sql-write.unset_write_denied_hidden': {
+        code: 'acl_denied',
+        ru: 'нет права WRITE на ссылающуюся строку: снятие конца при удалении',
+    },
+    // detail — видимые актору мешающие строки и число остальных (visible_detail)
+    'sql-write.delete_restricted': {
+        code: 'delete_restricted',
+        ru: 'на удаляемые строки ссылаются другие строки (onDelete: restrict)',
+    },
+    // links_patch() и inc() исполняет приложение: raise с lt_text(), в detail — key и params
+    'sql-write.links_patch_op': {
+        code: 'invalid_data',
+        ru: 'links_patch: неизвестная операция {op}',
+    },
+    // inc(): нарушение — и в detail.issues[0].message
+    'sql-write.inc_args': {
+        code: 'invalid_data',
+        ru: 'inc: нужны путь и величина',
+    },
+    'sql-write.inc_path_missing': {
+        code: 'invalid_data',
+        ru: 'inc: путь {path} идёт через отсутствующий объект',
+    },
+    'sql-write.inc_path_not_object': {
+        code: 'invalid_data',
+        ru: 'inc: путь {path} идёт не через объект',
+    },
+    'sql-write.inc_no_field': {
+        code: 'invalid_data',
+        ru: 'inc: поля {path} нет — задайте start',
+    },
+    'sql-write.inc_not_number': {
+        code: 'invalid_data',
+        ru: 'inc: в поле {path} не число',
+    },
+};

package/dist/messages/time.d.ts

@@ -0,0 +1,23 @@
+export declare const time: {
+    'time.maintain_in_tx': {
+        code: "invalid_query";
+        ru: string;
+    };
+    'time.signal_queue': {
+        code: "invalid_query";
+        ru: string;
+    };
+    'time.bad_interval': {
+        code: "invalid_data";
+        ru: string;
+        hint: string;
+    };
+    'time.maintain_failed': {
+        code: "invalid_query";
+        ru: string;
+    };
+    'time.watch_cursor': {
+        code: "invalid_query";
+        ru: string;
+    };
+};

package/dist/messages/time.js

@@ -0,0 +1,29 @@
+export const time = {
+    // admin.ts, maintain(): внутри db.begin()
+    'time.maintain_in_tx': {
+        code: 'invalid_query',
+        ru: 'maintain() идёт своей транзакцией, не внутри db.begin()',
+    },
+    // admin.ts, queueWarning: очередь сигналов PostgreSQL заполнена больше чем наполовину — предупреждение maintain();
+    // pct — проценты целым числом; код записи не печатается
+    'time.signal_queue': {
+        code: 'invalid_query',
+        ru: 'очередь сигналов PostgreSQL заполнена на {pct} % — проверьте зависших слушателей',
+    },
+    // admin.ts, parseInterval: интервал connect({ maintain }); value — как передан (строка — в кавычках)
+    'time.bad_interval': {
+        code: 'invalid_data',
+        ru: "интервал {value}: число мс или строка '30s', '15m', '1h', '1d' — от 1 мс до 2³¹−1 мс (около 24 суток)",
+        hint: "задать интервал числом миллисекунд или строкой вида '30s', '15m', '1h', '1d'",
+    },
+    // admin.ts, scheduleMaintain: запуск maintain() по расписанию упал — предупреждение (lwarn); message — текст его ошибки
+    'time.maintain_failed': {
+        code: 'invalid_query',
+        ru: 'maintain по расписанию: {message}',
+    },
+    // watch.ts, decode: курсор watch({ from }) не разбирается; cursor — как передан
+    'time.watch_cursor': {
+        code: 'invalid_query',
+        ru: 'watch: курсор {cursor} — ожидается курсор события',
+    },
+};

package/dist/messages/types.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Каталог сообщений letopis (план 2.0, этап 3, п. 3) — типы записей. Как перевести место на ключ и вызывать — шапка
+ * index.ts.
+ */
+/**
+ * Коды ошибок letopis: каталог базы (SQLSTATE LT001–LT018, `error_catalog()` в lib/sql/15-errors.sql, `LT_NAMES` в
+ * errors.ts) и коды самой библиотеки. Новый код — сюда, в codes.ts (заголовок и подсказка) и в раздел «Ошибки» README
+ * (с якорем `<a id="код"></a>`). `internal` — внутренняя ошибка базы: SQLSTATE XX000 с ключом каталога в DETAIL
+ * (`lt_raise('XX000', ключ, …)`, fromDbError).
+ */
+export type ErrorCode = 'no_session' | 'target_not_found' | 'invalid_data' | 'undeclared_end' | 'tenant_denied' | 'acl_denied' | 'id_mismatch' | 'id_from_db' | 'immutable_key' | 'invalid_class' | 'tightening_conflict' | 'isolation_level' | 'recreated_in_statement' | 'delete_restricted' | 'not_deleted' | 'exists' | 'duplicate' | 'deleted' | 'conflict' | 'rev_ambiguous' | 'tx_required' | 'lock_unsupported' | 'commit_unknown' | 'tx_rolled_back' | 'no_key' | 'no_path' | 'invalid_query' | 'admin_required' | 'not_empty' | 'class_not_loadable' | 'bypass_rls' | 'user_session_required' | 'confirmation_required' | 'internal';
+/**
+ * Запись каталога: код ошибки, шаблон текста (`ru`), `{имя}` в шаблоне — параметр. `hint` — своя подсказка «что делать»;
+ * без неё ошибка берёт подсказку своего кода из codes.ts. Поля — в этом порядке: code, ru, hint.
+ */
+export interface Msg {
+    code: ErrorCode;
+    ru: string;
+    hint?: string;
+}
+/**
+ * Параметры шаблона: `{имя}` → значение, напечатанное как в шаблонной строке JS (`${x}`). `similar` (массив похожих
+ * имён) дописывает к тексту «— похожие: …» сам `lerr`.
+ */
+export type Params = Readonly<Record<string, unknown>>;
+/** Раздел каталога: ключи только вида `<раздел>.<snake_case>` — чужой префикс не пропустит проверка типов. */
+export type Section<P extends string> = Record<`${P}.${string}`, Msg>;

package/dist/messages/types.js

@@ -0,0 +1,5 @@
+/**
+ * Каталог сообщений letopis (план 2.0, этап 3, п. 3) — типы записей. Как перевести место на ключ и вызывать — шапка
+ * index.ts.
+ */
+export {};