letopis 2.0.0 → 3.0.1

package/api-contract.json

@@ -0,0 +1,385 @@
+{
+  "$comment": "СГЕНЕРИРОВАНО lib/scripts/gen-api-contract.mjs из исходников — не редактировать руками. Регенерация: cd lib && npm run api:contract. CI сверяет через npm run check:docs.",
+  "package": {
+    "name": "letopis",
+    "type": "module",
+    "engines": {
+      "node": ">=22"
+    },
+    "exports": [
+      ".",
+      "./model",
+      "./mcp"
+    ]
+  },
+  "exports": {
+    ".": {
+      "values": [
+        "CHAIN_METHODS",
+        "DB_METHODS",
+        "DDL_REVISION",
+        "LOG_EVENTS",
+        "LetopisError",
+        "RESERVED_CLASS_NAMES",
+        "Registry",
+        "ValidationError",
+        "applyDefaults",
+        "between",
+        "compileValidator",
+        "connect",
+        "createTenant",
+        "cursorOf",
+        "ends",
+        "exists",
+        "fromDbError",
+        "generateTypes",
+        "gt",
+        "gte",
+        "has",
+        "hasAll",
+        "hasAny",
+        "hashPassword",
+        "idOf",
+        "ilike",
+        "inList",
+        "inc",
+        "isInc",
+        "isNull",
+        "isOp",
+        "like",
+        "loose",
+        "lt",
+        "lte",
+        "ne",
+        "not",
+        "or",
+        "schemaToTs",
+        "starts",
+        "syncModels",
+        "totpCode",
+        "up",
+        "uuidv5",
+        "v5Id",
+        "v5Name",
+        "verifyHash"
+      ],
+      "types": [
+        "AclApi",
+        "AclDataDecision",
+        "AclDecision",
+        "AclOp",
+        "AclRule",
+        "AclRuleSpec",
+        "AclTarget",
+        "AnyModelLike",
+        "AuthApi",
+        "Batch",
+        "BatchEntry",
+        "CacheOptions",
+        "CacheStats",
+        "Chain",
+        "ChainCore",
+        "ChainMods",
+        "ChainRef",
+        "ClassInfo",
+        "ConnectOptions",
+        "Credential",
+        "Cursor",
+        "Db",
+        "DbCore",
+        "DbTx",
+        "DeleteOptions",
+        "EndInfo",
+        "Expected",
+        "FieldFilter",
+        "FieldFilterOf",
+        "Filter",
+        "FilterOf",
+        "IncMarker",
+        "Issue",
+        "KeyedClass",
+        "LeafType",
+        "LoadInput",
+        "LoadIssue",
+        "LoadOptions",
+        "LoadReport",
+        "LogEvent",
+        "LogEventName",
+        "LogFn",
+        "LogLevel",
+        "LogObject",
+        "LogOptions",
+        "Logger",
+        "LoginOptions",
+        "LoginResult",
+        "MaintainReport",
+        "ModelLike",
+        "Op",
+        "OrOp",
+        "PatchOf",
+        "Path",
+        "QueryEvent",
+        "RestoreOptions",
+        "Row",
+        "RowOf",
+        "Scalar",
+        "SessionInfo",
+        "SignalMode",
+        "StepFn",
+        "StepsOf",
+        "Subscription",
+        "SyncResult",
+        "SystemModels",
+        "TenantOptions",
+        "TenantResult",
+        "TypedChain",
+        "TypedDb",
+        "UpOptions",
+        "UpResult",
+        "Validator",
+        "WatchEvent",
+        "WatchOptions",
+        "WriteRow"
+      ]
+    },
+    "./model": {
+      "values": [
+        "End",
+        "hub",
+        "link",
+        "many",
+        "normalizeSchema",
+        "one",
+        "translatePattern"
+      ],
+      "types": [
+        "AnyModel",
+        "ClassDef",
+        "ClassDescription",
+        "ClassMeta",
+        "Infer",
+        "InferLinks",
+        "JsonSchema",
+        "LostRule",
+        "Model",
+        "OnDelete"
+      ]
+    },
+    "./mcp": {
+      "values": [
+        "createMcpServer"
+      ],
+      "types": [
+        "McpOptions"
+      ]
+    }
+  },
+  "chain": [
+    "add",
+    "after",
+    "alias",
+    "asOf",
+    "avg",
+    "cache",
+    "count",
+    "countBy",
+    "create",
+    "deep",
+    "delete",
+    "entity",
+    "exact",
+    "first",
+    "forUpdate",
+    "ids",
+    "limit",
+    "max",
+    "min",
+    "offset",
+    "owner",
+    "paths",
+    "remove",
+    "restore",
+    "rows",
+    "set",
+    "sort",
+    "sum",
+    "tags",
+    "then",
+    "unset",
+    "update",
+    "upsert",
+    "versions",
+    "withDeleted"
+  ],
+  "db": [
+    "acl",
+    "as",
+    "auth",
+    "batch",
+    "begin",
+    "cache",
+    "close",
+    "commit",
+    "flushSignals",
+    "idOf",
+    "load",
+    "lock",
+    "maintain",
+    "refresh",
+    "registry",
+    "rollback",
+    "schema",
+    "sql",
+    "tenant",
+    "token",
+    "transaction",
+    "watch"
+  ],
+  "batch": [
+    "discard",
+    "run",
+    "size"
+  ],
+  "codes": [
+    "acl_denied",
+    "admin_required",
+    "bypass_rls",
+    "class_not_loadable",
+    "commit_unknown",
+    "confirmation_required",
+    "conflict",
+    "delete_restricted",
+    "deleted",
+    "duplicate",
+    "exists",
+    "id_from_db",
+    "id_mismatch",
+    "immutable_key",
+    "internal",
+    "invalid_class",
+    "invalid_data",
+    "invalid_query",
+    "isolation_level",
+    "lock_unsupported",
+    "no_key",
+    "no_path",
+    "no_session",
+    "not_deleted",
+    "not_empty",
+    "recreated_in_statement",
+    "rev_ambiguous",
+    "target_not_found",
+    "tenant_denied",
+    "tightening_conflict",
+    "tx_required",
+    "tx_rolled_back",
+    "undeclared_end",
+    "user_session_required"
+  ],
+  "errors": [
+    {
+      "module": "15-errors",
+      "message": "letopis: acl_denied: отказ по правилам доступа"
+    },
+    {
+      "module": "15-errors",
+      "message": "letopis: delete_restricted: удалению мешают ссылающиеся строки"
+    },
+    {
+      "module": "15-errors",
+      "message": "letopis: id_from_db: id класса без ключа выдаёт база"
+    },
+    {
+      "module": "15-errors",
+      "message": "letopis: id_mismatch: id не равен v5 от ключа"
+    },
+    {
+      "module": "15-errors",
+      "message": "letopis: immutable_key: ключевое поле менять нельзя"
+    },
+    {
+      "module": "15-errors",
+      "message": "letopis: invalid_class: описание класса отклонено"
+    },
+    {
+      "module": "15-errors",
+      "message": "letopis: invalid_data: данные не проходят описание класса"
+    },
+    {
+      "module": "15-errors",
+      "message": "letopis: isolation_level: операция разрешена только в read committed"
+    },
+    {
+      "module": "15-errors",
+      "message": "letopis: no_session: нет действующей сессии"
+    },
+    {
+      "module": "15-errors",
+      "message": "letopis: not_deleted: объект не удалён — restore только для удалённых"
+    },
+    {
+      "module": "15-errors",
+      "message": "letopis: recreated_in_statement: id удалён и создан заново одним оператором"
+    },
+    {
+      "module": "15-errors",
+      "message": "letopis: target_not_found: цель не найдена"
+    },
+    {
+      "module": "15-errors",
+      "message": "letopis: tenant_denied: чужой арендатор"
+    },
+    {
+      "module": "15-errors",
+      "message": "letopis: tightening_conflict: ужесточению описания мешают строки"
+    },
+    {
+      "module": "15-errors",
+      "message": "letopis: undeclared_end: конец не объявлен в классе"
+    },
+    {
+      "module": "60-write",
+      "message": "letopis: invalid_data: "
+    },
+    {
+      "module": "cli",
+      "message": "letopis: <…>"
+    },
+    {
+      "module": "errors",
+      "message": "letopis: <…>"
+    },
+    {
+      "module": "errors",
+      "message": "letopis: <…>: <…>"
+    },
+    {
+      "module": "errors",
+      "message": "letopis: invalid_data: <…><…>"
+    },
+    {
+      "module": "messages/index",
+      "message": "letopis: ключ каталога <…> повторяется"
+    },
+    {
+      "module": "messages/index",
+      "message": "letopis: ключ каталога <…> — не из раздела <…>"
+    },
+    {
+      "module": "up",
+      "message": "letopis.up: ${own ? seed : "
+    },
+    {
+      "module": "up",
+      "message": "letopis.up: <…>"
+    },
+    {
+      "module": "up",
+      "message": "letopis.up: <…>: <…>"
+    },
+    {
+      "module": "up",
+      "message": "letopis.up: migrate/<…>: <…>"
+    }
+  ]
+}

