letopis 1.4.2 → 3.0.0

package/dist/messages/access.d.ts

@@ -0,0 +1,90 @@
+export declare const access: {
+    'access.switch_not_root': {
+        code: "invalid_query";
+        ru: string;
+        hint: string;
+    };
+    'access.role_not_string': {
+        code: "invalid_data";
+        ru: string;
+        hint: string;
+    };
+    'access.bad_role_name': {
+        code: "invalid_data";
+        ru: string;
+        hint: string;
+    };
+    'access.bad_condition_column': {
+        code: "invalid_data";
+        ru: string;
+        hint: string;
+    };
+    'access.bad_rule_target': {
+        code: "invalid_data";
+        ru: string;
+        hint: string;
+    };
+    'access.bad_endpoint_mask': {
+        code: "invalid_data";
+        ru: string;
+        hint: string;
+    };
+    'access.rule_spec_not_object': {
+        code: "invalid_data";
+        ru: string;
+        hint: string;
+    };
+    'access.unknown_rule_field': {
+        code: "invalid_data";
+        ru: string;
+        hint: string;
+    };
+    'access.bad_rule_weight': {
+        code: "invalid_data";
+        ru: string;
+        hint: string;
+    };
+    'access.rule_who': {
+        code: "invalid_data";
+        ru: string;
+        hint: string;
+    };
+    'access.no_rule_operations': {
+        code: "invalid_data";
+        ru: string;
+        hint: string;
+    };
+    'access.no_facade': {
+        code: "invalid_query";
+        ru: string;
+    };
+    'access.bad_account': {
+        code: "invalid_data";
+        ru: string;
+        hint: string;
+    };
+    'access.no_session_tenant': {
+        code: "no_session";
+        ru: string;
+    };
+    'access.roles_not_array': {
+        code: "invalid_data";
+        ru: string;
+        hint: string;
+    };
+    'access.duplicate_roles': {
+        code: "invalid_data";
+        ru: string;
+        hint: string;
+    };
+    'access.bad_scrypt_params': {
+        code: "invalid_data";
+        ru: string;
+        hint: string;
+    };
+    'access.bad_totp_secret': {
+        code: "invalid_data";
+        ru: string;
+        hint: string;
+    };
+};

package/dist/messages/access.js

