letopis 0.20.3 → 1.0.0

package/dist/schema.js

@@ -1,351 +0,0 @@
-/**
- * Загрузка таблицы Schema → реестр классов:
- *  - резолв имени по id и alias;
- *  - цепочка ancestors (walk по ancestor, если в БД не заполнена);
- *  - attributes НАСЛЕДУЮТСЯ по цепочке (потомок поверх предка; поле = замена правила
- *    целиком) — включая правило id (генерация v4/v5/v7); links НЕ наследуются;
- *  - скомпилированный fastest-validator per class;
- *  - карта типов полей (для SQL-кастов фильтров).
- */
-//
-// FILE: lib/src/schema.ts
-// VERSION: 1.1.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.1.0 - loadRegistry: 42P01/3F000 перехватываются и заменяются адресной ошибкой
-//     (передано базовое имя вместо "vN.имя") со списком letopis-схем — паритет с валидацией up()]
-// END_CHANGE_SUMMARY
-import { createRequire } from 'node:module';
-import { reservedNamesOf } from './types.js';
-const Validator = createRequire(import.meta.url)('fastest-validator');
-const v = new Validator({ useNewCustomCheckerFunction: true });
-export class Registry {
-    byName = new Map();
-    all = [];
-    add(def) {
-        this.all.push(def);
-        this.byName.set(def.id, def);
-        this.byName.set(def.alias, def);
-    }
-    /** Класс по id или alias; undefined если нет. */
-    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);
-        if (!def) {
-            const names = this.all.map((d) => `${d.id}·${d.alias}`).join(', ');
-            throw new Error(`letopis: unknown class "${name}". Known: ${names}`);
-        }
-        return def;
-    }
-    has(name) {
-        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') {
-        const base = attr.split('|')[0].trim();
-        switch (base) {
-            case 'number':
-                return { kind: 'number' };
-            case 'date':
-                return { kind: 'date' };
-            case 'boolean':
-                return { kind: 'boolean' };
-            case 'array':
-                return { kind: 'array' };
-            case 'string':
-            case 'uuid':
-            case 'email':
-            case 'url':
-            case 'enum':
-                return { kind: 'string' };
-            default:
-                return { kind: 'any' };
-        }
-    }
-    if (Array.isArray(attr))
-        return attr.length ? fieldTypeOf(attr[0]) : { kind: 'any' };
-    if (typeof attr === 'object' && attr !== null) {
-        const t = attr.type;
-        if (t === 'record')
-            return { kind: 'record', value: fieldTypeOf(attr.value ?? 'any') };
-        if (t === 'object') {
-            // вложенная структура: {type:'object', props:{…}} — типы листьев любой глубины
-            const props = attr.props ?? attr.properties;
-            if (props && typeof props === 'object') {
-                const m = new Map();
-                for (const [k, v] of Object.entries(props))
-                    m.set(k, fieldTypeOf(v));
-                return { kind: 'object', props: m };
-            }
-            return { kind: 'any' };
-        }
-        if (t === 'array')
-            return { kind: 'array' };
-        if (t === 'number')
-            return { kind: 'number' };
-        if (t === 'date')
-            return { kind: 'date' };
-        if (t === 'boolean')
-            return { kind: 'boolean' };
-        if (t === 'enum' || t === 'string' || t === 'uuid' || t === 'email' || t === 'url')
-            return { kind: 'string' };
-        if (typeof t === 'string')
-            return fieldTypeOf(t);
-    }
-    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) {
-        ancestors = [row.id];
-        let cur = row.ancestor;
-        const seen = new Set([row.id]);
-        while (cur && !seen.has(cur)) {
-            ancestors.push(cur);
-            seen.add(cur);
-            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({ ...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(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,
-        category: row.category,
-        ancestor: row.ancestor,
-        ancestors,
-        descendants: row.descendants ?? [], // считает триггер schema_lineage
-        attributes: merged,
-        links: ends,
-        strictEnds,
-        idGen,
-        meta: row.meta ?? {},
-        abstract: row.meta?.abstract === true || row.meta?.abstract === 'true',
-        order: row.order,
-        check,
-        fieldTypes,
-    };
-}
-// START_CONTRACT: loadRegistry
-//   PURPOSE: Прочитать классы партиции из таблицы Schema и построить Registry со скомпилированными check.
-//   INPUTS: { sql: postgres.Sql; pgSchema: string; partition: string }
-//   OUTPUTS: { Promise<Registry> - реестр всех классов партиции }
-//   SIDE_EFFECTS: SELECT из "<pgSchema>"."Schema"; на 42P01/3F000 — доп. SELECT списка схем для подсказки
-//   ERRORS: schema has no classes for partition; schema has no "Schema" table (передано базовое имя вместо "vN.имя")
-//   LINKS: M-SCHEMA, V-M-SCHEMA, M-DDL
-// END_CONTRACT: loadRegistry
-/** Уже предупреждённые «схема:класс» — чтобы не повторять на каждый connect/reloadSchema. */
-const warnedReserved = new Set();
-export async function loadRegistry(sql, pgSchema, partition) {
-    // START_BLOCK_LOAD_QUERY
-    const ident = `"${pgSchema.replace(/"/g, '""')}"`;
-    let rows;
-    try {
-        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]));
-    }
-    catch (e) {
-        // 42P01 undefined_table / 3F000 invalid_schema_name — типовая ошибка: передали БАЗОВОЕ имя
-        // ('booking') вместо полного с версией ('v1.booking'). Подсказываем вместо сырой ошибки PG.
-        const code = e.code;
-        if (code !== '42P01' && code !== '3F000')
-            throw e;
-        // перечисляем ТОЛЬКО схемы letopis (те, где есть таблица Schema), а не все namespace БД
-        const found = (await sql.unsafe(`SELECT table_schema AS s FROM information_schema.tables
-         WHERE table_name = 'Schema' ORDER BY 1`));
-        throw new Error(`letopis: schema "${pgSchema}" has no "Schema" table — connect({ schema }) takes the FULL ` +
-            `PG-schema name WITH the engine version ("v1.booking"); the library adds no prefix. ` +
-            `letopis schemas here: ${found.map((r) => r.s).join(', ') || '(none)'}. ` +
-            `Create one with up({ schema, version }) or db/apply.mjs --schema=… --version=…`);
-    }
-    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)
-        registry.add(buildDef(row, byId));
-    // START_BLOCK_RESERVED_WARN
-    // Имя, перехватываемое Proxy до резолва класса, делает шаг недостижимым ПОД ЭТИМ именем
-    // (второе имя класса, если оно свободно, работает). Предупреждаем, а НЕ бросаем: демо-сид
-    // содержит класс id "link", и throw уронил бы up() на штатной схеме.
-    // Один раз на (схема, класс) за процесс: loadRegistry зовётся на каждый connect и
-    // reloadSchema — иначе штатный прогон утонул бы в повторах.
-    for (const def of registry.all) {
-        const clash = reservedNamesOf(def);
-        if (!clash.length)
-            continue;
-        const seen = `${pgSchema}:${def.id}`;
-        if (warnedReserved.has(seen))
-            continue;
-        warnedReserved.add(seen);
-        const free = [def.id, def.alias].filter((n) => !clash.includes(n));
-        console.warn(`letopis: class name ${clash.map((n) => `"${n}"`).join(' / ')} is reserved by the chain API — ` +
-            (free.length
-                ? `use ${free.map((n) => `"${n}"`).join(' / ')} for chain steps`
-                : 'this class is unreachable as a chain step; rename it'));
-    }
-    // END_BLOCK_RESERVED_WARN
-    return registry;
-}