package/dist/acl.d.ts

@@ -1,4 +1,5 @@
 import type { Executor } from './tx.js';
+import type { CallSpec } from './log.js';
 export type AclOp = 'READ' | 'WRITE' | 'DELETE';
 /** Решение по ресурсу приложения (эндпоинту): можно ли к нему обратиться. */
 export interface AclDecision {
@@ -50,7 +51,7 @@ export interface AclRuleSpec {
 /** Правило арендатора в виде обёртки. */
 export interface AclRule {
     id: string;
-    /** Роль группы `role:<роль>:ACCOUNT`; null — группа не одной роли (все аккаунты или своя группа). */
+    /** Роль правила; null — правило не одной роли (все аккаунты или своя группа). */
     role: string | null;
     /** Группа всех аккаунтов арендатора: `authenticated:ACCOUNT` от createTenant или `everyone:ACCOUNT` обёртки. */
     everyone: boolean;
@@ -86,7 +87,9 @@ export interface AclApi {
     /** Запретить — те же правила с запретом: при равном весе запрет сильнее разрешения. */
     deny(spec: AclRuleSpec): Promise<AclRule[]>;
     /**
-     * Снять правила роли или всех аккаунтов — разрешения и запреты — для этих операций и целей; число снятых.
+     * Снять правила роли или всех аккаунтов — разрешения и запреты — для этих операций и целей; возвращает число снятых
+     * правил. Операции снимаются по очереди, и правило на несколько операций считается один раз: «можно всё» на чтение,
+     * запись и удаление от createTenant даёт 1.
      * `revoke({ everyone: true, read: '*', write: '*', delete: '*' })` снимает «можно всё» от createTenant: дальше права —
      * только по ролям.
      */
@@ -110,3 +113,5 @@ export interface AclApi {
  * транзакции.
  */
 export declare function makeAcl(S: string, exec: Executor, db?: () => unknown): AclApi;
+/** Что пишет в лог каждый метод db.acl: правка прав — acl.change, проверки и список — acl.check. */
+export declare const ACL_LOG: Readonly<Record<string, CallSpec>>;

package/dist/acl.js

@@ -200,8 +200,9 @@ export function makeAcl(S, exec, db) {
                         objects.push(sysId(`all:${it.op}`));
                     for (const g of groups) {
                         for (const o of objects) {
+                            // снять правило — замысел вызова, превью некому показывать: { all: true } (3.0) — без сверки, цели сужает фильтр
                             if (g && o)
-                                n += (await tr.rule({ Group: g, Object: o }).delete({ confirm: true }).rows()).length;
+                                n += (await tr.rule({ Group: g, Object: o }).delete({ confirm: true, all: true }).rows()).length;
                         }
                     }
                 }
@@ -221,7 +222,8 @@ export function makeAcl(S, exec, db) {
                 return m ? [...(m.data.roles ?? [])] : null;
             }
             if (roles === null) {
-                await inTx('roles', (tr) => tr.member({ User: acc, Tenant: tenant }).delete({ confirm: true }).rows());
+                // roles(account, null) — снять членство: замысел вызова, без сверки с превью (3.0)
+                await inTx('roles', (tr) => tr.member({ User: acc, Tenant: tenant }).delete({ confirm: true, all: true }).rows());
                 return null;
             }
             if (!Array.isArray(roles))
@@ -275,3 +277,18 @@ export function makeAcl(S, exec, db) {
     };
     return api;
 }
+// ---------------------------------------------------------------------------
+// Логирование (3.0): события db.acl — обёртка instrument (log.ts)
+// ---------------------------------------------------------------------------
+const accountOf = (a) => (a !== null && typeof a === 'object' ? a.id : a);
+/** Что пишет в лог каждый метод db.acl: правка прав — acl.change, проверки и список — acl.check. */
+export const ACL_LOG = {
+    check: (args, r) => ({ event: 'acl.check', detail: { endpoint: args[0], decision: r } }),
+    checkData: (args, r) => ({ event: 'acl.check', detail: { class: args[0], access: args[1], decision: r } }),
+    grant: (args, r) => ({ event: 'acl.change', rows: Array.isArray(r) ? r.length : undefined, detail: { action: 'grant', spec: args[0] } }),
+    deny: (args, r) => ({ event: 'acl.change', rows: Array.isArray(r) ? r.length : undefined, detail: { action: 'deny', spec: args[0] } }),
+    revoke: (args, n) => ({ event: 'acl.change', rows: typeof n === 'number' ? n : undefined, detail: { action: 'revoke', spec: args[0] } }),
+    roles: (args, r) => ({ event: args.length > 1 && args[1] !== undefined ? 'acl.change' : 'acl.check',
+        detail: { action: 'roles', account: accountOf(args[0]), roles: r } }),
+    list: (_args, r) => ({ event: 'acl.check', rows: Array.isArray(r) ? r.length : undefined, detail: { action: 'list' } }),
+};

package/dist/admin.d.ts

@@ -1,3 +1,4 @@
+import { type Log } from './log.js';
 import { type Executor, type TxContext } from './tx.js';
 export interface MaintainReport {
     /** Другой процесс уже обслуживает установку (держит строку-замок обслуживания): этот вызов ничего не делал. */
@@ -29,6 +30,11 @@ export interface AdminCtx {
 export declare function maintain(a: AdminCtx): Promise<MaintainReport>;
 /** Предупреждение о заполненной очереди сигналов (§2.12): больше половины — зависший слушатель. */
 export declare function queueWarning(queue: number): string | null;
+/**
+ * Короткая форма интервала — '500ms', '30s', '15m', '1h', '1d' (дробное число тоже) — в миллисекундах; другая строка —
+ * null. Общая для connect({ maintain }) и срока ttl у auth (3.0.1).
+ */
+export declare function shortIntervalMs(v: string): number | null;
 /**
  * Интервал расписания: число мс или строка '500ms', '30s', '15m', '1h', '1d' — конечный, от 1 мс до 2³¹−1 мс (около 24
  * суток); иначе invalid_data. Ноль, отрицательное, NaN и слишком длинный интервал таймер Node.js превращает в 1 мс —
@@ -40,4 +46,4 @@ export declare function parseInterval(v: unknown): number;
  * следующий запуск не начинается, пока идёт прежний. Возвращает остановку: она снимает таймер и ждёт конца идущего
  * запуска — close() закрывает пул после него, а не посреди транзакции.
  */
-export declare function scheduleMaintain(run: () => Promise<unknown>, ms: number): () => Promise<void>;
+export declare function scheduleMaintain(run: () => Promise<unknown>, ms: number, log?: Log): () => Promise<void>;

package/dist/admin.js

@@ -2,7 +2,8 @@
  * Эксплуатация (план, этап 6, п. 7, 8): maintain и его запуск по расписанию. Всё проверяет база: функция владельца
  * 90-time.sql сама сверяет права (letopis.maintain — системный администратор или администраторское подключение).
  */
-import { lerr, lmsg, lwarn } from './errors.js';
+import { lerr, lmsg, lwarn, warnText } from './errors.js';
+import { safeErrorText } from './log.js';
 import { runTx } from './tx.js';
 /**
  * Обслуживание: истёкшие и погашенные сессии, одноразовые коды, строки-замки удалённых семейств и заполнение очереди
@@ -21,8 +22,9 @@ export async function maintain(a) {
     const b = r;
     const report = { skipped: false, sessions: b.sessions, codes: b.codes, queue: Number(b.queue) };
     const warn = queueWarning(report.queue);
+    // логгер задан — событие warning (time.signal_queue), иначе console.warn, как прежде
     if (warn)
-        console.warn(warn);
+        warnText(warn, 'time.signal_queue', a.txc.log, { queue: report.queue });
     return report;
 }
 /** Предупреждение о заполненной очереди сигналов (§2.12): больше половины — зависший слушатель. */
@@ -31,6 +33,14 @@ export function queueWarning(queue) {
 }
 /** Самый длинный интервал таймера Node.js — 2³¹−1 мс (около 24,8 суток): дольше таймер не ждёт и срабатывает сразу. */
 const MAX_TIMER_MS = 2 ** 31 - 1;
+/**
+ * Короткая форма интервала — '500ms', '30s', '15m', '1h', '1d' (дробное число тоже) — в миллисекундах; другая строка —
+ * null. Общая для connect({ maintain }) и срока ttl у auth (3.0.1).
+ */
+export function shortIntervalMs(v) {
+    const m = /^(\d+(?:\.\d+)?)\s*(ms|s|m|h|d)$/.exec(v.trim());
+    return m ? Number(m[1]) * { ms: 1, s: 1000, m: 60_000, h: 3_600_000, d: 86_400_000 }[m[2]] : null;
+}
 /**
  * Интервал расписания: число мс или строка '500ms', '30s', '15m', '1h', '1d' — конечный, от 1 мс до 2³¹−1 мс (около 24
  * суток); иначе invalid_data. Ноль, отрицательное, NaN и слишком длинный интервал таймер Node.js превращает в 1 мс —
@@ -40,11 +50,8 @@ export function parseInterval(v) {
     let ms = Number.NaN;
     if (typeof v === 'number')
         ms = v;
-    else if (typeof v === 'string') {
-        const m = /^(\d+(?:\.\d+)?)\s*(ms|s|m|h|d)$/.exec(v.trim());
-        if (m)
-            ms = Number(m[1]) * { ms: 1, s: 1000, m: 60_000, h: 3_600_000, d: 86_400_000 }[m[2]];
-    }
+    else if (typeof v === 'string')
+        ms = shortIntervalMs(v) ?? Number.NaN;
     if (!Number.isFinite(ms) || ms < 1 || ms > MAX_TIMER_MS) {
         const shown = typeof v === 'string' ? `'${v}'` : typeof v === 'number' || typeof v === 'boolean' || v == null ? String(v) : typeof v;
         throw lerr('time.bad_interval', { value: shown });
@@ -56,14 +63,14 @@ export function parseInterval(v) {
  * следующий запуск не начинается, пока идёт прежний. Возвращает остановку: она снимает таймер и ждёт конца идущего
  * запуска — close() закрывает пул после него, а не посреди транзакции.
  */
-export function scheduleMaintain(run, ms) {
+export function scheduleMaintain(run, ms, log) {
     let stopped = false;
     let current = null;
     const timer = setInterval(() => {
         if (current || stopped)
             return;
         current = run()
-            .then(() => { }, (e) => lwarn('time.maintain_failed', { message: e.message }))
+            .then(() => { }, (e) => lwarn('time.maintain_failed', { message: safeErrorText(e) }, { log }))
             .finally(() => (current = null));
     }, ms);
     timer.unref?.();

package/dist/auth.d.ts

@@ -1,4 +1,5 @@
 import type { Executor } from './tx.js';
+import type { CallSpec } from './log.js';
 /** Хэш пароля scrypt: `scrypt$N$r$p$соль$хэш`. */
 export declare function hashPassword(password: string): Promise<string>;
 /** Проверка пароля по хэшу scrypt; другие форматы не проверяются. */
@@ -10,6 +11,17 @@ export declare function totpCode(secretBase32: string, atMs?: number): string;
 type AccountRef = string | {
     id: string;
 };
+/**
+ * Срок ttl (3.0.1) — интервал для базы: число секунд, короткая форма как у connect({ maintain }) ('30s', '15m', '2h',
+ * '1d') или строка-интервал PostgreSQL ('15 minutes') — её разбирает база, ошибку разбора переводит ttlGuard. Не задан —
+ * null (срок по умолчанию). Не число больше нуля, пустая строка, другой тип — invalid_data (access.bad_ttl).
+ */
+export declare function ttlOf(v: unknown, where: string): string | null;
+/**
+ * Строка ttl, которую не принял разбор интервала PostgreSQL (22007 — не интервал, 22008 и 22015 — вне диапазона), —
+ * invalid_data access.bad_ttl вместо сырой ошибки базы; прочие ошибки — как есть.
+ */
+export declare function ttlGuard<T>(run: Promise<T>, ttl: unknown, where: string): Promise<T>;
 /** Успешный вход: аккаунт и токен новой сессии. */
 export interface LoginResult {
     account: string;
@@ -45,6 +57,10 @@ export interface Credential {
     created_at: string;
     expires_at: string | null;
 }
+/**
+ * Вход, креды и сессии (`db.auth`). Срок `ttl` у входа, ключей, кодов и сессий — число секунд или строка: короткая форма
+ * `'15m'`/`'2h'`/`'30s'`/`'1d'` либо интервал PostgreSQL `'15 minutes'`; иное — `invalid_data`.
+ */
 export interface AuthApi {
     /** Пароль (и любой «логин/пароль»: `kind` — `PASSWORD`, `EMAIL`, …): создать или заменить. Смена гасит остальные сессии аккаунта. */
     setPassword(a: {
@@ -65,14 +81,14 @@ export interface AuthApi {
         password: string;
         kind?: string;
         requireConfirmed?: boolean;
-        ttl?: number;
+        ttl?: number | string;
         totp?: string;
     }): Promise<LoginResult | null>;
     /** Ключ API `lts_…`: отдаётся один раз. Себе сервис выпускает ключ сам по сессии своего ключа. */
     issueApiKey(a: {
         account: AccountRef;
         name?: string;
-        ttl?: number;
+        ttl?: number | string;
     }): Promise<{
         key: string;
         id: string;
@@ -111,7 +127,7 @@ export interface AuthApi {
         account: AccountRef;
         identifier: string;
         kind?: string;
-        ttl?: number;
+        ttl?: number | string;
         digits?: number;
         maxAttempts?: number;
     }): Promise<{
@@ -146,7 +162,7 @@ export interface AuthApi {
         kind: string;
         identifier: string;
         requireConfirmed?: boolean;
-        ttl?: number;
+        ttl?: number | string;
         totp?: string;
     }): Promise<LoginResult | null>;
     /** Способы входа (креды) аккаунта — без хэшей и секретов. */
@@ -164,9 +180,12 @@ export interface AuthApi {
         confirmed?: boolean;
         enabled?: boolean;
     }): Promise<boolean>;
-    /** Сессия пользователя для другого процесса (право `auth.session`); срок — `ttl` в секундах, по умолчанию 7 суток. */
+    /**
+     * Сессия пользователя для другого процесса (право `auth.session`). Срок `ttl` — число секунд или строка: короткая форма
+     * `'15m'`/`'2h'`/`'30s'`/`'1d'` либо интервал PostgreSQL `'15 minutes'`; по умолчанию 7 суток.
+     */
     sessionFor(account: AccountRef, opts?: {
-        ttl?: number;
+        ttl?: number | string;
     }): Promise<string>;
     /**
      * Сведения о сессии по её токену — для сервиса, который держит токен пользователя (например, в cookie): чья это
@@ -180,20 +199,35 @@ export interface AuthApi {
      * `no_session` — у подключения нет действующей сессии.
      */
     session(token: string): Promise<SessionInfo | null>;
-    /** Продлить текущую сессию; новый срок — от сейчас. */
+    /**
+     * Продлить текущую сессию; новый срок — от сейчас. `ttl` — число секунд или строка: короткая форма `'15m'`/`'2h'`/`'30s'`/`'1d'`
+     * либо интервал PostgreSQL `'15 minutes'`; по умолчанию 7 суток.
+     */
     refresh(opts?: {
-        ttl?: number;
+        ttl?: number | string;
     }): Promise<string>;
-    /** Выход: погасить текущую сессию. */
-    revoke(): Promise<boolean>;
+    /**
+     * Выход. Без аргумента — погасить сессию этого подключения. С токеном — погасить сессию пользователя по её токену
+     * (например, из cookie веб-сервиса): так сервис выводит пользователя, не подключаясь по его токену; нужно право
+     * `auth.session`, как у `session(token)`.
+     * @returns true — сессия погашена; false — токен неверный, сессия уже погашена или истекла (причина не различается).
+     * @throws LetopisError `acl_denied` — с токеном, а у вызывающего нет права `auth.session`; `no_session` — у подключения
+     * нет действующей сессии.
+     */
+    revoke(token?: string): Promise<boolean>;
     /** Выход везде: все сессии аккаунта (чужого — с правом `auth.session`). */
     revokeAll(account?: AccountRef): Promise<number>;
     /** Переключить арендатора сессии: собственный или по членству. */
     switch(tenant: string): Promise<void>;
-    /** Арендаторы, доступные аккаунту сессии: собственный (`owner`) и по членству. */
+    /**
+     * Арендаторы, доступные аккаунту сессии: собственный (`roles: ['owner']`, `personal: true`) и по членству. `name` — имя
+     * аккаунта арендатора (`createTenant({ name })`, у личного — имя пользователя).
+     */
     tenants(): Promise<{
         tenant: string;
         roles: string[];
+        name: string | null;
+        personal: boolean;
     }[]>;
     /**
      * Удалить аккаунт: системный администратор или владелец его
@@ -211,4 +245,6 @@ export interface AuthApi {
 }
 /** Фасад db.auth. onSwitch — подключение перечитывает арендатора, реестр и пропуска прав. */
 export declare function makeAuth(S: string, exec: Executor, onSwitch: () => Promise<void>, canSwitch: boolean): AuthApi;
+/** Что пишет в лог каждый метод db.auth. */
+export declare const AUTH_LOG: Readonly<Record<string, CallSpec>>;
 export {};