letopis 0.13.0 → 0.18.0

package/dist/ops.js

@@ -2,6 +2,44 @@
  * Операторы фильтров. Symbol-tagged объекты — не пересекаются с данными.
  * Касты по типам полей делает sql.ts на основе Schema.attributes.
  */
+//
+// FILE: lib/src/ops.ts
+// VERSION: 1.0.0
+// START_MODULE_CONTRACT
+//   PURPOSE: Билдеры операторов фильтра, создающие узлы Op для DSL фильтров.
+//   SCOPE: type guard isOp + конструкторы операторов сравнения / списков / строк / массивов / наличия / логики (ne…or) поверх локальной фабрики op().
+//   DEPENDS: M-TYPES
+//   LINKS: M-OPS, V-M-OPS
+//   ROLE: RUNTIME
+//   MAP_MODE: EXPORTS
+// END_MODULE_CONTRACT
+//
+// START_MODULE_MAP
+//   op - (локальный) фабрика узла Op: { [OP]: name, args }.
+//   isOp - type guard: значение является узлом Op (содержит символ OP).
+//   ne - ≠ (IS DISTINCT FROM).
+//   gt - >.
+//   gte - ≥.
+//   lt - <.
+//   lte - ≤.
+//   between - a ≤ x ≤ b.
+//   inList - значение из списка (IN).
+//   like - LIKE (шаблон с % и _).
+//   ilike - ILIKE (без регистра).
+//   starts - начинается с (LIKE s%).
+//   ends - заканчивается на (LIKE %s).
+//   has - массив-поле содержит значение.
+//   hasAny - массив-поле содержит хотя бы одно из.
+//   hasAll - массив-поле содержит все.
+//   exists - поле присутствует (true) / отсутствует (false) в data.
+//   isNull - поле NULL или отсутствует.
+//   not - НЕ-условие по полю (скаляр → «не равно»).
+//   or - ИЛИ на уровне фильтра шага.
+// END_MODULE_MAP
+//
+// START_CHANGE_SUMMARY
+//   LAST_CHANGE: [v1.0.0 - Documented existing module: reverse-engineered contract + markup]
+// END_CHANGE_SUMMARY
 import { OP } from './types.js';
 const op = (name, ...args) => ({ [OP]: name, args });
 export const isOp = (v) => typeof v === 'object' && v !== null && OP in v;
@@ -39,5 +77,12 @@ export const exists = (yes = true) => op('exists', yes);
 export const isNull = () => op('isNull');
 /** НЕ-условие по полю: not(ilike('%тест%')); скаляр → «не равно» */
 export const not = (v) => op('not', v);
+// START_CONTRACT: or
+//   PURPOSE: Логическое ИЛИ на уровне фильтра шага — объединяет несколько фильтров-объектов в один узел Op.
+//   INPUTS: { filters: Record<string, unknown>[] - варьируемое число фильтров-объектов (каждый — свой набор условий) }
+//   OUTPUTS: { Op - узел { [OP]: 'or', args: [filters] } }
+//   SIDE_EFFECTS: none (чистая фабрика через op())
+//   LINKS: M-OPS, V-M-OPS
+// END_CONTRACT: or
 /** ИЛИ на уровне фильтра шага: db.Запись(or({status:'created'}, {status:'confirmed'})) */
 export const or = (...filters) => op('or', filters);

package/dist/schema.js

@@ -2,9 +2,32 @@
  * Загрузка таблицы Schema → реестр классов:
  *  - резолв имени по id и alias;
  *  - цепочка ancestors (walk по ancestor, если в БД не заполнена);
+ *  - attributes НАСЛЕДУЮТСЯ по цепочке (потомок поверх предка; поле = замена правила
+ *    целиком) — включая правило id (генерация v4/v5/v7); links НЕ наследуются;
  *  - скомпилированный fastest-validator per class;
  *  - карта типов полей (для SQL-кастов фильтров).
  */