package/dist/sessions.d.ts

@@ -1,32 +0,0 @@
-/** Минимальный срез Redis-клиента (ioredis подходит как есть). */
-export interface SessionStore {
-    set(key: string, value: string, mode: 'EX', ttlSec: number): Promise<unknown>;
-    get(key: string): Promise<string | null>;
-    del(...keys: string[]): Promise<unknown>;
-    sadd(key: string, ...members: string[]): Promise<unknown>;
-    srem(key: string, ...members: string[]): Promise<unknown>;
-    smembers(key: string): Promise<string[]>;
-    expire(key: string, ttlSec: number): Promise<unknown>;
-}
-export interface Session {
-    account: string;
-    meta: Record<string, unknown>;
-    created: string;
-}
-export interface Sessions {
-    /** Новая сессия → токен (отдаётся один раз; в Redis — только его sha256). Default ttl 7 суток. */
-    start(account: string | {
-        id: string;
-    }, opts?: {
-        ttlSec?: number;
-        meta?: Record<string, unknown>;
-    }): Promise<string>;
-    /** null — нет/просрочена/отозвана. */
-    check(token: string): Promise<Session | null>;
-    revoke(token: string): Promise<boolean>;
-    /** Гасит все сессии аккаунта, возвращает сколько было в индексе. */
-    revokeAll(account: string | {
-        id: string;
-    }): Promise<number>;
-}
-export declare function makeSessions(store: SessionStore): Sessions;

package/dist/sessions.js

