letopis 0.20.3 → 1.0.0

package/dist/types.d.ts

@@ -1,290 +1,111 @@
 /**
- * letopis: типы.
+ * Общие типы letopis 1.0. Файл наполняется по этапам плана (reports/PLAN-LETOPIS-1.0.md).
  */
-/** Строка Entity (актуальная версия), как отдаёт либа. account/owner — NOT NULL. */
-export interface Row {
+/** Ревизия движка в базе: штамп в lib/sql/99-revision.sql должен совпадать (этап 1). */
+export declare const DDL_REVISION = 5;
+/** Методы цепочки: терминалы, модификаторы, глаголы записи (этап 4), охранники снесённого API. */
+export declare const CHAIN_METHODS: readonly ["then", "entity", "paths", "rows", "first", "ids", "count", "limit", "offset", "sort", "asOf", "withDeleted", "deep", "exact", "sum", "avg", "min", "max", "countBy", "after", "versions", "create", "update", "upsert", "set", "unset", "add", "remove", "delete", "anonymize", "reclass", "restore", "purge", "alias", "tags", "owner", "forUpdate", "cache", "rekey", "run", "execute", "account"];
+/** Свойства корня db (и транзакции db.begin()). */
+export declare const DB_METHODS: readonly ["as", "begin", "commit", "rollback", "lock", "batch", "watch", "close", "registry", "sql", "load", "verify", "maintain", "reset", "describe", "auth", "acl", "idOf", "refresh", "transaction", "flushSignals", "schema", "token", "tenant", "reloadSchema", "accounts", "credentials", "resources", "rules", "compact", "trimHistory", "rekeyClass", "cache"];
+/** Свойства батча db.batch(name). */
+export declare const BATCH_METHODS: readonly ["discard", "size"];
+/**
+ * Зарезервированные имена: Proxy разбирает их раньше классов, поэтому класс с таким именем
+ * недостижим как шаг. Установщик подставляет список в функцию базы reserved_names(), которая
+ * отклоняет связи с такими именами; совпадение со switch Proxy проверяет check-docs.
+ */
+export declare const RESERVED_CLASS_NAMES: readonly string[];
+/** Строка ответа: текущая версия (или версия журнала для asOf, versions, withDeleted). */
+export interface Row<D = Record<string, unknown>, L = Record<string, string | string[]>> {
     id: string;
     class: string;
-    data: Record<string, unknown>;
-    links: Record<string, string>;
-    tags: string[];
-    account: string;
+    /** Номер версии — для update(patch, { rev }) (этап 4). */
+    rev: number;
+    tenant: string;
     owner: string;
-    updated: string;
-    /** true у строк, возвращённых .delete() (цели + каскад) и tombstone-версий в .versions(). */
+    links: L;
+    data: D;
+    tags: string[];
+    /** Время версии (ISO, UTC, микросекунды). */
+    at: string;
+    author: string;
+    agent?: string;
+    /** Вид операции версии: create, update, delete, reclass, … */
+    op: string;
+    reason?: string;
+    /** Связь со старым или новым id при reclass и rekey. */
+    moved?: string;
+    /** Надгробие: удалённая сущность (withDeleted) или версия удаления (versions). */
     $deleted?: true;
-    /** Глубина узла при .deep()-обходе (1 = прямой ребёнок). */
+    /** Глубина узла при deep() (1 — прямой потомок); в превью удаления — уровень каскада (0 — цель). */
     $depth?: number;
+    /** Что сделал upsert (этап 4). */
+    $upsert?: 'created' | 'updated' | 'unchanged';
+    /** Превью удаления (delete() без confirm): удалится, снимется конец или помешает (restrict). */
+    $action?: 'delete' | 'unset' | 'restrict';
+    /** purge(): число версий в журнале (превью) или стёртых. */
+    $versions?: number;
+    /** purge({ confirm: true }): история стёрта. */
+    $purged?: true;
 }
-/** Результат run(): вариант пути — узел на каждый шаг цепочки. */
+/** Путь paths(): узел на каждый шаг цепочки. */
 export type Path = Record<string, Row>;
-/**
- * Конец связи класса (Schema.links v2). В БД элемент text[]: JSON-объект
- * `{"class":"Org","cardinality":1}` / `{"classes":["Service","Complex"],"cardinality":1}`
- * (союз ролей); legacy-строка 'Org' — сахар для {classes:['Org']} (старые схемы).
- */
-export interface LinkEnd {
-    /** Допустимые классы конца; ровно один из них присутствует в Entity.links. */
-    classes: string[];
-    /** Конец может отсутствовать. Default false. */
-    optional?: boolean;
-    /** ЗАРЕЗЕРВИРОВАНО (не имплементировано): 0 — безлимит, N — точное число. Default 1. */
-    cardinality?: number;
-}
-/**
- * Генерация id класса — из attributes.id:
- *   "uuid" | {type:'uuid'}                    → v4 (random, дефолт);
- *   {type:'uuid', generate: 7}                → v7 (время в старших битах);
- *   {type:'uuid', generate: 5, from: ['Slot','Staff']} → v5: детерминированный id из значений
- *     from — имена ОБЯЗАТЕЛЬНЫХ концов Schema.links (класс или полное имя союза
- *     'Service|Complex') и/или скалярных полей data.
- */
-export interface IdGen {
-    version: 4 | 5 | 7;
-    /** Только v5: источники имени (порядок значим). */
-    from?: string[];
-}
-/** Класс из таблицы Schema. */
-export interface ClassDef {
-    id: string;
-    alias: string;
-    category: 'HUB' | 'LINK';
-    ancestor: string | null;
-    ancestors: string[];
-    /** Все потомки (транзитивно) — считает триггер schema_lineage. */
-    descendants: string[];
-    /** Поля data с НАСЛЕДОВАНИЕМ по ancestor-цепочке (потомок поверх предка). */
-    attributes: Record<string, unknown>;
-    links: LinkEnd[];
-    /**
-     * true — хотя бы один конец объявлен объектом (схема v2): строгая валидация
-     * (жадный матчинг по порядку, союзы, optional, лишние связи — ошибка).
-     * false — все концы legacy-строками: старое поведение ('Entity' = полиморф, лишние молчат).
-     */
-    strictEnds: boolean;
-    meta: Record<string, unknown>;
-    abstract: boolean;
-    order: number;
-    /** Как генерить id новой сущности (attributes.id). */
-    idGen: IdGen;
-    /** Скомпилированный fastest-validator: true | ошибки. */
-    check: (data: Record<string, unknown>) => true | {
-        field: string;
-        message?: string;
-    }[];
-    /** Тип каждого поля attributes — для SQL-кастов в фильтрах. */
-    fieldTypes: Map<string, FieldType>;
-}
-export type FieldType = {
-    kind: 'number';
-} | {
-    kind: 'date';
-} | {
-    kind: 'boolean';
-} | {
-    kind: 'string';
-} | {
-    kind: 'array';
-} | {
-    kind: 'record';
-    value: FieldType;
-} | {
-    kind: 'object';
-    props: Map<string, FieldType>;
-} | {
-    kind: 'any';
-};
-/** Метка операторов фильтра (Symbol — не конфликтует с данными). */
+/** Метка операторов фильтра (символ не пересекается с данными). */
 export declare const OP: unique symbol;
 export interface Op {
     [OP]: string;
     args: unknown[];
 }
 export type Scalar = string | number | boolean | null;
-/** Значение фильтра по полю: скаляр (eq), оператор или вложенный record-объект. */
+/** Значение фильтра по полю: скаляр (равенство), список, оператор или вложенный объект. */
 export type FieldFilter = Scalar | Scalar[] | Op | {
-    [key: string]: Scalar | Op;
+    [key: string]: FieldFilter | undefined;
+} | {
+    id: string;
 };
 /**
- * Фильтр шага:
- *  - строка / массив строк — id;
- *  - объект: { поле data: значение (eq) | оператор | вложенный record-путь } + ключ id.
- * Колонки tags/account/owner фильтруются модификаторами цепочки .tags()/.account()/.owner().
+ * Фильтр шага: id или список id; строка ответа (берётся её id); or(…); объект — поля data
+ * любой глубины, роли концов (`{ Org: id }`) и `id`.
  */
 export type Filter = string | string[] | Op | {
+    id: string;
+    class: string;
+} | {
     [field: string]: FieldFilter | undefined;
 };
-/** Курсор keyset-пагинации: значение поля сортировки + id последней строки страницы. */
+/** Курсор keyset-пагинации: значение поля сортировки и id последней строки страницы. */
 export interface Cursor {
-    v: string | number;
+    v: string | number | boolean | null;
     id: string;
 }
-/**
- * Операция записи, привязанная к шагу цепочки:
- * .create() / .update() / .delete() / .anonymize().
- * Терминал исполняет план (все операции + финальное чтение) одной транзакцией.
- */
-export interface PlanOp {
-    kind: 'create' | 'update' | 'delete' | 'anonymize' | 'purge';
-    /** create/update: данные новой версии (deep-merge листьев). */
-    data?: Record<string, unknown>;
-    /** anonymize: string-поля под '[erased]'. */
-    fields?: string[];
-    /** delete/purge: true — выполнить; без confirm — превью (вернуть кандидатов/замыкание, БД не трогать). */
-    confirm?: boolean;
-    /** Снапшот модификаторов на момент вызова операции (limit/sort для поиска целей). */
-    mods: ChainMods;
-}
-/** Модификаторы выборки цепочки: .limit() / .offset() / .sort() / .asOf() / .after(). */
+/** Модификаторы выборки цепочки. */
 export interface ChainMods {
     limit?: number;
     offset?: number;
-    /** 'updated' | 'data.<поле>' (каст по типу поля последнего шага). */
+    /** 'at' | 'rev' | 'id' | 'data.<путь>'. */
     order?: string;
     desc?: boolean;
-    /** Чтение «как было на момент T»: ISO-строка или Date. */
+    /** Срез «как было на момент T» (ISO). */
     asOf?: string;
-    /** Keyset-пагинация от курсора (требует sort). */
     after?: Cursor;
-    /** Внутреннее: агрегация терминалов .sum/.avg/.min/.max/.countBy. */
-    aggFn?: 'sum' | 'avg' | 'min' | 'max' | 'countBy';
-    aggField?: string;
-    /** .withDeleted(): последний шаг включает удалённые (tombstone). Снимает ТОЛЬКО фильтр deleted; enforceAccount/enforceAcl действуют. */
+    /** Последний шаг включает удалённые. */
     withDeleted?: boolean;
+    /** Чтение с блокировкой строк последнего шага (только в db.begin()). */
+    forUpdate?: boolean;
+    /** versions({ follow: true }): история и через смену id (reclass, rekey) по колонке moved. */
+    follow?: boolean;
+    /** Кэш результатов (§2.12): .cache() — срок по умолчанию, .cache({ ttl }) — свой, секунды. */
+    cache?: {
+        ttl?: number;
+    };
 }
-export interface Account {
-    id: string;
-    categories: string[];
-    data: Record<string, unknown>;
-    meta: Record<string, unknown>;
-    avatar: string;
-    enabled: boolean;
-    created: string;
-    updated: string;
-}
-export interface Credential {
-    id: string;
-    account: string;
-    category: string;
-    identifier: string;
-    meta: Record<string, unknown>;
-    confirmed: boolean;
-    created: string;
-    updated: string;
-    deleted: string | null;
-}
-export interface Resource {
-    alias: string;
-    category: string;
-    pattern: Record<string, unknown> | null;
-    meta: Record<string, unknown> | null;
-}
-export interface Rule {
-    account: string;
-    resource: string;
-    permission: string;
-    weight: number | null;
-    meta: Record<string, unknown> | null;
-    enabled: boolean;
-}
-/** Операция над данными = категория Resource: 'READ' | 'WRITE' | 'DELETE'. */
-export type AclOp = 'READ' | 'WRITE' | 'DELETE';
-/** Решение ACL: победившее правило (max weight; при равенстве deny; нет правил — deny). */
-export interface AclDecision {
-    allow: boolean;
-    /** Победившее правило (нет — deny «no matching rule»). */
-    rule?: Rule;
-    /**
-     * Остаточный шаблон строки Entity из pattern победившего allow-ресурса
-     * (ключи-колонки без class, "$account" уже подставлен) — вливается в SQL
-     * до сортировки/лимита. Отсутствует = класс целиком.
-     */
-    filter?: Record<string, unknown>;
-    /** Из meta deny-правила: код и сообщение для ответа клиенту. */
-    code?: number;
-    message?: string;
-}
-/** Событие хука onQuery: один SQL-запрос цепочки (чтение или запись). */
+/** Событие хука onQuery: один запрос цепочки. */
 export interface QueryEvent {
-    /** Режим чтения или write-операция. */
-    mode: 'paths' | 'rows' | 'ids' | 'count' | 'versions' | 'agg' | 'insert' | 'delete';
-    /** Классы шагов цепочки (id из Schema). */
+    mode: 'paths' | 'rows' | 'ids' | 'count' | 'versions' | 'agg';
+    /** Классы шагов цепочки. */
     classes: string[];
-    /** Длительность, мс. */
     ms: number;
-    /** Число строк результата. */
     rows: number;
-    /** true при ms > slowMs (если slowMs задан). */
+    /** ms > slowMs. */
     slow: boolean;
 }
-export interface ConnectOpts {
-    /** postgres://user:pass@host:port/db */
-    dsn: string;
-    /** PG-схема с таблицами Entity/Schema (напр. 'booking'). */
-    schema: string;
-    /** Партиция данных. Default 'entity'. */
-    partition?: string;
-    /** Размер пула соединений. Default 10. */
-    max?: number;
-    /**
-     * Жёсткая изоляция арендатора: чтения фильтруются по account, записи пришпилены к нему.
-     * **Default true** (с 0.20.0). Идентичность берётся у хендла `db.as(account)`; на
-     * безличном (корневом) хендле чтение/запись при включённой изоляции — ошибка с подсказкой.
-     * Явный `.account(чужой)` на scoped-хендле — тоже ошибка.
-     * Выключать (`false`) осмысленно лишь для админских/сервисных подключений,
-     * которым нужен доступ ко всем арендаторам.
-     */
-    enforceAccount?: boolean;
-    /**
-     * ACL по Resource/Rule: категории READ/WRITE/DELETE, pattern — шаблон строки Entity
-     * (колонки + "$account"). Каждый шаг цепочки проверяется на READ, записи — WRITE,
-     * delete — DELETE (включая классы каскада); предикат победившего правила вливается
-     * в SQL до сортировки/лимита. Субъект даёт db.as() (энфорсер компилится на scope).
-     * Deny-by-default.
-     * **Default false** — остаётся opt-in: включённый по умолчанию deny-by-default без
-     * настроенных Resource/Rule давал бы пустые выборки. Пока выключен, connect() один раз
-     * на процесс печатает предупреждение.
-     * Правила снимаются на connect и компилятся в memo-энфорсер; перечитать без
-     * реконнекта — db.reloadSchema() (пересобирает и реестр, и ACL-резолвер).
-     */
-    enforceAcl?: boolean;
-    /** Хук на каждый запрос цепочки (метрики, лог). */
-    onQuery?: (e: QueryEvent) => void;
-    /** Порог «медленного» запроса, мс: событие получает slow: true; без onQuery — console.warn. */
-    slowMs?: number;
-}
-/**
- * Имена, которые Proxy цепочки/db разбирает ДО резолва класса, поэтому класс с таким
- * id/alias НЕДОСТИЖИМ как шаг под этим именем (`db.Клиент(c).link()` уйдёт в
- * migration-ошибку `.link() removed`, а не в класс `link`).
- *
- * Источник истины — `case`-метки switch'ей в chain.ts; совпадение с этим списком
- * проверяет scripts/check-docs.mjs. Используется как гвард: schema.define() отказывает,
- * loadRegistry предупреждает.
- */
-export declare const RESERVED_CLASS_NAMES: readonly string[];
-/** Зарезервированные имена класса среди {id, alias}; пусто — конфликта нет. */
-export declare function reservedNamesOf(def: {
-    id: string;
-    alias?: string;
-}): string[];
-/**
- * Ревизия движка (`lib/sql/ddl.sql`), которую ожидает ЭТА версия либы.
- *
- * Зачем: `ddl.sql` растёт аддитивно внутри одной версии движка (в 0.19.0, например,
- * добавились функции purge/purge_closure/purge_account). Схема, накатанная раньше, их
- * НЕ получает — приложение обновляет пакет и падает сырым `PostgresError: function
- * "v1.x".purge(...) does not exist` вместо внятного объяснения. `connect()` сравнивает
- * ожидаемую ревизию с меткой в схеме (`COMMENT ON SCHEMA` — её ставит последняя строка
- * ddl.sql) и один раз на процесс предупреждает, что и как обновить.
- *
- * Файл идемпотентен, поэтому аддитивные правки доезжают повторным накатом:
- * `up({ upgrade: true })` либо `node db/apply.mjs --upgrade` — данные целы.
- * Несовместимая правка СТРУКТУРЫ таблиц — это смена version в имени схемы (v1 → v2).
- *
- * Совпадение константы с маркером `-- DDL_REVISION:` в ddl.sql проверяет
- * `scripts/check-docs.mjs` — иначе одно уедет без другого.
- */
-export declare const DDL_REVISION = 1;
-/** Метка ревизии в комментарии схемы: 'letopis ddl_revision=N' → N; иначе null. */
-export declare function parseDdlRevision(comment: string | null | undefined): number | null;

package/dist/types.js

@@ -1,113 +1,32 @@
 /**
- * letopis: типы.
+ * Общие типы letopis 1.0. Файл наполняется по этапам плана (reports/PLAN-LETOPIS-1.0.md).
  */
-//
-// FILE: lib/src/types.ts
-// VERSION: 1.3.0
-// START_MODULE_CONTRACT
-//   PURPOSE: Общий словарь типов всей библиотеки letopis.
-//   SCOPE: сущности, пути, определения классов, типы полей, фильтры и операторы, курсоры/план записи/модификаторы цепочки, записи auth/ACL, событие запроса и опции connect + символ OP.
-//   DEPENDS: none
-//   LINKS: M-TYPES, V-M-TYPES
-//   ROLE: TYPES
-//   MAP_MODE: EXPORTS
-// END_MODULE_CONTRACT
-//
-// START_MODULE_MAP
-//   Row - строка Entity (актуальная версия): id/class/data/links/tags/account/owner/updated + служебные $deleted/$depth.
-//   Path - вариант пути run(): по одному узлу Row на каждый шаг цепочки.
-//   LinkEnd - конец связи класса (Schema.links v2): допустимые классы, optional, cardinality.
-//   IdGen - способ генерации id класса (версия 4/5/7) + источники from для v5.
-//   ClassDef - класс из таблицы Schema: категория, наследование, атрибуты, концы связей, idGen, валидатор, fieldTypes.
-//   FieldType - тип поля attributes для SQL-кастов (number/date/boolean/string/array/record/object/any).
-//   OP - символьная метка операторов фильтра (Symbol — не конфликтует с данными).
-//   Op - узел оператора фильтра: { [OP]: имя, args }.
-//   Scalar - скалярное значение фильтра: string | number | boolean | null.
-//   FieldFilter - значение фильтра по полю: скаляр (eq) / массив / оператор Op / вложенный record.
-//   Filter - фильтр шага: id-строка/массив, Op (or) или объект полей data.
-//   Cursor - курсор keyset-пагинации: значение поля сортировки + id последней строки.
-//   PlanOp - операция записи шага (create/update/delete/anonymize) + снапшот модификаторов.
-//   ChainMods - модификаторы выборки цепочки (limit/offset/order/desc/asOf/after + внутренняя агрегация).
-//   Account - запись аккаунта служебной таблицы auth.
-//   Credential - учётные данные аккаунта (identifier/category/confirmed/…).
-//   Resource - ресурс ACL: alias/category/pattern/meta.
-//   Rule - правило ACL: account/resource/permission/weight/enabled.
-//   AclOp - операция над данными = категория Resource: 'READ' | 'WRITE' | 'DELETE'.
-//   AclDecision - решение ACL: allow + победившее правило + остаточный filter + code/message.
-//   QueryEvent - событие хука onQuery: режим, классы, ms, rows, slow.
-//   ConnectOpts - опции connect(): dsn/schema/partition/max/enforceAccount/enforceAcl/onQuery/slowMs (account/owner — не здесь, их даёт db.as()).
-//   RESERVED_CLASS_NAMES - имена, перехватываемые Proxy до резолва класса (шаг недостижим под этим именем).
-//   reservedNamesOf - зарезервированные имена среди {id, alias} определения класса.
-// END_MODULE_MAP
-//
-// START_CHANGE_SUMMARY
-//   LAST_CHANGE: [v1.3.0 - BREAKING: из ConnectOpts удалены account/owner (арендатор — свойство
-//     ВЫЗОВА: db.as(account, { owner })); 'as' добавлен в RESERVED_CLASS_NAMES → 52 имени.
-//     Ранее: 'link' убран из RESERVED_CLASS_NAMES (охранник цепочки снят, имя снова
-//     резолвится как класс); enforceAccount задокументирован как Default true]
-// END_CHANGE_SUMMARY
-//
-// START_BLOCK_ENTITY_TYPES
-// END_BLOCK_ENTITY_TYPES
-//
-// START_BLOCK_FILTER_TYPES
-/** Метка операторов фильтра (Symbol — не конфликтует с данными). */
-export const OP = Symbol('letopis.op');
-// END_BLOCK_CONNECT_TYPES
-// START_BLOCK_RESERVED_NAMES
-/**
- * Имена, которые Proxy цепочки/db разбирает ДО резолва класса, поэтому класс с таким
- * id/alias НЕДОСТИЖИМ как шаг под этим именем (`db.Клиент(c).link()` уйдёт в
- * migration-ошибку `.link() removed`, а не в класс `link`).
- *
- * Источник истины — `case`-метки switch'ей в chain.ts; совпадение с этим списком
- * проверяет scripts/check-docs.mjs. Используется как гвард: schema.define() отказывает,
- * loadRegistry предупреждает.
- */
-export const RESERVED_CLASS_NAMES = [
-    // все три Proxy: then гасится, чтобы цепочка не выглядела thenable для await
-    'then',
-    // chain-уровень (makeChain handler)
-    'entity', 'run', 'execute', 'rows', 'first', 'ids', 'count', 'limit', 'offset', 'sort',
-    'asOf', 'withDeleted', 'deep', 'exact', 'sum', 'avg', 'min', 'max', 'countBy', 'after', 'versions',
-    'create', 'update', 'set', 'delete', 'anonymize', 'purge', 'alias', 'tags', 'account',
-    'owner',
-    // db-уровень (makeDb handler): switch …
-    'as', 'begin', 'commit', 'rollback', 'lock', 'batch', 'watch', 'close', 'reloadSchema',
-    'registry', 'sql',
-    // … и фасады, которые разбираются if'ами ДО switch (служебные таблицы, auth, acl)
-    'accounts', 'credentials', 'resources', 'rules', 'schema', 'auth', 'acl',
-    // batch-уровень (makeBatch handler)
-    'discard', 'size',
+/** Ревизия движка в базе: штамп в lib/sql/99-revision.sql должен совпадать (этап 1). */
+export const DDL_REVISION = 5;
+// ---------------------------------------------------------------------------
+// Методы цепочки — единственный источник зарезервированных имён (план, §2.14, этап 3, п. 10)
+// ---------------------------------------------------------------------------
+/** Методы цепочки: терминалы, модификаторы, глаголы записи (этап 4), охранники снесённого API. */
+export const CHAIN_METHODS = [
+    'then', 'entity', 'paths', 'rows', 'first', 'ids', 'count', 'limit', 'offset', 'sort', 'asOf', 'withDeleted',
+    'deep', 'exact', 'sum', 'avg', 'min', 'max', 'countBy', 'after', 'versions', 'create', 'update', 'upsert', 'set',
+    'unset', 'add', 'remove', 'delete', 'anonymize', 'reclass', 'restore', 'purge', 'alias', 'tags', 'owner',
+    'forUpdate', 'cache', 'rekey', 'run', 'execute', 'account',
+];
+/** Свойства корня db (и транзакции db.begin()). */
+export const DB_METHODS = [
+    'as', 'begin', 'commit', 'rollback', 'lock', 'batch', 'watch', 'close', 'registry', 'sql', 'load', 'verify',
+    'maintain', 'reset', 'describe', 'auth', 'acl', 'idOf', 'refresh', 'transaction', 'flushSignals', 'schema',
+    'token', 'tenant', 'reloadSchema', 'accounts', 'credentials', 'resources', 'rules', 'compact',
+    'trimHistory', 'rekeyClass', 'cache',
 ];
-/** Зарезервированные имена класса среди {id, alias}; пусто — конфликта нет. */
-export function reservedNamesOf(def) {
-    const set = new Set(RESERVED_CLASS_NAMES);
-    return [def.id, def.alias].filter((n) => !!n && set.has(n));
-}
-// END_BLOCK_RESERVED_NAMES
-// START_BLOCK_DDL_REVISION
+/** Свойства батча db.batch(name). */
+export const BATCH_METHODS = ['discard', 'size'];
 /**
- * Ревизия движка (`lib/sql/ddl.sql`), которую ожидает ЭТА версия либы.
- *
- * Зачем: `ddl.sql` растёт аддитивно внутри одной версии движка (в 0.19.0, например,
- * добавились функции purge/purge_closure/purge_account). Схема, накатанная раньше, их
- * НЕ получает — приложение обновляет пакет и падает сырым `PostgresError: function
- * "v1.x".purge(...) does not exist` вместо внятного объяснения. `connect()` сравнивает
- * ожидаемую ревизию с меткой в схеме (`COMMENT ON SCHEMA` — её ставит последняя строка
- * ddl.sql) и один раз на процесс предупреждает, что и как обновить.
- *
- * Файл идемпотентен, поэтому аддитивные правки доезжают повторным накатом:
- * `up({ upgrade: true })` либо `node db/apply.mjs --upgrade` — данные целы.
- * Несовместимая правка СТРУКТУРЫ таблиц — это смена version в имени схемы (v1 → v2).
- *
- * Совпадение константы с маркером `-- DDL_REVISION:` в ddl.sql проверяет
- * `scripts/check-docs.mjs` — иначе одно уедет без другого.
+ * Зарезервированные имена: Proxy разбирает их раньше классов, поэтому класс с таким именем
+ * недостижим как шаг. Установщик подставляет список в функцию базы reserved_names(), которая
+ * отклоняет связи с такими именами; совпадение со switch Proxy проверяет check-docs.
  */
-export const DDL_REVISION = 1;
-/** Метка ревизии в комментарии схемы: 'letopis ddl_revision=N' → N; иначе null. */
-export function parseDdlRevision(comment) {
-    const m = /letopis ddl_revision=(\d+)/.exec(comment ?? '');
-    return m ? Number(m[1]) : null;
-}
-// END_BLOCK_DDL_REVISION
+export const RESERVED_CLASS_NAMES = [...new Set([...CHAIN_METHODS, ...DB_METHODS, ...BATCH_METHODS])];
+/** Метка операторов фильтра (символ не пересекается с данными). */
+export const OP = Symbol.for('letopis.op');