+//
+// FILE: lib/src/schema.ts
+// VERSION: 1.0.0
+// START_MODULE_CONTRACT
+//   PURPOSE: Строит реестр классов из таблицы Schema — резолв наследования/link-ends, типы полей, компиляция валидаторов.
+//   SCOPE: Registry (add/find/resolve/has), loadRegistry, fieldTypeOf; локальные parseEnd/parseIdGen/buildDef.
+//   DEPENDS: M-TYPES
+//   LINKS: M-SCHEMA, V-M-SCHEMA
+//   ROLE: RUNTIME
+//   MAP_MODE: EXPORTS
+// END_MODULE_CONTRACT
+//
+// START_MODULE_MAP
+//   Registry - реестр классов (add/find/resolve/has, all)
+//   fieldTypeOf - attribute-спека fastest-validator → FieldType (для SQL-кастов)
+//   loadRegistry - загрузка Schema-строк партиции → Registry со скомпилированными check
+// END_MODULE_MAP
+//
+// START_CHANGE_SUMMARY
+//   LAST_CHANGE: [v1.0.0 - Documented existing module: reverse-engineered contract + markup]
+// END_CHANGE_SUMMARY
 import { createRequire } from 'node:module';
 const Validator = createRequire(import.meta.url)('fastest-validator');
 const v = new Validator({ useNewCustomCheckerFunction: true });