@@ -1,114 +0,0 @@
-/**
- * Сессии во внешнем KV (Redis): db.auth.sessions(store).
- * Клиент НЕ входит в зависимости — инжектируется пользователем (интерфейс 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);
-            const ttl = opts.ttlSec ?? DEFAULT_TTL;
-            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)
-                return false;
-            const { account } = JSON.parse(raw);
-            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/tables.d.ts

@@ -1,105 +0,0 @@
-/**
- * Фасады служебных таблиц auth/ACL: Account, Credential, Resource, Rule.
- * Обычные таблицы (UPDATE/DELETE разрешены) — цепочки/версии тут не применяются.
- * Доступны как db.accounts / db.credentials / db.resources / db.rules (и в транзакции).
- */
-import type { Ctx } from './sql.js';
-import type { Account, Credential, Resource, Rule } from './types.js';
-export interface AccountsApi {
-    /** Фильтры: id, enabled, category (строка — вхождение в categories). */
-    find(f?: {
-        id?: string;
-        enabled?: boolean;
-        category?: string;
-    }): Promise<Account[]>;
-    get(id: string): Promise<Account | null>;
-    /** insert (без id) | update по id. jsonb-поля мержатся на уровне значения целиком. */
-    set(a: Partial<Account>): Promise<Account>;
-    /** Физический DELETE; Credential снесётся FK-каскадом. */
-    delete(id: string): Promise<boolean>;
-    /**
-     * Полный физический офбординг тенанта (необратимо): все Entity (account|owner=id) + сам Account
-     * (Credential — FK-каскад), через серверную purge_account(). Предохранители: только Owner/System-вызов;
-     * нельзя снести последний enabled Owner (лок-аут) и свой аккаунт. → true если Account снесён.
-     */
-    purge(id: string): Promise<boolean>;
-}
-export interface CredentialsApi {
-    /** deleted IS NULL по умолчанию; withDeleted: true — включая удалённые. */
-    find(f?: {
-        id?: string;
-        account?: string;
-        category?: string;
-        identifier?: string;
-        confirmed?: boolean;
-        withDeleted?: boolean;
-    }): Promise<Credential[]>;
-    /** upsert по UNIQUE (account, category, identifier); повторный set воскрешает (deleted → NULL). */
-    set(c: {
-        account: string;
-        category: string;
-        identifier: string;
-        meta?: Record<string, unknown>;
-        confirmed?: boolean;
-    }): Promise<Credential>;
-    /** Мягкое удаление: deleted = now(). */
-    delete(id: string): Promise<boolean>;
-}
-export interface ResourcesApi {
-    find(f?: {
-        category?: string;
-    }): Promise<Resource[]>;
-    get(alias: string): Promise<Resource | null>;
-    /** upsert по alias. */
-    set(r: {
-        alias: string;
-        category: string;
-        pattern?: Record<string, unknown> | null;
-        meta?: Record<string, unknown> | null;
-    }): Promise<Resource>;
-    /** Физический DELETE; Rule на этот ресурс снесутся FK-каскадом. */
-    delete(alias: string): Promise<boolean>;
-}
-export interface RulesApi {
-    find(f?: {
-        account?: string;
-        resource?: string;
-        permission?: string;
-        enabled?: boolean;
-    }): Promise<Rule[]>;
-    /** upsert по PK (account, resource). Оба конца — Resource.alias (FK). */
-    set(r: {
-        account: string;
-        resource: string;
-        permission: string;
-        weight?: number | null;
-        meta?: Record<string, unknown> | null;
-        enabled?: boolean;
-    }): Promise<Rule>;
-    delete(account: string, resource: string): Promise<boolean>;
-}
-export interface SchemaApi {
-    /**
-     * Upsert определения класса в таблицу Schema (ON CONFLICT (partition,id) DO UPDATE) + reloadSchema().
-     * Правка «простым SQL», подхватывается сразу без реконнекта. attributes — DSL fastest-validator
-     * (валидирует либа при чтении реестра); ancestors/descendants считает триггер schema_lineage.
-     */
-    define(def: {
-        id: string;
-        alias: string;
-        category: 'HUB' | 'LINK';
-        ancestor?: string | null;
-        attributes?: Record<string, unknown>;
-        meta?: Record<string, unknown>;
-        links?: unknown[];
-        order?: number;
-    }): Promise<void>;
-}
-export interface Tables {
-    accounts: AccountsApi;
-    credentials: CredentialsApi;
-    resources: ResourcesApi;
-    rules: RulesApi;
-    schema: SchemaApi;
-}
-export declare function makeTables(ctx: Ctx): Tables;