@@ -0,0 +1,113 @@
+/**
+ * Подсказка неверного вызова db.acl: общая подсказка invalid_data — про issues, а у этих ошибок их нет. Параметр what в
+ * записях db.acl — метод (grant, deny, revoke, roles), с которого начинается текст.
+ */
+const ACL_CALL = 'исправить аргумент по тексту ошибки; вызовы db.acl — README, «Выдать право»';
+export const access = {
+    // auth.ts, switch(): фасад db.as() арендатора не меняет
+    'access.switch_not_root': {
+        code: 'invalid_query',
+        ru: 'auth.switch() — от корня подключения: при имперсонации арендатора задаёт db.as(…, { tenant })',
+        hint: 'сменить арендатора корня — db.auth.switch(); фасаду db.as() арендатора задают при создании: db.as(аккаунт, { tenant })',
+    },
+    // acl.ts, roleName: роль в grant, deny, revoke или в списке db.acl.roles — не строка; type — её тип
+    'access.role_not_string': {
+        code: 'invalid_data',
+        ru: 'db.acl.{what}: role — строка, а не {type}',
+        hint: ACL_CALL,
+    },
+    // acl.ts, roleName: имя роли пустое, с запятой или фигурной скобкой, с «!» в начале или с пробелом по краям
+    'access.bad_role_name': {
+        code: 'invalid_data',
+        ru: 'db.acl.{what}: роль {role} — непустая строка без запятых и фигурных скобок, без «!» в начале и пробелов по краям',
+        hint: ACL_CALL,
+    },
+    // acl.ts, classItem: условие цели правила — на колонку не из списка
+    'access.bad_condition_column': {
+        code: 'invalid_data',
+        ru: 'db.acl.{what}: условие на колонку {column} — условие ставят на {columns}',
+        hint: ACL_CALL,
+    },
+    // acl.ts, classItem: цель read, write или delete — не имя класса, не звёздочка и не объект с полем class
+    'access.bad_rule_target': {
+        code: 'invalid_data',
+        ru: "db.acl.{what}: цель {target} — имя класса, '*' (все классы) или { class, …условие на строки }",
+        hint: ACL_CALL,
+    },
+    // acl.ts, apiItem: цель api — не маска эндпоинта
+    'access.bad_endpoint_mask': {
+        code: 'invalid_data',
+        ru: 'db.acl.{what}: api {endpoint} — маска эндпоинта: сегменты через «.», {a,b} — любой из, * — хвост',
+        hint: ACL_CALL,
+    },
+    // acl.ts, parse: описание правила grant, deny или revoke — не объект
+    'access.rule_spec_not_object': {
+        code: 'invalid_data',
+        ru: 'db.acl.{what}: нужен объект { role, read | write | delete | api }',
+        hint: ACL_CALL,
+    },
+    // acl.ts, parse: лишнее поле в описании правила (у revoke нет и weight)
+    'access.unknown_rule_field': {
+        code: 'invalid_data',
+        ru: 'db.acl.{what}: поле {field} — допустимы {fields}',
+        hint: ACL_CALL,
+    },
+    // acl.ts, parse: weight — не целое от 1 до 999
+    'access.bad_rule_weight': {
+        code: 'invalid_data',
+        ru: 'db.acl.{what}: weight — целое от 1 до 999: вес правила арендатора (от 1000 — административный слой System)',
+        hint: ACL_CALL,
+    },
+    // acl.ts, parse: кому правило — нет ни role, ни everyone, есть оба или everyone не true
+    'access.rule_who': {
+        code: 'invalid_data',
+        ru: 'db.acl.{what}: кому правило — ровно одно из role (роль членства) и everyone: true (все аккаунты арендатора)',
+        hint: ACL_CALL,
+    },
+    // acl.ts, parse: в описании правила нет ни read, ни write, ни delete, ни api
+    'access.no_rule_operations': {
+        code: 'invalid_data',
+        ru: 'db.acl.{what}: нужна хотя бы одна операция: read, write, delete или api',
+        hint: ACL_CALL,
+    },
+    // acl.ts, makeAcl: db.acl без фасада подключения, а grant, deny, revoke, roles и list идут его цепочками
+    'access.no_facade': {
+        code: 'invalid_query',
+        ru: 'db.acl: запись правил — от фасада подключения',
+    },
+    // acl.ts, roles(): аккаунт — не id и не строка с полем id
+    'access.bad_account': {
+        code: 'invalid_data',
+        ru: 'db.acl.roles: аккаунт — id или строка с полем id',
+        hint: ACL_CALL,
+    },
+    // acl.ts, roles() и list(): у фасада нет рабочего арендатора — подключение без сессии; what — метод
+    'access.no_session_tenant': {
+        code: 'no_session',
+        ru: 'db.acl.{what}: нет арендатора сессии',
+    },
+    // acl.ts, roles(): роли — не массив и не null
+    'access.roles_not_array': {
+        code: 'invalid_data',
+        ru: 'db.acl.roles: роли — массив строк или null (снять членство)',
+        hint: ACL_CALL,
+    },
+    // acl.ts, roles(): роль в списке повторяется
+    'access.duplicate_roles': {
+        code: 'invalid_data',
+        ru: 'db.acl.roles: роли повторяются',
+        hint: ACL_CALL,
+    },
+    // auth.ts, verifyHash: scrypt отверг N, r, p из строки хэша — недопустимы или требуют больше 64 МБ памяти
+    'access.bad_scrypt_params': {
+        code: 'invalid_data',
+        ru: 'хэш пароля: параметры scrypt N={N}, r={r}, p={p} недопустимы или требуют больше 64 МБ памяти',
+        hint: 'хэш с такими параметрами не проверить: задать пароль заново — auth.setPassword()',
+    },
+    // auth.ts, base32Decode: в секрете TOTP (totpCode) знак не из алфавита base32
+    'access.bad_totp_secret': {
+        code: 'invalid_data',
+        ru: 'секрет TOTP — не base32',
+        hint: 'передать секрет из auth.enrollTotp() — строку base32 (A–Z, 2–7)',
+    },
+};

package/dist/messages/api.d.ts