@@ -20,6 +43,13 @@ export class Registry {
     find(name) {
         return this.byName.get(name);
     }
+    // START_CONTRACT: Registry.resolve
+    //   PURPOSE: Вернуть класс по id или alias, иначе бросить ошибку со списком известных.
+    //   INPUTS: { name: string - id или alias класса }
+    //   OUTPUTS: { ClassDef - найденный класс }
+    //   SIDE_EFFECTS: none
+    //   LINKS: M-SCHEMA, V-M-SCHEMA
+    // END_CONTRACT: Registry.resolve
     /** Класс по id или alias; иначе понятная ошибка со списком. */
     resolve(name) {
         const def = this.byName.get(name);
@@ -33,6 +63,13 @@ export class Registry {
         return this.byName.has(name);
     }
 }
+// START_CONTRACT: fieldTypeOf
+//   PURPOSE: Свести attribute-спеку fastest-validator (строка/массив/объект) к FieldType.
+//   INPUTS: { attr: unknown - правило поля из attributes }
+//   OUTPUTS: { FieldType - вид поля (number/date/boolean/string/array/record/object/any) }
+//   SIDE_EFFECTS: none (рекурсивно по вложенным props/value)
+//   LINKS: M-SCHEMA, V-M-SCHEMA, type-FieldType
+// END_CONTRACT: fieldTypeOf
 /** Тип поля из fastest-validator DSL — для каста в SQL. */
 export function fieldTypeOf(attr) {
     if (typeof attr === 'string') {
@@ -88,7 +125,84 @@ export function fieldTypeOf(attr) {
     }
     return { kind: 'any' };
 }
+/**
+ * Элемент Schema.links: объект-конец v2 (jsonb) либо legacy-строка 'Org'
+ * (включая JSON-текст в text[] у старых схем). Возвращает [конец, isV2].
+ */
+// START_CONTRACT: parseEnd
+//   PURPOSE: Разобрать один элемент Schema.links в LinkEnd (объект-конец v2 или legacy-строка).
+//   INPUTS: { cls: string - id класса; raw: string|object - сырой конец из jsonb/text[] }
+//   OUTPUTS: { [LinkEnd, boolean] - конец и признак v2-формы (для strictEnds) }
+//   SIDE_EFFECTS: none
+//   ERRORS: malformed link end (bad JSON); link end without classes
+//   LINKS: M-SCHEMA, V-M-SCHEMA
+// END_CONTRACT: parseEnd
+function parseEnd(cls, raw) {
+    let o;
+    if (typeof raw === 'string') {
+        if (!raw.trimStart().startsWith('{'))
+            return [{ classes: [raw] }, false];
+        try {
+            o = JSON.parse(raw);
+        }
+        catch {
+            throw new Error(`letopis: class "${cls}" has malformed link end (bad JSON): ${raw}`);
+        }
+    }
+    else {
+        o = raw;
+    }
+    const classes = o.classes ?? (o.class ? [o.class] : []);
+    if (!classes.length || classes.some((c) => typeof c !== 'string' || !c)) {
+        throw new Error(`letopis: class "${cls}" has link end without classes: ${JSON.stringify(raw)}`);
+    }
+    return [{ classes, optional: o.optional === true, cardinality: o.cardinality }, true];
+}
+/**
+ * attributes.id: правило валидации + (объектом) спецификация генерации.
+ * generate/from — ключи letopis, вырезаются из правила перед компиляцией валидатора.
+ */
+// START_CONTRACT: parseIdGen
+//   PURPOSE: Отделить спецификацию генерации id (generate/from) от правила валидации attributes.id.
+//   INPUTS: { cls: string - id класса; attributes: object - слитые attributes класса }
+//   OUTPUTS: { { idGen: IdGen; attrs: object } - версия генерации id и очищенное правило }
+//   SIDE_EFFECTS: none
+//   ERRORS: generate must be 4|5|7; generate:5 needs "from"; from is for generate:5 only
+//   LINKS: M-SCHEMA, V-M-SCHEMA
+// END_CONTRACT: parseIdGen
+function parseIdGen(cls, attributes) {
+    const raw = attributes.id;
+    if (raw === null || typeof raw !== 'object' || Array.isArray(raw)) {
+        return { idGen: { version: 4 }, attrs: attributes };
+    }
+    const { generate, from, ...rule } = raw;
+    const attrs = { ...attributes, id: rule };
+    if (generate === undefined)
+        return { idGen: { version: 4 }, attrs };
+    if (generate !== 4 && generate !== 5 && generate !== 7) {
+        throw new Error(`letopis: class "${cls}" — attributes.id.generate must be 4 | 5 | 7, got ${JSON.stringify(generate)}`);
+    }
+    if (generate === 5) {
+        if (!Array.isArray(from) || !from.length || from.some((f) => typeof f !== 'string' || !f)) {
+            throw new Error(`letopis: class "${cls}" — id generate:5 needs "from": non-empty string[] (link ends / data fields)`);
+        }
+        return { idGen: { version: 5, from: from }, attrs };
+    }
+    if (from !== undefined) {
+        throw new Error(`letopis: class "${cls}" — attributes.id.from is for generate:5 only`);
+    }
+    return { idGen: { version: generate }, attrs };
+}
+// START_CONTRACT: buildDef
+//   PURPOSE: Собрать ClassDef из строки Schema — цепочка ancestors, наследование attributes, id-gen, компиляция check, типы полей, link-ends.
+//   INPUTS: { row: SchemaRow - строка класса; byId: Map<string,SchemaRow> - все классы партиции }
+//   OUTPUTS: { ClassDef - полностью разрешённое определение класса }
+//   SIDE_EFFECTS: none (компилирует fastest-validator)
+//   ERRORS: id v5 can't depend on optional end; id "from" source is neither end nor field
+//   LINKS: M-SCHEMA, V-M-SCHEMA, type-ClassDef
+// END_CONTRACT: buildDef
 function buildDef(row, byId) {
+    // START_BLOCK_INHERIT_ANCESTORS
     // цепочка наследования: из БД или walk по ancestor
     let ancestors = row.ancestors ?? [];
     if (!ancestors.length) {
@@ -101,18 +215,57 @@ function buildDef(row, byId) {
             cur = byId.get(cur)?.ancestor ?? null;
         }
     }
+    // attributes НАСЛЕДУЮТСЯ по цепочке ancestor: потомок ПОВЕРХ предка, переопределение
+    // поля — замена правила ЦЕЛИКОМ (не слияние объекта-правила). links не наследуются.
+    const merged = {};
+    for (let i = ancestors.length - 1; i >= 0; i--) {
+        Object.assign(merged, byId.get(ancestors[i])?.attributes ?? {});
+    }
+    // END_BLOCK_INHERIT_ANCESTORS
+    // attributes.id: спецификация генерации (generate/from) отделяется от правила валидации
+    const { idGen, attrs } = parseIdGen(row.id, merged);
     // fastest-validator: валидируем {id, ...data}; СТРОГО — лишние поля запрещены
-    const compiled = v.compile({ ...row.attributes, $$strict: true });
+    const compiled = v.compile({ ...attrs, $$strict: true });
     const check = (data) => {
         const res = compiled(data);
         return res === true ? true : res;
     };
     const fieldTypes = new Map();
-    for (const [field, attr] of Object.entries(row.attributes)) {
+    for (const [field, attr] of Object.entries(attrs)) {
         if (field.startsWith('$$'))
             continue;
         fieldTypes.set(field, fieldTypeOf(attr));
     }
+    let strictEnds = false;
+    // jsonb-массив; text[] у legacy-схем даёт string[]; jsonb-строка "[…]" (двойная
+    // сериализация внешних писателей) — распарсить
+    let rawLinks = row.links ?? [];
+    if (typeof rawLinks === 'string')
+        rawLinks = JSON.parse(rawLinks);
+    const ends = rawLinks.map((raw) => {
+        const [end, v2] = parseEnd(row.id, raw);
+        if (v2)
+            strictEnds = true;
+        return end;
+    });
+    // START_BLOCK_ID_V5_VALIDATE
+    // id v5: каждый источник from — обязательный конец links (класс или полное имя союза
+    // 'Service|Complex') ЛИБО поле data
+    if (idGen.version === 5) {
+        for (const f of idGen.from) {
+            const end = ends.find((e) => e.classes.includes(f) || e.classes.join('|') === f);
+            if (end) {
+                if (end.optional) {
+                    throw new Error(`letopis: class "${row.id}" — id (uuid v5) can't depend on optional end "${f}"`);
+                }
+                continue;
+            }
+            if (f !== 'id' && f in attrs)
+                continue;
+            throw new Error(`letopis: class "${row.id}" — id "from" source "${f}" is neither a link end nor a data field`);
+        }
+    }
+    // END_BLOCK_ID_V5_VALIDATE
     return {
         id: row.id,
         alias: row.alias,
@@ -120,8 +273,10 @@ function buildDef(row, byId) {
         ancestor: row.ancestor,
         ancestors,
         descendants: row.descendants ?? [], // считает триггер schema_lineage
-        attributes: row.attributes,
-        links: row.links ?? [],
+        attributes: merged,
+        links: ends,
+        strictEnds,
+        idGen,
         meta: row.meta ?? {},
         abstract: row.meta?.abstract === true || row.meta?.abstract === 'true',
         order: row.order,
@@ -129,13 +284,23 @@ function buildDef(row, byId) {
         fieldTypes,
     };
 }
+// START_CONTRACT: loadRegistry
+//   PURPOSE: Прочитать классы партиции из таблицы Schema и построить Registry со скомпилированными check.
+//   INPUTS: { sql: postgres.Sql; pgSchema: string; partition: string }
+//   OUTPUTS: { Promise<Registry> - реестр всех классов партиции }
+//   SIDE_EFFECTS: SELECT из "<pgSchema>"."Schema"
+//   ERRORS: schema has no classes for partition
+//   LINKS: M-SCHEMA, V-M-SCHEMA, M-DDL
+// END_CONTRACT: loadRegistry
 export async function loadRegistry(sql, pgSchema, partition) {
+    // START_BLOCK_LOAD_QUERY
     const ident = `"${pgSchema.replace(/"/g, '""')}"`;
     const rows = (await sql.unsafe(`SELECT id, alias, category, ancestor, attributes, links, meta, "order", ancestors, descendants
        FROM ${ident}."Schema" WHERE partition = $1 ORDER BY category, "order"`, [partition]));
     if (!rows.length) {
         throw new Error(`letopis: schema "${pgSchema}" has no classes for partition "${partition}"`);
     }
+    // END_BLOCK_LOAD_QUERY
     const byId = new Map(rows.map((r) => [r.id, r]));
     const registry = new Registry();
     for (const row of rows)

package/dist/sessions.js

@@ -3,16 +3,56 @@
  * Клиент НЕ входит в зависимости — инжектируется пользователем (интерфейс ioredis-совместим).
  * В store лежит только sha256-хэш токена: дамп Redis не раскрывает действующие токены.
  */
+//
+// FILE: lib/src/sessions.ts
+// VERSION: 1.0.0
+// START_MODULE_CONTRACT
+//   PURPOSE: Жизненный цикл сессий поверх инжектируемого Redis-совместимого хранилища (start/check/revoke/revokeAll).
+//   SCOPE: интерфейсы SessionStore/Session/Sessions + фабрика makeSessions с операциями старта, проверки и отзыва сессий; токены хранятся как sha256 под ключами sess:* / sess:acc:* с TTL.
+//   DEPENDS: none
+//   LINKS: M-SESSIONS, V-M-SESSIONS
+//   ROLE: RUNTIME
+//   MAP_MODE: EXPORTS
+// END_MODULE_CONTRACT
+//
+// START_MODULE_MAP
+//   SessionStore - минимальный срез Redis-клиента (set/get/del/sadd/srem/smembers/expire).
+//   Session - полезная нагрузка сессии: account, meta, created.
+//   Sessions - контракт сервиса сессий: start/check/revoke/revokeAll.
+//   sha256 - (локальный) hex-хэш строки по sha256.
+//   accId - (локальный) нормализует account: string | { id } → id.
+//   DEFAULT_TTL - (локальный) TTL по умолчанию: 7 суток в секундах.
+//   makeSessions - фабрика: связывает store и возвращает объект Sessions.
+// END_MODULE_MAP
+//
+// START_CHANGE_SUMMARY
+//   LAST_CHANGE: [v1.0.0 - Documented existing module: reverse-engineered contract + markup]
+// END_CHANGE_SUMMARY
 import { createHash, randomBytes } from 'node:crypto';
 const sha256 = (s) => createHash('sha256').update(s).digest('hex');
 const accId = (a) => (typeof a === 'object' ? a.id : a);
 const DEFAULT_TTL = 7 * 24 * 3600;
+// START_CONTRACT: makeSessions
+//   PURPOSE: Фабрика сервиса сессий: связывает инжектируемый store и возвращает объект Sessions.
+//   INPUTS: { store: SessionStore - Redis-совместимое хранилище (инжектируется пользователем) }
+//   OUTPUTS: { Sessions - объект с методами start/check/revoke/revokeAll }
+//   SIDE_EFFECTS: none при создании; возвращённые методы читают/пишут store (ключи sess:* / sess:acc:*)
+//   LINKS: M-SESSIONS, V-M-SESSIONS
+// END_CONTRACT: makeSessions
 export function makeSessions(store) {
     const kTok = (h) => `sess:${h}`;
     // индекс аккаунта без TTL: протухшие хэши безвредны, полная чистка — revokeAll
     const kAcc = (id) => `sess:acc:${id}`;
     return {
+        // START_CONTRACT: start
+        //   PURPOSE: Создать новую сессию и вернуть одноразовый токен (в store — только его sha256).
+        //   INPUTS: { account: string | { id: string } - аккаунт, opts?: { ttlSec?: number; meta?: Record<string, unknown> } - TTL (default 7 суток) и метаданные }
+        //   OUTPUTS: { Promise<string> - секретный токен (32 байта hex, отдаётся один раз) }
+        //   SIDE_EFFECTS: store.set(sess:<h>, payload, EX ttl) + store.sadd(sess:acc:<id>, h)
+        //   LINKS: M-SESSIONS, V-M-SESSIONS
+        // END_CONTRACT: start
         async start(account, opts = {}) {
+            // START_BLOCK_START_MINT_AND_PERSIST
             const id = accId(account);
             const token = randomBytes(32).toString('hex');
             const h = sha256(token);
@@ -20,13 +60,29 @@ export function makeSessions(store) {
             const payload = { account: id, meta: opts.meta ?? {}, created: new Date().toISOString() };
             await store.set(kTok(h), JSON.stringify(payload), 'EX', ttl);
             await store.sadd(kAcc(id), h);
+            // END_BLOCK_START_MINT_AND_PERSIST
             return token;
         },
+        // START_CONTRACT: check
+        //   PURPOSE: Проверить токен и вернуть данные сессии либо null.
+        //   INPUTS: { token: string - секретный токен }
+        //   OUTPUTS: { Promise<Session | null> - null = нет / просрочена / отозвана }
+        //   SIDE_EFFECTS: store.get(sess:<sha256(token)>) (только чтение)
+        //   LINKS: M-SESSIONS, V-M-SESSIONS
+        // END_CONTRACT: check
         async check(token) {
             const raw = await store.get(kTok(sha256(token)));
             return raw ? JSON.parse(raw) : null;
         },
+        // START_CONTRACT: revoke
+        //   PURPOSE: Отозвать одну сессию по токену.
+        //   INPUTS: { token: string - секретный токен }
+        //   OUTPUTS: { Promise<boolean> - true если сессия была и удалена, false если её нет }
+        //   SIDE_EFFECTS: store.del(sess:<h>) + store.srem(sess:acc:<account>, h)
+        //   LINKS: M-SESSIONS, V-M-SESSIONS
+        // END_CONTRACT: revoke
         async revoke(token) {
+            // START_BLOCK_REVOKE_LOOKUP_AND_DELETE
             const h = sha256(token);
             const raw = await store.get(kTok(h));
             if (!raw)
@@ -35,14 +91,24 @@ export function makeSessions(store) {
             await store.del(kTok(h));
             await store.srem(kAcc(account), h);
             return true;
+            // END_BLOCK_REVOKE_LOOKUP_AND_DELETE
         },
+        // START_CONTRACT: revokeAll
+        //   PURPOSE: Погасить все сессии аккаунта и очистить его индекс.
+        //   INPUTS: { account: string | { id: string } - аккаунт }
+        //   OUTPUTS: { Promise<number> - сколько хэшей было в индексе аккаунта }
+        //   SIDE_EFFECTS: store.del(все sess:<h>) + store.del(sess:acc:<id>)
+        //   LINKS: M-SESSIONS, V-M-SESSIONS
+        // END_CONTRACT: revokeAll
         async revokeAll(account) {
+            // START_BLOCK_REVOKE_ALL_PURGE
             const id = accId(account);
             const hs = await store.smembers(kAcc(id));
             if (hs.length)
                 await store.del(...hs.map(kTok));
             await store.del(kAcc(id));
             return hs.length;
+            // END_BLOCK_REVOKE_ALL_PURGE
         },
     };
 }

package/dist/sql.d.ts

@@ -55,11 +55,25 @@ export declare const retryDelay: (attempt: number) => Promise<void>;
  * Служебные запросы (loadRegistry, tables, listen) через неё не идут.
  */
 export declare function runQuery<T>(ctx: Ctx, text: string, params: unknown[], mode: QueryEvent['mode'], classes: string[]): Promise<T[]>;
+/** Значение слота связи: id | вложенный план | null (снять конец). */
+export type SlotValue = string | {
+    plan: Step[];
+    mods?: ChainMods;
+} | null;
+/** Уникальная метка узла пути (для pivot-возвратов; переживает нарезку плана). */
+export declare const nextNodeKey: () => number;
 export interface Step {
     /** Имя, как вызвано в цепочке (алиас или id). */
     name: string;
     cls: ClassDef;
     filter?: Filter;
+    /** Метка узла (есть у каждого реального шага). */
+    nodeKey?: number;
+    /**
+     * Pivot: шаг-ВОЗВРАТ к уже введённому узлу (повтор LINK-класса / entity(та же переменная)).
+     * Не создаёт узел; его фильтры дофильтровывают узел (AND); следующий шаг ветвится от узла.
+     */
+    pivotKey?: number;
     /** .alias(name) — ключ шага в путях. */
     aliasKey?: string;
     /** .tags(…) — фильтр по колонке tags: строка | string[] (все) | has/hasAny/hasAll. */
@@ -70,13 +84,17 @@ export interface Step {
     ownerFilter?: string;
     /** Внутреннее (write-цепочки): containment по links — контекст-связи. */
     linksFilter?: Record<string, string>;
-    /** .link(Класс, target) — значение связи при записи БЕЗ участия в фильтре целей. */
-    extraLinks?: Record<string, string>;
+    /**
+     * Слоты связей (`.Класс.set(target)` / `.Класс.unset()`): значения концов записываемой
+     * версии БЕЗ участия в фильтре целей. string — id; {plan} — вложенная цепочка (та же
+     * транзакция, ровно одна сущность класса конца); null — снять optional-конец.
+     */
+    extraLinks?: Record<string, SlotValue>;
     /** Внутреннее (enforceAcl): предикат WRITE/DELETE-правила — цели ищутся только среди своих. */
     aclFilter?: Record<string, unknown>;
     /** .deep(max): рекурсивный self-обход (дети любой глубины), только reverse того же класса. */
     deepMax?: number;
-    /** Операция записи на шаге (.set/.delete/.anonymize) — исполняется терминалом плана. */
+    /** Операция записи на шаге (.create/.update/.delete/.anonymize) — исполняется терминалом плана. */
     op?: import('./types.js').PlanOp;
     /** Внутреннее: шаг «те же сущности» (операция сразу после операции) — цель = строки старта. */
     self?: boolean;
@@ -85,6 +103,8 @@ export declare const entityTable: (pgSchema: string) => string;
 /** Тип листа data-пути по Schema: спуск через record (значение) и object (props). */
 export declare function leafType(cls: ClassDef, path: string[]): FieldType | undefined;
 type HopMode = 'forward' | 'reverse';
+/** Класс target входит в какой-нибудь конец def (союзы учитываются). */
+export declare function linksTo(def: ClassDef, target: string): boolean;
 /** Правило обхода между шагами (по реестру Schema). */
 export declare function resolveHop(prev: ClassDef, next: ClassDef): HopMode;
 export type ReadMode = 'paths' | 'rows' | 'ids' | 'count' | 'versions' | 'agg';