letopis 1.4.1 → 2.0.0

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 {};

package/dist/messages/write.d.ts

@@ -0,0 +1,405 @@
+export declare const write: {
+    'write.bad_reason': {
+        code: "invalid_query";
+        ru: string;
+    };
+    'write.inc_in_array': {
+        code: "invalid_data";
+        ru: string;
+    };
+    'write.op_in_data': {
+        code: "invalid_data";
+        ru: string;
+    };
+    'write.inc_by_not_finite': {
+        code: "invalid_data";
+        ru: string;
+    };
+    'write.inc_start_not_finite': {
+        code: "invalid_data";
+        ru: string;
+    };
+    'write.op_in_patch': {
+        code: "invalid_data";
+        ru: string;
+    };
+    'write.data_not_object': {
+        code: "invalid_data";
+        ru: string;
+    };
+    'write.inc_outside_update': {
+        code: "invalid_data";
+        ru: string;
+    };
+    'write.op_in_verb_data': {
+        code: "invalid_data";
+        ru: string;
+    };
+    'write.as_of_write': {
+        code: "invalid_query";
+        ru: string;
+    };
+    'write.with_deleted_write': {
+        code: "invalid_query";
+        ru: string;
+    };
+    'write.verb_after_verb': {
+        code: "invalid_query";
+        ru: string;
+    };
+    'write.create_on_pivot': {
+        code: "invalid_query";
+        ru: string;
+    };
+    'write.create_with_filter': {
+        code: "invalid_query";
+        ru: string;
+    };
+    'write.upsert_no_key': {
+        code: "no_key";
+        ru: string;
+    };
+    'write.bad_tags': {
+        code: "invalid_query";
+        ru: string;
+    };
+    'write.patch_not_object': {
+        code: "invalid_data";
+        ru: string;
+    };
+    'write.bad_rev': {
+        code: "invalid_query";
+        ru: string;
+    };
+    'write.no_filter': {
+        code: "invalid_query";
+        ru: string;
+        hint: string;
+    };
+    'write.slot_bad_verb': {
+        code: "invalid_query";
+        ru: string;
+    };
+    'write.slot_unknown': {
+        code: "invalid_class";
+        ru: string;
+    };
+    'write.slot_not_end': {
+        code: "invalid_query";
+        ru: string;
+    };
+    'write.slot_ambiguous': {
+        code: "invalid_query";
+        ru: string;
+    };
+    'write.end_ambiguous': {
+        code: "invalid_query";
+        ru: string;
+    };
+    'write.end_not_single': {
+        code: "invalid_query";
+        ru: string;
+    };
+    'write.slot_single_many': {
+        code: "invalid_query";
+        ru: string;
+    };
+    'write.exists': {
+        code: "exists";
+        ru: string;
+    };
+    'write.exists_id': {
+        code: "exists";
+        ru: string;
+    };
+    'write.target_missing': {
+        code: "target_not_found";
+        ru: string;
+    };
+    'write.targets_missing': {
+        code: "target_not_found";
+        ru: string;
+    };
+    'write.rev_conflict': {
+        code: "conflict";
+        ru: string;
+    };
+    'write.rows_denied': {
+        code: "acl_denied";
+        ru: string;
+    };
+    'write.rev_many_targets': {
+        code: "rev_ambiguous";
+        ru: string;
+    };
+    'write.rev_no_target': {
+        code: "target_not_found";
+        ru: string;
+    };
+    'write.not_deleted': {
+        code: "not_deleted";
+        ru: string;
+    };
+    'write.commit_unknown': {
+        code: "commit_unknown";
+        ru: string;
+    };
+    'write.tx_done': {
+        code: "tx_required";
+        ru: string;
+        hint: string;
+    };
+    'write.lock_tx_done': {
+        code: "tx_required";
+        ru: string;
+        hint: string;
+    };
+    'write.tx_rolled_back': {
+        code: "tx_rolled_back";
+        ru: string;
+    };
+    'write.load_cancelled': {
+        code: "invalid_data";
+        ru: string;
+    };
+    'write.load_cancelled_more': {
+        code: "invalid_data";
+        ru: string;
+    };
+    'write.load_cancelled_at_least': {
+        code: "invalid_data";
+        ru: string;
+    };
+    'write.load_cancelled_maybe_more': {
+        code: "invalid_data";
+        ru: string;
+    };
+    'write.load_later_portions': {
+        code: "invalid_data";
+        ru: string;
+    };
+    'write.load_later_batches': {
+        code: "invalid_data";
+        ru: string;
+    };
+    'write.load_db_rules_unchecked': {
+        code: "invalid_data";
+        ru: string;
+    };
+    'write.load_db_check_limit': {
+        code: "invalid_data";
+        ru: string;
+    };
+    'write.load_bad_input': {
+        code: "invalid_data";
+        ru: string;
+        hint: string;
+    };
+    'write.load_end_not_uuid': {
+        code: "invalid_data";
+        ru: string;
+    };
+    'write.load_end_value': {
+        code: "invalid_data";
+        ru: string;
+    };
+    'write.load_end_polymorphic': {
+        code: "invalid_data";
+        ru: string;
+    };
+    'write.load_target_class': {
+        code: "invalid_data";
+        ru: string;
+    };
+    'write.load_target_key': {
+        code: "invalid_data";
+        ru: string;
+    };
+    'write.load_ext_keyed': {
+        code: "invalid_data";
+        ru: string;
+    };
+    'write.load_ext_string': {
+        code: "invalid_data";
+        ru: string;
+    };
+    'write.load_end_list': {
+        code: "invalid_data";
+        ru: string;
+    };
+    'write.load_end_ref': {
+        code: "invalid_data";
+        ru: string;
+    };
+    'write.load_end_repeat': {
+        code: "invalid_data";
+        ru: string;
+    };
+    'write.load_inc': {
+        code: "invalid_data";
+        ru: string;
+    };
+    'write.load_filter_op': {
+        code: "invalid_data";
+        ru: string;
+    };
+    'write.load_invalid_data': {
+        code: "invalid_data";
+        ru: string;
+    };
+    'write.load_end_too_few': {
+        code: "invalid_data";
+        ru: string;
+    };
+    'write.load_end_required': {
+        code: "invalid_data";
+        ru: string;
+    };
+    'write.load_end_too_many': {
+        code: "invalid_data";
+        ru: string;
+    };
+    'write.load_key_part_ref': {
+        code: "invalid_data";
+        ru: string;
+    };
+    'write.load_key_part_string': {
+        code: "invalid_data";
+        ru: string;
+    };
+    'write.load_admin_required': {
+        code: "admin_required";
+        ru: string;
+    };
+    'write.load_as_not_uuid': {
+        code: "invalid_data";
+        ru: string;
+        hint: string;
+    };
+    'write.load_as_history': {
+        code: "invalid_data";
+        ru: string;
+        hint: string;
+    };
+    'write.load_history_update': {
+        code: "invalid_data";
+        ru: string;
+        hint: string;
+    };
+    'write.load_initial_commit_every': {
+        code: "invalid_data";
+        ru: string;
+        hint: string;
+    };
+    'write.load_initial_existing': {
+        code: "invalid_data";
+        ru: string;
+        hint: string;
+    };
+    'write.load_initial_as': {
+        code: "invalid_data";
+        ru: string;
+        hint: string;
+    };
+    'write.load_no_tenant': {
+        code: "invalid_data";
+        ru: string;
+        hint: string;
+    };
+    'write.load_class_not_found': {
+        code: "invalid_class";
+        ru: string;
+    };
+    'write.load_no_class': {
+        code: "invalid_class";
+        ru: string;
+    };
+    'write.load_class_rows': {
+        code: "class_not_loadable";
+        ru: string;
+    };
+    'write.load_class_abstract': {
+        code: "invalid_class";
+        ru: string;
+    };
+    'write.load_taken': {
+        code: "exists";
+        ru: string;
+    };
+    'write.load_duplicate': {
+        code: "duplicate";
+        ru: string;
+    };
+    'write.load_no_write': {
+        code: "acl_denied";
+        ru: string;
+    };
+    'write.load_target_not_found': {
+        code: "target_not_found";
+        ru: string;
+    };
+    'write.load_owner_not_found': {
+        code: "target_not_found";
+        ru: string;
+    };
+    'write.load_tenant_denied': {
+        code: "tenant_denied";
+        ru: string;
+    };
+    'write.load_exists': {
+        code: "exists";
+        ru: string;
+    };
+    'write.load_deleted': {
+        code: "deleted";
+        ru: string;
+    };
+    'write.load_objects_exist': {
+        code: "exists";
+        ru: string;
+    };
+    'write.load_account_tenant': {
+        code: "tenant_denied";
+        ru: string;
+    };
+    'write.load_member_tenant': {
+        code: "invalid_data";
+        ru: string;
+    };
+    'write.load_tags': {
+        code: "invalid_data";
+        ru: string;
+    };
+    'write.load_as_owner': {
+        code: "invalid_data";
+        ru: string;
+    };
+    'write.load_owner_id': {
+        code: "invalid_data";
+        ru: string;
+    };
+    'write.load_other_class': {
+        code: "exists";
+        ru: string;
+    };
+    'write.load_acl_row': {
+        code: "acl_denied";
+        ru: string;
+    };
+    'write.load_acl_update': {
+        code: "acl_denied";
+        ru: string;
+    };
+    'write.load_history_versions': {
+        code: "invalid_data";
+        ru: string;
+    };
+    'write.load_not_empty': {
+        code: "not_empty";
+        ru: string;
+    };
+    'write.tx_retry_hint': {
+        code: "invalid_query";
+        ru: string;
+    };
+};