letopis 1.4.1 → 2.0.0

package/dist/signals.d.ts

@@ -2,14 +2,10 @@ export type SignalMode = 'class' | 'tenant' | 'opaque' | 'none';
 export declare const SIGNAL_MODES: readonly SignalMode[];
 /** Разобранный сигнал. */
 export type Signal = 
-/** `*` — сброс: кэш, пропуска прав, реестр и ключ — заново. */
+/** Слушатель сигналов (пере)подключился — сигналы за время обрыва потеряны: кэш, пропуска прав, реестр и ключ — заново. */
 {
     kind: 'all';
 }
-/** `session:*` — все сессии. */
- | {
-    kind: 'sessions';
-}
 /** `session:<тег>` — погашенная сессия (тег — начало sha256 токена). */
  | {
     kind: 'session';
@@ -57,10 +53,6 @@ export declare class Signals {
     /** Разобрать нагрузку сигнала или элемент letopis.changed своей транзакции. */
     parse(p: string): Signal;
 }
-/**
- * Не чаще раза в ms: первый вызов — сразу, вызовы внутри окна — один раз в его конце. Так заливка
- * канала сигналами (в том числе поддельными) не превращается в поток перечитываний реестра.
- */
 /**
  * Ведро жетонов: count вызовов подряд — сразу, дальше не чаще раза в ms (жетон возвращается раз в ms); вызовы
  * в ожидании сливаются в один. Короткая серия проходит без задержки, заливка — с заданной частотой.
@@ -68,6 +60,10 @@ export declare class Signals {
 export declare function bucket(fn: () => void, count: number, ms: number): (() => void) & {
     stop(): void;
 };
+/**
+ * Не чаще раза в ms: первый вызов — сразу, вызовы внутри окна — один раз в его конце. Так заливка
+ * канала сигналами (в том числе поддельными) не превращается в поток перечитываний реестра.
+ */
 export declare function throttle(fn: () => void, ms: number): (() => void) & {
     stop(): void;
 };

package/dist/signals.js

@@ -4,7 +4,7 @@
  * Канал — имя схемы; нагрузку строит функция базы signal() по режиму up({ signals }):
  *   - class — `Booking` (как в 1.0); tenant — `Booking@<токен арендатора>`;
  *   - opaque — `<токен класса>@<токен арендатора>`; none — сигналов нет;
- *   - сессии — `session:<16 hex>` и `session:*`, сброс — `*` (кроме none).
+ *   - погашенная сессия — `session:<16 hex>` (кроме none).
  * Токен — первые 96 бит HMAC-SHA256 от «назначение:значение» на ключе сигналов (signal_key(): HMAC
  * ключа строки KEY по 'letopis:signals'), 24 строчных шестнадцатеричных знака. Имя класса не содержит
  * `@`, `:` и `*` (метасхема Class), поэтому нагрузка разбирается однозначно.
@@ -77,10 +77,6 @@ export class Signals {
     }
     /** Разобрать нагрузку сигнала или элемент letopis.changed своей транзакции. */
     parse(p) {
-        if (p === '*')
-            return { kind: 'all' };
-        if (p === 'session:*')
-            return { kind: 'sessions' };
         if (p.startsWith('session:'))
             return /^session:[0-9a-f]{16}$/.test(p) ? { kind: 'session', tag: p.slice(8) } : { kind: 'foreign' };
         const at = p.indexOf('@');
@@ -104,10 +100,6 @@ export class Signals {
         return cls ? { kind: 'class', cls, tenant } : { kind: 'unknown', tenant };
     }
 }
-/**
- * Не чаще раза в ms: первый вызов — сразу, вызовы внутри окна — один раз в его конце. Так заливка
- * канала сигналами (в том числе поддельными) не превращается в поток перечитываний реестра.
- */
 /**
  * Ведро жетонов: count вызовов подряд — сразу, дальше не чаще раза в ms (жетон возвращается раз в ms); вызовы
  * в ожидании сливаются в один. Короткая серия проходит без задержки, заливка — с заданной частотой.
@@ -140,6 +132,10 @@ export function bucket(fn, count, ms) {
         },
     });
 }
+/**
+ * Не чаще раза в ms: первый вызов — сразу, вызовы внутри окна — один раз в его конце. Так заливка
+ * канала сигналами (в том числе поддельными) не превращается в поток перечитываний реестра.
+ */
 export function throttle(fn, ms) {
     let last = -Infinity;
     let timer = null;

package/dist/sql.d.ts

@@ -1,5 +1,5 @@
 import type { ClassInfo, LeafType, Registry } from './registry.js';
-import { type ChainMods, type Cursor, type Filter, type Row } from './types.js';
+import { type ChainMods, type Cursor, type Filter, type Path, type Row } from './types.js';
 export interface Step {
     /** Имя, как вызвано в цепочке (класс, алиас или роль). */
     name: string;
@@ -29,7 +29,7 @@ export interface Step {
 }
 /** Уникальная метка узла пути. */
 export declare const nextNodeKey: () => number;
-export type ReadMode = 'paths' | 'rows' | 'ids' | 'count' | 'countPaths' | 'versions' | 'agg' | 'diff' | 'blame';
+export type ReadMode = 'paths' | 'rows' | 'ids' | 'count' | 'countPaths' | 'versions' | 'agg';
 export interface AggSpec {
     fn: 'sum' | 'avg' | 'min' | 'max' | 'countBy';
     field: string;
@@ -37,7 +37,7 @@ export interface AggSpec {
 export interface BuiltQuery {
     text: string;
     params: unknown[];
-    /** Ключи шагов в путях (алиасы, повторы — _2, _3). */
+    /** Ключи шагов в путях (алиасы, повторы — _2, _3) в порядке шагов; ключ узла последнего шага — последний. */
     keys: string[];
     /** Тип листа агрегата (min/max числового поля приводятся к числу). */
     aggLeaf?: LeafType;
@@ -48,6 +48,12 @@ export declare function roleOwners(reg: Registry, role: string): ClassInfo[];
 export declare function roleTargets(reg: Registry, role: string): string[];
 /** Конкретные классы, которые матчит шаг: класс (роль — её цели) и потомки, если не exact(). */
 export declare function stepClasses(reg: Registry, step: Step): string[];
+/**
+ * Отказы построителя, которым не нужны база и путь, — фильтр шага (в том числе неизвестное поле) и поле sort('data.…') или
+ * агрегата по классам шага: план записи проверяет их до первого оператора (write.ts:precheckPlan, §2.5), поэтому
+ * опечатка в фильтре цели не ломает db.begin(). Построитель при чтении проверяет то же самое ещё раз.
+ */
+export declare function precheckStep(reg: Registry, step: Step, order?: string, agg?: AggSpec): void;
 /** Принимает ли список классов конца класс cls (с учётом его предков). */
 export declare const accepts: (reg: Registry, targets: string[], cls: string) => boolean;
 export interface Hop {
@@ -63,10 +69,11 @@ export interface Hop {
  */
 export declare function resolveHop(reg: Registry, prev: Step, next: Step): Hop;
 /**
- * Курсор постраничного вывода для `after()`: `{ v, id }` — значение поля сортировки и id последней строки страницы.
- * Поле — то же, что в `sort()`; если его нет в данных строки, `v` — `null`.
+ * Курсор постраничного вывода для `after()`: значение поля сортировки, id и номер версии последней строки страницы.
+ * Поле — то же, что в `sort()`; если его нет в данных строки, `v` — `null`. Для пути из `paths()` — то же по его
+ * последнему узлу (узлу последнего шага) и id всех узлов: курсор отделяет пути с общим последним узлом.
  */
-export declare function cursorOf(row: Row, field: string): Cursor;
+export declare function cursorOf(row: Row | Path, field: string): Cursor;
 export interface BuildOptions {
     /**
      * Режим сверки (тест find-ids-parity): вместо функций владельца find_* — те же запросы прямо