letopis 3.0.0 → 3.0.1

package/dist/index.d.ts

@@ -29,8 +29,7 @@ export { ne, gt, gte, lt, lte, between, inList, like, ilike, starts, ends, has,
 /**
  * Хотя бы один из фильтров: `db.Product(or({ sku: 'K-1' }, { price: lt(500) }))` — товар K-1 или дешевле 500. Ставится
  * вместо всего фильтра шага, а не значением поля; условия внутри одного фильтра соединяются через «и». В шаге подключения
- * с моделями (`TypedDb`) фильтры внутри — поля и роли класса шага: тип им даёт шаг (план 2.0, этап 4, п. 1). Та же
- * фабрика, что в реестре операторов (ops.ts), — другой у неё только тип.
+ * с моделями (`TypedDb`) фильтры внутри — поля и роли класса шага: тип им даёт шаг.
  */
 export declare const or: <F extends object>(...filters: NoInfer<F>[]) => OrOp<F>;
 export { cursorOf } from './sql.js';
@@ -55,7 +54,7 @@ export interface ConnectOptions extends LogOptions {
     sql?: postgres.Sql;
     /** Схема установки, например `v2.salon`; имя без точки (`salon`) — как у `up()`: `v2.salon`. */
     schema: string;
-    /** Токен сессии; либо ключ `APIKEY` в `apiKey` (он же `service` — ключ сервиса) — его обменяют на сессию. */
+    /** Токен сессии; либо ключ API в `apiKey` (он же `service` — ключ сервиса) — его обменяют на сессию. */
     token?: string;
     apiKey?: string;
     service?: string;
@@ -121,7 +120,15 @@ export interface DbCore {
      * класса. Сами права база применяет при каждом запросе.
      */
     readonly acl: AclApi;
-    /** Сырой SQL под сессией и RLS, одной транзакцией (в `db.begin()` — в ней): `` db.sql`select …` ``. */
+    /**
+     * Сырой SQL под сессией и RLS, одной транзакцией (в `db.begin()` — в ней); права те же, что у цепочек. Путь поиска
+     * схем у запроса — по умолчанию PostgreSQL, поэтому таблицы `entity`, `log`, `secret` пишутся со схемой установки в
+     * двойных кавычках, значения — параметрами шаблона:
+     * ```ts
+     * const rows = await db.sql`select id, data->>'name' as name from "v2.shop".entity where class = ${'Shop'}`;
+     * ```
+     * Без схемы (`from entity`) — ошибка PostgreSQL 42P01 «relation does not exist».
+     */
     sql(strings: TemplateStringsArray, ...values: unknown[]): Promise<postgres.Row[]>;
     /** Транзакция под сессией: `fn` получает соединение postgres.js (в `db.begin()` — ту же транзакцию). */
     transaction<T>(fn: (tx: Tx) => Promise<T>): Promise<T>;
@@ -162,14 +169,15 @@ export interface DbCore {
     }): Promise<DbTx>;
     /**
      * Массовая загрузка строк любых классов одной транзакцией (или порциями `commitEvery`) — быстрее записи цепочками.
-     * Строки проверяются по тому же описанию класса, что и при обычной записи (данные, ссылки, ключ), уходят в базу
-     * командой `COPY`, а ссылки на объекты вне загрузки сверяет один запрос в конце; права проверяются только при загрузке
+     * Строки проверяются по тому же описанию класса, что и при обычной записи (данные, концы, ключ), уходят в базу
+     * командой `COPY`, а концы к объектам вне загрузки сверяет один запрос в конце; права проверяются только при загрузке
      * от имени пользователя (опция `as`). Работает только на администраторском подключении, иначе `admin_required`.
      */
     load(input: LoadInput, opts?: LoadOptions): Promise<LoadReport>;
     /**
-     * Именованная очередь планов фасада: `batch.Класс(…).create(…)`; `batch.run()` — одной транзакцией. У корня,
-     * у каждого `db.as()` и у каждой `db.begin()` очереди свои: план исполняется от имени фасада, который его поставил.
+     * Именованная очередь планов подключения (db, db.as(), db.begin()): `batch.Класс(…).create(…)`; `batch.run()` — одной
+     * транзакцией. У корня, у каждого `db.as()` и у каждой `db.begin()` очереди свои: план исполняется от имени того
+     * подключения, которое его поставило.
      */
     batch(name: string, opts?: {
         reason?: string;
@@ -181,8 +189,11 @@ export interface DbCore {
     /** Откатить транзакцию `tr` (то же, что `tr.rollback()`). */
     rollback(tr?: DbTx): Promise<void>;
     /**
-     * Закрыть подключение: у корня — пул и подписки, в `db.begin()` — откат транзакции; у фасада `db.as()` ничего не делает
-     * (пул общий с корнем).
+     * Закрыть подключение: у корня — пул, подписки и обслуживание по расписанию (идущий запуск `maintain()` close() ждёт),
+     * в `db.begin()` — откат транзакции; у `db.as()` ничего не делает (пул общий с корнем). После `close()` корня любой
+     * вызов этого подключения и производных от него (`db.as()`, `db.begin()`, цепочки, созданные раньше) — `invalid_query`
+     * «подключение закрыто (db.close()) — откройте новое connect()»; пул заново не открывается, процесс может завершиться.
+     * Повторный `close()` — без ошибки.
      */
     close(): Promise<void>;
 }
@@ -194,15 +205,15 @@ export type Db = DbCore & {
 export type DbTx = Db;
 /**
  * Подключение со строгими типами по моделям: `connect({ models })` или `connect<Models>()` с объявлениями
- * `letopis types`. Шаг — только известный класс или алиас (модели и системные классы), переходы — по концам, слоты — роли
- * класса; имена, известные только во время выполнения, — `loose(db)` (план 2.0, этап 4, п. 1). Модели без литеральных
+ * `letopis types`. Шаг — только известный класс или алиас (модели и системные классы), переходы — по концам, шаги ролей
+ * после глагола — роли класса; имена, известные только во время выполнения, — `loose(db)`. Модели без литеральных
  * имён (`AnyModel[]` вместо списка `as const`) строгим типам не помогут — тогда это `Db`.
  */
 export type TypedDb<M extends readonly AnyModelLike[]> = string extends M[number]['name'] ? Db : DbCore & StepsOf<M>;
 export type { Batch };
 /**
  * То же подключение без строгих типов: шагом может быть любое имя, в том числе известное только во время выполнения, —
- * `loose(db)[имя]()`. Объект тот же: проверки во время выполнения (неизвестное имя или поле, переход, слот) не меняются.
+ * `loose(db)[имя]()`. Объект тот же: проверки во время выполнения (неизвестное имя или поле, переход, шаг роли) не меняются.
  */
 export declare function loose(db: DbCore): Db;
 export declare function connect<const M extends readonly AnyModelLike[]>(opts: ConnectOptions & {

package/dist/index.js

@@ -36,8 +36,7 @@ export { ne, gt, gte, lt, lte, between, inList, like, ilike, starts, ends, has,
 /**
  * Хотя бы один из фильтров: `db.Product(or({ sku: 'K-1' }, { price: lt(500) }))` — товар K-1 или дешевле 500. Ставится
  * вместо всего фильтра шага, а не значением поля; условия внутри одного фильтра соединяются через «и». В шаге подключения
- * с моделями (`TypedDb`) фильтры внутри — поля и роли класса шага: тип им даёт шаг (план 2.0, этап 4, п. 1). Та же
- * фабрика, что в реестре операторов (ops.ts), — другой у неё только тип.
+ * с моделями (`TypedDb`) фильтры внутри — поля и роли класса шага: тип им даёт шаг.
  */
 export const or = orFilters;
 export { cursorOf } from './sql.js';
@@ -60,19 +59,42 @@ const WATCH_OPTIONS = { from: true, classes: true, batch: true, pollMs: true };
 const BEGIN_OPTIONS = { reason: true };
 /**
  * То же подключение без строгих типов: шагом может быть любое имя, в том числе известное только во время выполнения, —
- * `loose(db)[имя]()`. Объект тот же: проверки во время выполнения (неизвестное имя или поле, переход, слот) не меняются.
+ * `loose(db)[имя]()`. Объект тот же: проверки во время выполнения (неизвестное имя или поле, переход, шаг роли) не меняются.
  */
 export function loose(db) {
     return db;
 }
 const quote = (name) => `"${name.replace(/"/g, '""')}"`;
+/** Методы фасада, которые отвечают сразу, а не обещанием: после close() они бросают api.closed синхронно. */
+const SYNC_MEMBERS = new Set(['idOf', 'entity', 'watch', 'batch']);
+/** Свойства фасада, которые после close() читаются как прежде: не обращаются к базе. */
+const PASSIVE_MEMBERS = new Set(['close', 'schema', 'token', 'tenant', 'registry', 'cache']);
+/** Исполнитель, который после close() корня отказывает api.closed: postgres.js reserve() открыл бы закрытый пул заново. */
+function openOnly(sh, exec) {
+    return {
+        explicit: exec.explicit,
+        run: (fn, opts) => (sh.closed ? Promise.reject(lerr('api.closed')) : exec.run(fn, opts)),
+    };
+}
+/** Служебный объект фасада (auth, acl) после close(): каждый метод — отказ api.closed. */
+function closedApi(api) {
+    return new Proxy(api, {
+        get(t, prop, r) {
+            const v = Reflect.get(t, prop, r);
+            return typeof v === 'function' ? () => Promise.reject(lerr('api.closed')) : v;
+        },
+    });
+}
 /** Фасад db: пул (exec — исполнитель пула) или явная транзакция (tx). */
-function makeDb(sh, scope, exec, owner, tx) {
+function makeDb(sh, scope, raw, owner, tx) {
     const txc = scope.txc;
+    // после close() корня цепочки (и созданные до него), auth, acl, db.sql — отказ api.closed; raw — у maintain(), который
+    // идёт по расписанию: close() его дожидается
+    const exec = openOnly(sh, raw);
     // логгер фасада: арендатор и аккаунт — в момент события (корень меняет их auth.switch), метка транзакции — от db.begin()
     const log = (txc.log ?? sh.log).child({ who: () => ({ tenant: scope.tenant(), account: txc.account ?? sh.root.account }) });
     const chainCtx = {
-        reg: scope.registry(), schema: sh.schema, exec, tenant: scope.tenant, hasToken: () => Boolean(txc.token), owner, onQuery: sh.onQuery, slowMs: sh.slowMs,
+        reg: scope.registry(), schema: sh.schema, exec, tenant: scope.tenant, account: () => txc.account ?? sh.root.account, hasToken: () => Boolean(txc.token), owner, onQuery: sh.onQuery, slowMs: sh.slowMs,
         reason: txc.reason ?? '', txReason: txc.reason ?? '', log,
         ...(sh.cache ? { cache: { store: sh.cache, who: () => ({ token: txc.token, account: txc.account, tenant: scope.tenant() }) } } : {}),
     };
@@ -90,7 +112,7 @@ function makeDb(sh, scope, exec, owner, tx) {
     }, scope.root && !tx), log, 'auth', AUTH_LOG, { switch: () => scope.tenant() });
     // запись правил (grant, deny, revoke, roles) идёт цепочками самого фасада — он объявлен ниже, берётся при вызове
     const acl = instrument(makeAcl(sh.S, exec, () => facade), log, 'acl', ACL_LOG);
-    const adm = { S: sh.S, txc, exec };
+    const adm = { S: sh.S, txc, exec: raw };
     // один процесс (план 2.0, 7.9 №3): у корня с connect({ admin }) администраторские вызовы идут вторым пулом с той же
     // сессией, а цепочки и db.sql — пулом приложения под RLS; db.as() и db.begin() администраторский пул не берут
     const viaAdmin = scope.root && !tx && sh.adminSql ? sh.adminSql : null;
@@ -228,10 +250,13 @@ function makeDb(sh, scope, exec, owner, tx) {
         commit: (tr) => traced(log, null, { op: 'commit' }, async () => (tr ? tr.commit() : tx ? tx.commit() : noTx('commit()'))),
         rollback: (tr) => traced(log, null, { op: 'rollback' }, async () => (tr ? tr.rollback() : tx ? tx.rollback() : noTx('rollback()'))),
         // подключение из as() пул не закрывает: пул общий с корнем (план 2.1, A12) — закрывает его close() корня
-        close: () => traced(log, !tx && scope.root ? 'close' : null, { op: 'close', detail: { schema: sh.schema } }, () => (tx ? tx.rollback() : scope.root ? sh.close() : Promise.resolve())),
+        // повторный close() и close() у db.as() или db.begin() закрытого подключения — без ошибки
+        close: () => traced(log, !tx && scope.root ? 'close' : null, { op: 'close', detail: { schema: sh.schema } }, () => (tx ? (sh.closed ? Promise.resolve() : tx.rollback()) : scope.root ? sh.close() : Promise.resolve())),
     };
     /** Свойство фасада: служебное — из core, иначе шаг класса, алиаса или роли. */
     const member = (t, prop, r) => {
+        if (sh.closed && typeof prop === 'string' && prop !== 'then' && !PASSIVE_MEMBERS.has(prop))
+            return closedMember(t, prop, r);
         if (typeof prop === 'symbol' || prop in t)
             return Reflect.get(t, prop, r);
         if (prop === 'then')
@@ -239,6 +264,21 @@ function makeDb(sh, scope, exec, owner, tx) {
         // неизвестный класс или роль — событие error с именем шага
         return log.enabled ? guarded(log, { op: prop, chain: prop }, () => startStep(chainCtx, prop)) : startStep(chainCtx, prop);
     };
+    /** Свойство фасада после close(): методы и шаги — отказ api.closed (обещанием, у шагов и синхронных методов — сразу). */
+    const closedMember = (t, prop, r) => {
+        if (prop in t) {
+            const v = Reflect.get(t, prop, r);
+            if (prop === 'auth' || prop === 'acl')
+                return closedApi(v);
+            if (typeof v !== 'function')
+                return v;
+            if (!SYNC_MEMBERS.has(prop))
+                return () => Promise.reject(lerr('api.closed'));
+        }
+        return () => {
+            throw lerr('api.closed');
+        };
+    };
     const facade = new Proxy(core, {
         get(t, prop, r) {
             return member(t, prop, r);
@@ -650,6 +690,7 @@ async function open(opts, base, info) {
             stamper.unref?.();
         }
         let stopMaintain = null;
+        let closing = null;
         const subs = new Set();
         const shared = {
             sql, schema: opts.schema, S, notifier, passes, root, registryFor, registryOf, refresh, onQuery: opts.onQuery, slowMs: opts.slowMs, log: base,
@@ -666,23 +707,33 @@ async function open(opts, base, info) {
                 subs.add(s);
                 return s;
             },
-            async close() {
-                // живые подписки закрываются: иначе с чужим пулом (connect({ sql })) они опрашивали бы журнал и после close()
-                // (план 2.0, 7.4 №8)
-                for (const s of [...subs])
-                    s.close();
-                // идущий maintain() по расписанию доделывается: пул закрывается после него, а не посреди транзакции
-                await stopMaintain?.();
-                resync.stop();
-                startReload.stop();
-                if (stamper)
-                    clearInterval(stamper);
-                await notifier.close();
-                await listener?.unlisten();
-                if (own)
-                    await sql.end({ timeout: 5 });
-                if (ownAdmin)
-                    await adminSql.end({ timeout: 5 });
+            closed: false,
+            close() {
+                // повторный close() ждёт первого; флаг — сразу: вызовы после close() отказывают api.closed, а не открывают пул
+                // заново (postgres.js reserve() после end() соединяется снова)
+                if (closing)
+                    return closing;
+                shared.closed = true;
+                closing = (async () => {
+                    // живые подписки закрываются: иначе с чужим пулом (connect({ sql })) они опрашивали бы журнал и после close()
+                    // (план 2.0, 7.4 №8)
+                    for (const s of [...subs])
+                        s.close();
+                    // идущий maintain() по расписанию доделывается: пул закрывается после него, а не посреди транзакции
+                    await stopMaintain?.();
+                    resync.stop();
+                    startReload.stop();
+                    if (stamper)
+                        clearInterval(stamper);
+                    cache?.clear();
+                    await notifier.close();
+                    await listener?.unlisten();
+                    if (own)
+                        await sql.end({ timeout: 5 });
+                    if (ownAdmin)
+                        await adminSql.end({ timeout: 5 });
+                })();
+                return closing;
             },
         };
         const db = makeDb(shared, { txc: ctx, tenant: () => root.tenant, registry: () => root.registry, root: true }, poolExecutor(ctx));

package/dist/load.d.ts

@@ -37,7 +37,7 @@ export interface LoadOptions {
     /**
      * Загрузка от имени пользователя (§2.6, п. 10): автор версий — он; арендатор (по умолчанию —
      * собственный аккаунта) доступен ему; право WRITE на каждый класс и условия ACL на новые (и в
-     * existing: 'update' — прежние) значения строк; цели ссылок ему видны; владелец — по ownerDefault.
+     * existing: 'update' — прежние) значения строк; цели концов ему видны; владелец — по ownerDefault.
      */
     as?: string;
     /**

package/dist/log.js

@@ -25,8 +25,29 @@ import { LetopisError, lerr, lmsg, setEnvWarnSink } from './errors.js';
 import { LOG_EVENTS } from './messages/index.js';
 const RANK = { debug: 10, info: 20, warn: 30, error: 40 };
 const LEVELS = ['debug', 'info', 'warn', 'error', 'off'];
-/** Имена полей с секретами: маскируются в любом месте detail всегда. */
-const SECRET_KEY = /pass(?:word|wd|phrase)?$|^pass|^pwd$|secret|token|api_?key|service_?key|authorization|cookie|credential|^hash$|^material$|^totp$|^otp$/i;
+/**
+ * Имена полей с секретами: маскируются в любом месте detail всегда. Имя делится на слова (camelCase, snake_case,
+ * kebab-case, точки, цифры): секрет — слово из SECRET_WORDS (password, newPassword, refresh_token, clientSecret …), пара
+ * слов api/service + key (apiKey, api_key, serviceKey) или имя целиком из SECRET_EXACT. Слово, где «pass» — часть другого
+ * слова (bypass, passage, passport, compass, isPassive), секретом не считается.
+ */
+const SECRET_WORDS = new Set(['password', 'passwords', 'passwd', 'passphrase', 'pwd', 'pass', 'secret', 'secrets', 'token', 'tokens',
+    'apikey', 'apikeys', 'servicekey', 'authorization', 'cookie', 'cookies', 'credential', 'credentials', 'totp', 'otp']);
+const SECRET_EXACT = new Set(['hash', 'material']);
+const SECRET_PAIR = new Set(['api', 'service']);
+const SECRET_STEM = /passw|passphrase|pwd|secret|token|api[-_]?keys?|service[-_]?keys?|credential|cookie|authorization/i;
+const SECRET_KEY = {
+    test(key) {
+        if (SECRET_EXACT.has(key.toLowerCase()))
+            return true;
+        // корни секретов подстрокой — и в склеенных именах (dbpassword, apitoken, x-api-key); голое «pass» сюда не входит,
+        // поэтому bypass, passport, compass секретами не считаются
+        if (SECRET_STEM.test(key))
+            return true;
+        const words = key.replace(/([a-z])([A-Z])/g, '$1 $2').replace(/([A-Z]+)([A-Z][a-z])/g, '$1 $2').toLowerCase().split(/[^a-z]+/);
+        return words.some((w, i) => SECRET_WORDS.has(w) || ((w === 'key' || w === 'keys') && i > 0 && SECRET_PAIR.has(words[i - 1])));
+    },
+};
 /**
  * Учётные данные в строке подключения: схема://пользователь:пароль@хост — всё до последней `@` в части хоста
  * (пароль может содержать `@`, `:` и `/`).

package/dist/mcp.d.ts

@@ -28,7 +28,7 @@ export interface McpOptions {
 }
 /**
  * Сервер MCP для одного пользователя letopis: инструменты `letopis_model`, `letopis_query`, `letopis_history`, а с
- * `{ write: true }` — ещё `letopis_write`. Подключение — сессия пользователя (`connect({ token })`) или фасад
+ * `{ write: true }` — ещё `letopis_write`. Подключение — сессия пользователя (`connect({ token })`) или подключение
  * `db.as(пользователь)`. Транспорт выбирает приложение: `server.connect(транспорт)`, `serveStdio(() => createMcpServer(db))`
  * или обработчик HTTP `createMcpHandler(() => createMcpServer(db))` из SDK; токен запроса HTTP проверяет приложение.
  */

package/dist/mcp.js

@@ -545,7 +545,7 @@ function withLinks(db, cls, c, links) {
 }
 /** Хэш операции удаления: схема, арендатор, класс, цели и превью каскада — подтверждение человека привязано к нему. */
 function operationOf(db, cls, targets, preview) {
-    const rows = preview.map((r) => [r.id, r.class, r.rev, r.$action ?? null, r.$depth ?? null]).sort((x, y) => (String(x[0]) < String(y[0]) ? -1 : 1));
+    const rows = preview.map((r) => [r.id, r.class, r.rev, r.$action ?? null, r.$depth ?? null, r.$count ?? null]).sort((x, y) => (String(x[0]) < String(y[0]) ? -1 : 1));
     return createHash('sha256').update(JSON.stringify({ schema: db.schema, tenant: db.tenant, cls, targets: [...targets].sort(), rows })).digest('hex');
 }
 const hmacOf = (who, exp, op) => createHmac('sha256', STATE_KEY).update(`letopis:mcp:delete:${who.account}:${who.tenant}:${exp}:${op}`).digest('hex');
@@ -662,15 +662,18 @@ async function write(db, a, ctx, sdk, server, o, who) {
         throw lerr('mcp.delete_operation_changed', undefined, { detail: { operation: op } });
     if (!preview.some((r) => (r.$depth ?? 0) === 0))
         throw lerr('mcp.delete_nothing');
-    if (preview.some((r) => r.$action === 'restrict'))
+    // мешают и скрытые правами строки: сводка $hidden 'restrict' (3.0.1)
+    if (preview.some((r) => r.$action === 'restrict' || r.$hidden === 'restrict'))
         throw lerr('mcp.delete_restricted', undefined, { detail: { preview } });
-    const count = (act) => preview.filter((r) => r.$action === act).length;
+    // сводка скрытых строк считается их числом ($count)
+    const count = (act) => preview.filter((r) => act === undefined || r.$action === act || r.$hidden === act)
+        .reduce((n, r) => n + (r.$action === 'hidden' ? r.$count ?? 0 : 1), 0);
     // окно видит человек: каноническое имя класса (имя — идентификатор по метасхеме) и id целей; алиас и meta — текст
     // арендатора, в окно они не попадают (ревью безопасности №2)
     const first = targets.slice(0, CONFIRM_IDS).join(', ');
     const shown = targets.length > CONFIRM_IDS ? lmsg('mcp.delete_ids_more', { ids: first, more: targets.length - CONFIRM_IDS }) : first;
     const message = lmsg('mcp.delete_message', {
-        count: targets.length, cls: db.registry.resolve(cls).name, ids: shown, rows: preview.length,
+        count: targets.length, cls: db.registry.resolve(cls).name, ids: shown, rows: count(),
         deleted: count('delete'), unset: count('unset'), operation: op.slice(0, 12),
     });
     const c = await confirmDelete(sdk, server, ctx, op, message, who);
@@ -738,7 +741,7 @@ async function checkCredentials(db, o) {
 }
 /**
  * Сервер MCP для одного пользователя letopis: инструменты `letopis_model`, `letopis_query`, `letopis_history`, а с
- * `{ write: true }` — ещё `letopis_write`. Подключение — сессия пользователя (`connect({ token })`) или фасад
+ * `{ write: true }` — ещё `letopis_write`. Подключение — сессия пользователя (`connect({ token })`) или подключение
  * `db.as(пользователь)`. Транспорт выбирает приложение: `server.connect(транспорт)`, `serveStdio(() => createMcpServer(db))`
  * или обработчик HTTP `createMcpHandler(() => createMcpServer(db))` из SDK; токен запроса HTTP проверяет приложение.
  */

package/dist/messages/access.d.ts

@@ -87,4 +87,14 @@ export declare const access: {
         ru: string;
         hint: string;
     };
+    'access.bad_max_attempts': {
+        code: "invalid_data";
+        ru: string;
+        hint: string;
+    };
+    'access.bad_ttl': {
+        code: "invalid_data";
+        ru: string;
+        hint: string;
+    };
 };

package/dist/messages/access.js

@@ -110,4 +110,17 @@ export const access = {
         ru: 'секрет TOTP — не base32',
         hint: 'передать секрет из auth.enrollTotp() — строку base32 (A–Z, 2–7)',
     },
+    // auth.ts, issueOtp (3.0.1): maxAttempts не целое или вне 1–10 (раньше база молча приводила к пределу); value — как передан
+    'access.bad_max_attempts': {
+        code: 'invalid_data',
+        ru: 'issueOtp: maxAttempts {value} — целое от 1 до 10',
+        hint: 'maxAttempts — число неверных попыток до того, как код сгорит: целое от 1 до 10 (по умолчанию 5)',
+    },
+    // auth.ts, ttlOf (3.0.1): срок ttl (sessionFor, issueOtp, issueApiKey, verifyPassword, lookup, refresh, createTenant) — не
+    // число секунд, не короткая форма и не интервал PostgreSQL; where — вызов, value — как передан
+    'access.bad_ttl': {
+        code: 'invalid_data',
+        ru: "{where}: ttl {value} — нужно число секунд, '15m' или интервал PostgreSQL '15 minutes'",
+        hint: "срок ttl больше нуля: число секунд (600), короткая форма '30s', '15m', '2h', '1d' или интервал PostgreSQL '15 minutes'",
+    },
 };

package/dist/messages/api.d.ts

@@ -18,6 +18,11 @@ export declare const api: {
         ru: string;
         hint: string;
     };
+    'api.unknown_step_empty_tenant': {
+        code: "invalid_class";
+        ru: string;
+        hint: string;
+    };
     'api.chain_not_rows': {
         code: "invalid_query";
         ru: string;
@@ -170,6 +175,11 @@ export declare const api: {
         ru: string;
         hint: string;
     };
+    'api.closed': {
+        code: "invalid_query";
+        ru: string;
+        hint: string;
+    };
     'api.nested_begin': {
         code: "invalid_query";
         ru: string;

package/dist/messages/api.js

@@ -24,6 +24,13 @@ export const api = {
         ru: 'класс или роль {name} не найдены: в реестре сессии нет ни одного класса арендатора — сессия, похоже, в личном арендаторе',
         hint: 'после входа сессия работает в личном арендаторе пользователя: найти нужного — db.auth.tenants(), перейти — db.auth.switch(tenant) или db.as(аккаунт, { tenant }); классы в арендатор записывает syncModels',
     },
+    // chain.ts (3.0.1): шаг не найден, в реестре сессии только классы System, а арендатор сессии не личный — в нём просто
+    // нет классов; похожие имена — params.similar
+    'api.unknown_step_empty_tenant': {
+        code: 'invalid_class',
+        ru: 'класс или роль {name} не найдены: в этом арендаторе нет классов — вызовите syncModels в нём',
+        hint: 'классы в арендатор записывает syncModels — в сессии этого арендатора (подключение арендатора или db.as(аккаунт, { tenant })); имя — как в модели',
+    },
     // chain.ts: у цепочки спросили свойство массива (length, map, filter, 0 …) или перебрали её — она не массив строк
     'api.chain_not_rows': {
         code: 'invalid_query',
@@ -52,8 +59,8 @@ export const api = {
     // запроса; text — текст сервера
     'api.db_bad_value': {
         code: 'invalid_query',
-        ru: 'значение не того типа: {text}',
-        hint: 'id — строка uuid, числа — числа, даты — строки ISO; проверьте значения фильтра, курсора и опций',
+        ru: 'база не приняла значение: оно не того типа, что поле или параметр запроса (ответ PostgreSQL: {text})',
+        hint: 'передавайте id строкой uuid, числа — числами, даты — строками ISO 8601; проверьте значения фильтра, курсора, опций и параметров db.sql и повторите запрос',
     },
     // errors.ts, ValidationError: первое нарушение в тексте ошибки — путь и сообщение; текст не для ошибки (lmsg)
     'api.validation_issue': {
@@ -136,27 +143,27 @@ export const api = {
     // chain.ts, slotValue: значение .Роль.set(…), .add(…), .remove(…)
     'api.slot_value': {
         code: 'invalid_query',
-        ru: 'значение слота — id, список id, строка ответа или цепочка',
+        ru: 'значение шага роли (.Роль.set(), .add(), .remove()) — id, список id, строка ответа или цепочка',
     },
     // chain.ts: слот не сразу после create(), update() или upsert(); name — роль, как вызвана, op — set, unset, add, remove
     'api.slot_without_write': {
         code: 'invalid_query',
-        ru: 'слот .{name}.{op}() — после create(), update() или upsert(): db.Класс(…).update(…).{name}.{op}(…)',
+        ru: 'шаг роли .{name}.{op}() — после create(), update() или upsert(): db.Класс(…).update(…).{name}.{op}(…)',
     },
     // chain.ts: add() или remove() у одиночного конца
     'api.slot_single': {
         code: 'invalid_query',
-        ru: 'слот .{name}.{op}(): конец {role} одиночный — set() или unset()',
+        ru: 'шаг роли .{name}.{op}(): конец {role} одиночный — set() или unset()',
     },
     // chain.ts: unset() у обязательного конца
     'api.slot_required': {
         code: 'invalid_query',
-        ru: 'слот .{name}.unset(): конец {role} обязателен',
+        ru: 'шаг роли .{name}.unset(): конец {role} обязателен',
     },
     // chain.ts: set() или unset() одного конца дважды в одной записи
     'api.slot_twice': {
         code: 'invalid_query',
-        ru: 'слот {role} задан дважды в одной записи',
+        ru: 'конец {role} задан дважды в одной записи',
     },
     // chain.ts, withLast: deep(), exact(), alias(), tags(), owner() сразу после глагола; verb — глагол
     'api.step_mod_after_verb': {
@@ -181,7 +188,7 @@ export const api = {
     // chain.ts: set, unset, add, remove у цепочки, а не у слота роли; method — имя метода
     'api.slot_method': {
         code: 'invalid_query',
-        ru: '{method}() — метод слота: db.Класс(…).update(…).Роль.{method}(…)',
+        ru: '{method}() — метод шага роли после глагола: db.Класс(…).update(…).Роль.{method}(…)',
     },
     // chain.ts: cache({ ttl })
     'api.cache_ttl': {
@@ -219,8 +226,14 @@ export const api = {
     // аргумента (array — массив)
     'api.begin_arg': {
         code: 'invalid_query',
-        ru: 'db.begin() принимает только опции { reason }, а не {type}: транзакцию открывает begin(), закрывают commit() и rollback()',
-        hint: 'const tr = await db.begin(); try { …; await tr.commit() } catch (e) { await tr.rollback(); throw e }',
+        ru: 'db.begin() принимает только объект опций с полем reason или ничего; передано значение типа {type}. Функцию begin() не вызывает: транзакцию открывает begin(), закрывают commit() и rollback()',
+        hint: 'откройте транзакцию без функции и закройте её сами: const tr = await db.begin(); try { …запросы через tr…; await tr.commit() } catch (e) { await tr.rollback(); throw e }',
+    },
+    // index.ts: вызов цепочки или метода подключения после db.close() корня (и у db.as(), db.begin() этого подключения)
+    'api.closed': {
+        code: 'invalid_query',
+        ru: 'подключение закрыто (db.close()) — откройте новое connect()',
+        hint: 'db.close() — в конце работы процесса; цепочки, db.as() и db.begin() закрытого подключения не работают — для новой работы const db = await connect({ … })',
     },
     'api.nested_begin': {
         code: 'invalid_query',

package/dist/messages/boot.d.ts

@@ -64,6 +64,11 @@ export declare const boot: {
         ru: string;
         hint: string;
     };
+    'boot.login_grant_denied': {
+        code: "invalid_data";
+        ru: string;
+        hint: string;
+    };
     'boot.tenant_name_required': {
         code: "invalid_data";
         ru: string;

package/dist/messages/boot.js

@@ -83,6 +83,13 @@ export const boot = {
         ru: 'up({ login }): роль {user} — привилегированная (суперпользователь, CREATEROLE, CREATEDB, REPLICATION, BYPASSRLS, роль-владелец или её член) или сама роль приложения: роль приложения — обычная роль входа, привилегированную up() не трогает',
         hint: 'выбрать для login другое имя — роль без этих атрибутов и без членства в роли владельца',
     },
+    // up.ts, ensureLogin (3.0.1): установщик не может выдать роль приложения (PostgreSQL 16+: нужен ADMIN OPTION, SQLSTATE
+    // 42501 «permission denied to grant role»); app — роль приложения, installer — роль установщика (current_user)
+    'boot.login_grant_denied': {
+        code: 'invalid_data',
+        ru: 'up({ login }): роль {installer} не может выдать роль {app} роли {user} — нужен ADMIN OPTION на роль {app} (grant {app} to {installer} with admin option) или суперпользователь',
+        hint: 'выполнить от суперпользователя grant <роль приложения> to <установщик> with admin option (имена — в тексте ошибки) и повторить up({ login }) — или ставить от суперпользователя',
+    },
     // up.ts, createTenant() и up({ tenant }): нет имени арендатора
     'boot.tenant_name_required': {
         code: 'invalid_data',

package/dist/messages/codes.js

@@ -91,8 +91,8 @@ export const codes = {
     },
     'codes.conflict': {
         code: 'conflict',
-        ru: 'то, что вы видели, уже изменилось — ничего не записано: `update` с `{ rev }` (строку изменили после чтения, `write.rev_conflict`), `delete({ confirm: true, expect })` (превью изменилось, `write.preview_changed`; в том числе цели уже удалены или не найдены — `detail.preview: []`), `restore({ expect })` (объект меняли после удаления, `write.restore_stale`)',
-        hint: 'перечитать и повторить с новыми данными: `update` — с новым `rev` (для чисел — `inc` вместо записи итога); `delete` — показать новое превью `err.detail.preview` и удалить с ним; `restore` — сообщить пользователю (вещь уже у другого) или `restore({ expect, partial: true })`',
+        ru: 'то, что вы видели, уже изменилось — ничего не записано: `update` с `{ rev }` (строку изменили после чтения, `write.rev_conflict`), `delete({ confirm: true, expect })` (предпросмотр изменился, `write.preview_changed`; в том числе цели уже удалены или не найдены — `detail.preview: []`), `restore({ expect })` (объект меняли после удаления, `write.restore_stale`)',
+        hint: 'перечитать и повторить с новыми данными: `update` — с новым `rev` (для чисел — `inc` вместо записи итога); `delete` — показать новый предпросмотр `err.detail.preview` и удалить с ним; `restore` — сообщить пользователю (вещь уже у другого) или `restore({ expect, partial: true })`',
     },
     'codes.rev_ambiguous': {
         code: 'rev_ambiguous',

package/dist/messages/log.d.ts

@@ -39,9 +39,12 @@ export interface LogEventInfo {
     ru: string;
 }
 /**
- * Каталог событий логирования. Имена основных событий зафиксированы спецификацией 3.0 (connect, close, up, migrate,
- * sync, read, cache.hit, cache.miss, write, delete.preview, delete, restore, tx.*, auth.login, auth.logout, auth.revoke,
- * auth.switch, watch.start, watch.stop, signal, maintain, warning, error, sql); остальные — дополнительные.
+ * Каталог событий логирования — объект (не массив): имя события → `{ level, ru }`, где `level` — уровень события по
+ * умолчанию (`debug`, `info`, `warn`, `error`), `ru` — что значит событие. Тип — `Readonly<Record<LogEventName,
+ * LogEventInfo>>`: `LOG_EVENTS.write.level` — `'info'`, список имён — `Object.keys(LOG_EVENTS)`. Основные события:
+ * connect, close, up, migrate, sync, read, cache.hit, cache.miss, write, delete.preview, delete, restore, tx.*,
+ * auth.login, auth.logout, auth.revoke, auth.switch, watch.start, watch.stop, signal, maintain, warning, error, sql;
+ * остальные — дополнительные.
  */
 export declare const LOG_EVENTS: {
     readonly connect: {
@@ -98,11 +101,11 @@ export declare const LOG_EVENTS: {
     };
     readonly write: {
         readonly level: "info";
-        readonly ru: "запись цепочкой (create, update, upsert, слоты) или батч";
+        readonly ru: "запись цепочкой (create, update, upsert, шаги ролей) или батч";
     };
     readonly 'delete.preview': {
         readonly level: "debug";
-        readonly ru: "превью удаления: delete() без confirm, ничего не удалено";
+        readonly ru: "предпросмотр удаления: delete() без confirm, ничего не удалено";
     };
     readonly delete: {
         readonly level: "info";

package/dist/messages/log.js

@@ -40,9 +40,12 @@ export const log = {
     },
 };
 /**
- * Каталог событий логирования. Имена основных событий зафиксированы спецификацией 3.0 (connect, close, up, migrate,
- * sync, read, cache.hit, cache.miss, write, delete.preview, delete, restore, tx.*, auth.login, auth.logout, auth.revoke,
- * auth.switch, watch.start, watch.stop, signal, maintain, warning, error, sql); остальные — дополнительные.
+ * Каталог событий логирования — объект (не массив): имя события → `{ level, ru }`, где `level` — уровень события по
+ * умолчанию (`debug`, `info`, `warn`, `error`), `ru` — что значит событие. Тип — `Readonly<Record<LogEventName,
+ * LogEventInfo>>`: `LOG_EVENTS.write.level` — `'info'`, список имён — `Object.keys(LOG_EVENTS)`. Основные события:
+ * connect, close, up, migrate, sync, read, cache.hit, cache.miss, write, delete.preview, delete, restore, tx.*,
+ * auth.login, auth.logout, auth.revoke, auth.switch, watch.start, watch.stop, signal, maintain, warning, error, sql;
+ * остальные — дополнительные.
  */
 export const LOG_EVENTS = {
     // подключение
@@ -62,8 +65,8 @@ export const LOG_EVENTS = {
     'cache.miss': { level: 'debug', ru: 'ответа нет в кэше результатов — запрос к базе' },
     'raw': { level: 'debug', ru: 'сырой SQL db.sql' },
     // запись
-    'write': { level: 'info', ru: 'запись цепочкой (create, update, upsert, слоты) или батч' },
-    'delete.preview': { level: 'debug', ru: 'превью удаления: delete() без confirm, ничего не удалено' },
+    'write': { level: 'info', ru: 'запись цепочкой (create, update, upsert, шаги ролей) или батч' },
+    'delete.preview': { level: 'debug', ru: 'предпросмотр удаления: delete() без confirm, ничего не удалено' },
     'delete': { level: 'info', ru: 'удаление выполнено: состав каскада, сверка с expect' },
     'restore': { level: 'info', ru: 'восстановление выполнено: восстановленные и пропущенные цели' },
     'load': { level: 'info', ru: 'db.load(): массовая загрузка завершена' },