@@ -0,0 +1,237 @@
+export declare const api: {
+    'api.validation_failed': {
+        code: "invalid_data";
+        ru: string;
+    };
+    'api.unknown_step': {
+        code: "invalid_class";
+        ru: string;
+        hint: string;
+    };
+    'api.token_not_active': {
+        code: "no_session";
+        ru: string;
+        hint: string;
+    };
+    'api.unknown_step_no_classes': {
+        code: "invalid_class";
+        ru: string;
+        hint: string;
+    };
+    'api.chain_not_rows': {
+        code: "invalid_query";
+        ru: string;
+        hint: string;
+    };
+    'api.step_undefined_filter': {
+        code: "invalid_query";
+        ru: string;
+    };
+    'api.sort_not_last': {
+        code: "invalid_query";
+        ru: string;
+    };
+    'api.with_deleted_step': {
+        code: "invalid_query";
+        ru: string;
+    };
+    'api.db_bad_value': {
+        code: "invalid_query";
+        ru: string;
+        hint: string;
+    };
+    'api.validation_issue': {
+        code: "invalid_data";
+        ru: string;
+    };
+    'api.validation_root': {
+        code: "invalid_data";
+        ru: string;
+    };
+    'api.validation_more': {
+        code: "invalid_data";
+        ru: string;
+    };
+    'api.connect_schema': {
+        code: "invalid_data";
+        ru: string;
+        hint: string;
+    };
+    'api.unknown_option': {
+        code: "invalid_data";
+        ru: string;
+        hint: string;
+    };
+    'api.row_check_denied': {
+        code: "acl_denied";
+        ru: string;
+    };
+    'api.no_history': {
+        code: "invalid_query";
+        ru: string;
+    };
+    'api.slow_query': {
+        code: "invalid_query";
+        ru: string;
+    };
+    'api.batch_queued': {
+        code: "invalid_query";
+        ru: string;
+    };
+    'api.mod_after_verb': {
+        code: "invalid_query";
+        ru: string;
+    };
+    'api.after_not_paged': {
+        code: "invalid_query";
+        ru: string;
+        hint: string;
+    };
+    'api.for_update_outside_tx': {
+        code: "tx_required";
+        ru: string;
+    };
+    'api.for_update_unsupported': {
+        code: "lock_unsupported";
+        ru: string;
+        hint: string;
+    };
+    'api.lock_denied': {
+        code: "acl_denied";
+        ru: string;
+    };
+    'api.slot_value': {
+        code: "invalid_query";
+        ru: string;
+    };
+    'api.slot_without_write': {
+        code: "invalid_query";
+        ru: string;
+    };
+    'api.slot_single': {
+        code: "invalid_query";
+        ru: string;
+    };
+    'api.slot_required': {
+        code: "invalid_query";
+        ru: string;
+    };
+    'api.slot_twice': {
+        code: "invalid_query";
+        ru: string;
+    };
+    'api.step_mod_after_verb': {
+        code: "invalid_query";
+        ru: string;
+    };
+    'api.verb_without_step': {
+        code: "invalid_query";
+        ru: string;
+    };
+    'api.entity_with_verbs': {
+        code: "invalid_query";
+        ru: string;
+    };
+    'api.entity_arg': {
+        code: "invalid_query";
+        ru: string;
+    };
+    'api.slot_method': {
+        code: "invalid_query";
+        ru: string;
+    };
+    'api.cache_ttl': {
+        code: "invalid_query";
+        ru: string;
+    };
+    'api.tx_only': {
+        code: "tx_required";
+        ru: string;
+    };
+    'api.id_of_no_tenant': {
+        code: "no_session";
+        ru: string;
+    };
+    'api.as_in_tx': {
+        code: "invalid_query";
+        ru: string;
+    };
+    'api.as_no_session': {
+        code: "no_session";
+        ru: string;
+    };
+    'api.as_context_changing': {
+        code: "no_session";
+        ru: string;
+        hint: string;
+    };
+    'api.begin_arg': {
+        code: "invalid_query";
+        ru: string;
+        hint: string;
+    };
+    'api.nested_begin': {
+        code: "invalid_query";
+        ru: string;
+    };
+    'api.load_in_tx': {
+        code: "invalid_query";
+        ru: string;
+    };
+    'api.connect_no_dsn': {
+        code: "invalid_data";
+        ru: string;
+        hint: string;
+    };
+    'api.connect_empty_credential': {
+        code: "invalid_data";
+        ru: string;
+        hint: string;
+    };
+    'api.connect_admin_type': {
+        code: "invalid_data";
+        ru: string;
+        hint: string;
+    };
+    'api.connect_admin_role': {
+        code: "admin_required";
+        ru: string;
+        hint: string;
+    };
+    'api.connect_no_owner': {
+        code: "invalid_data";
+        ru: string;
+        hint: string;
+    };
+    'api.connect_bypass_rls': {
+        code: "bypass_rls";
+        ru: string;
+    };
+    'api.admin_connection': {
+        code: "bypass_rls";
+        ru: string;
+    };
+    'api.connect_no_schema': {
+        code: "invalid_data";
+        ru: string;
+        hint: string;
+    };
+    'api.schema_older': {
+        code: "invalid_data";
+        ru: string;
+    };
+    'api.schema_newer': {
+        code: "invalid_data";
+        ru: string;
+    };
+    'api.create_tenant_admin': {
+        code: "invalid_query";
+        ru: string;
+        hint: string;
+    };
+    'api.versions_terminal': {
+        code: "invalid_query";
+        ru: string;
+        hint: string;
+    };
+};