letopis 1.4.2 → 3.0.0

package/dist/registry.js

@@ -3,19 +3,8 @@
  * (собственные классы арендатора и системные), поиск по имени и алиасу, предки и потомки,
  * типы листьев для фильтров и валидатор на TypeScript, скомпилированный из того же описания.
  */
-import { LetopisError } from './errors.js';
+import { lerr } from './errors.js';
 import { compileValidator } from './validate.js';
-/** Агрегатные поля класса: их считает база (план 1.1, §2.4). */
-export const aggregateFields = (cls) => Object.keys(cls.aggregate ?? {});
-/** Описание агрегатов из resolved — без скомпилированного условия (match): оно для базы. */
-function aggregateOf(agg) {
-    return Object.fromEntries(Object.entries(agg).map(([field, d]) => [field, {
-            ...(typeof d.sum === 'string' ? { sum: d.sum } : { count: true }),
-            of: d.of,
-            via: d.via,
-            ...(d.where && typeof d.where === 'object' ? { where: d.where } : {}),
-        }]));
-}
 export class Registry {
     byName = new Map();
     byAlias = new Map();
@@ -37,12 +26,10 @@ export class Registry {
                 schema: res.schema,
                 ends: (res.ends ?? {}),
                 key: (res.key ?? []),
-                history: res.history,
+                history: res.history !== false,
                 ownerDefault: (res.ownerDefault ?? 'tenant'),
                 cache: (res.cache ?? undefined),
                 meta: (res.meta ?? {}),
-                ...(typeof res.derivedBy === 'string' ? { derivedBy: res.derivedBy } : {}),
-                ...(res.aggregate && typeof res.aggregate === 'object' ? { aggregate: aggregateOf(res.aggregate) } : {}),
                 validator: () => (compiled ??= compileValidator(res.schema)),
             };
             this.byName.set(info.name, info);
@@ -59,7 +46,7 @@ export class Registry {
     resolve(name) {
         const c = this.find(name);
         if (!c)
-            throw new LetopisError('invalid_class', `класс ${name} не найден`);
+            throw lerr('model.class_not_found', { name });
         return c;
     }
     all() {

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';

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('@');

package/dist/sql.d.ts

@@ -18,6 +18,8 @@ export interface Step {
     tagsFilter?: unknown;
     ownerFilter?: string;
     deepMax?: number;
+    /** withDeleted(): узел шага — живые и надгробия удалённых (модификатор шага, план 2.1, A9). */
+    withDeleted?: true;
     /** Звено плана записи (этап 4): глагол на этом шаге; построитель чтения его не видит. */
     op?: import('./write.js').PlanOp;
     /** Модификаторы цепочки на момент глагола: limit и sort сужают цели записи. */
@@ -29,7 +31,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;
@@ -48,6 +50,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 {