letopis 0.20.3 → 1.0.0

package/dist/cli.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export declare function main(argv: string[]): Promise<number>;

package/dist/cli.js

@@ -0,0 +1,164 @@
+#!/usr/bin/env node
+/**
+ * CLI letopis (план, этап 2, п. 7; этап 4, п. 11; этап 6, п. 4, 8, 12): `letopis sync`, `types`, `load`,
+ * `verify`, `maintain`, `describe`; этап 7 — `import` (из 0.21).
+ *
+ *   letopis sync <модуль моделей> --dsn … --schema v2.x (--token … | --api-key …) [--apply]
+ *   letopis types --dsn … --schema v2.x (--token … | --api-key …) [--out types.d.ts]
+ *   letopis load <файлы NDJSON…> --dsn … --schema v2.x (--token … | --api-key …) [--class C]
+ *     [--duplicates error|first|last] [--existing error|skip|update] [--commit-every N] [--verify]
+ *   letopis verify --dsn … --schema v2.x [--token … | --api-key …] [--data]   — код 1 при находках
+ *   letopis maintain --dsn … --schema v2.x [--token … | --api-key …] [--batches N]
+ *   letopis describe --dsn … --schema v2.x (--token … | --api-key …) [--format json|text] [--out файл]
+ *   letopis import --from <строка 0.21> --from-schema v1.x --dsn … --schema v2.x [--tenant <имя>] [--keyless C]…
+ *     [--rename Старое=Новое]… [--update] [--commit-every N] [--partition p]   — код 1, если verify нашёл расхождения
+ */
+import { parseArgs } from 'node:util';
+import { readFile, writeFile } from 'node:fs/promises';
+import { pathToFileURL } from 'node:url';
+import { resolve } from 'node:path';
+import { connect, describeText } from './index.js';
+import { syncModels, generateTypes } from './sync.js';
+import { import021 } from './import.js';
+const USAGE = `letopis sync <модуль> --dsn <строка> --schema <v2.имя> (--token <токен> | --api-key <ключ>) [--apply]
+letopis types --dsn <строка> --schema <v2.имя> (--token <токен> | --api-key <ключ>) [--out <файл>]
+letopis load <файлы…> --dsn <строка> --schema <v2.имя> (--token <токен> | --api-key <ключ>) [--class <Класс>]
+  [--duplicates error|first|last] [--existing error|skip|update] [--commit-every <N>] [--verify]
+letopis verify --dsn <строка> --schema <v2.имя> [--token <токен> | --api-key <ключ>] [--data]
+letopis maintain --dsn <строка> --schema <v2.имя> [--token <токен> | --api-key <ключ>] [--batches <N>]
+letopis describe --dsn <строка> --schema <v2.имя> (--token <токен> | --api-key <ключ>) [--format json|text] [--out <файл>]
+letopis import --from <строка 0.21> --from-schema <v1.имя> --dsn <строка> --schema <v2.имя> [--tenant <имя>] [--keyless <Класс>]…
+  [--rename <Старое>=<Новое>]… [--update] [--commit-every <N>] [--partition <имя>]`;
+const isModel = (v) => typeof v === 'object' && v !== null && typeof v.describe === 'function' && typeof v.name === 'string';
+export async function main(argv) {
+    const { values, positionals } = parseArgs({
+        args: argv,
+        allowPositionals: true,
+        options: {
+            dsn: { type: 'string' }, schema: { type: 'string' }, token: { type: 'string' }, 'api-key': { type: 'string' },
+            apply: { type: 'boolean' }, out: { type: 'string' }, help: { type: 'boolean' },
+            class: { type: 'string' }, duplicates: { type: 'string' }, existing: { type: 'string' }, 'commit-every': { type: 'string' },
+            verify: { type: 'boolean' }, trust: { type: 'boolean' }, data: { type: 'boolean' }, batches: { type: 'string' },
+            format: { type: 'string' },
+            from: { type: 'string' }, 'from-schema': { type: 'string' }, tenant: { type: 'string' }, partition: { type: 'string' },
+            keyless: { type: 'string', multiple: true }, rename: { type: 'string', multiple: true }, update: { type: 'boolean' },
+        },
+    });
+    const [cmd, arg] = positionals;
+    if (values.help || !cmd || !values.dsn || !values.schema) {
+        console.log(USAGE);
+        return cmd ? 2 : 0;
+    }
+    if (cmd === 'import') {
+        // импорт сам открывает администраторские подключения к 0.21 и к 1.0 (загрузчик, функции владельца)
+        if (!values.from || !values['from-schema']) {
+            console.log(USAGE);
+            return 2;
+        }
+        const rename = {};
+        for (const x of values.rename ?? []) {
+            const [from, to] = x.split('=');
+            if (!from || !to) {
+                console.log(USAGE);
+                return 2;
+            }
+            rename[from] = to;
+        }
+        const r = await import021({
+            from: values.from, fromSchema: values['from-schema'], dsn: values.dsn, schema: values.schema, tenant: values.tenant,
+            partition: values.partition, keyless: values.keyless, rename, update: values.update,
+            commitEvery: values['commit-every'] ? Number(values['commit-every']) : undefined,
+        });
+        console.log(JSON.stringify(r, null, 2));
+        return r.verify.ok ? 0 : 1;
+    }
+    // загрузчику нужно администраторское подключение (§2.6, п. 1)
+    const db = await connect({ dsn: values.dsn, schema: values.schema, token: values.token, apiKey: values['api-key'], max: 2,
+        // verify и maintain работают и на администраторском подключении без сессии
+        ...(cmd === 'load' || cmd === 'verify' || cmd === 'maintain' ? { allowBypassRls: true } : {}) });
+    try {
+        if (cmd === 'sync') {
+            if (!arg) {
+                console.log(USAGE);
+                return 2;
+            }
+            const mod = await import(pathToFileURL(resolve(arg)).href);
+            const models = [...new Set(Object.values(mod).flatMap((v) => (Array.isArray(v) ? v : [v])).filter(isModel))];
+            const r = await syncModels(db, models, { apply: values.apply });
+            console.log(`${r.applied ? 'применено' : 'сухой прогон'}: создать ${r.created.length}, изменить ${r.updated.length}, без изменений ${r.unchanged.length}, системных ${r.skipped.length}`);
+            for (const [k, list] of [['создать', r.created], ['изменить', r.updated], ['системные (меняет установка)', r.skipped]]) {
+                if (list.length)
+                    console.log(`  ${k}: ${list.join(', ')}`);
+            }
+            for (const l of r.lost)
+                console.log(`  правило ${l.kind} в ${l.path} проверяется только в библиотеке — в базе его нет`);
+            return 0;
+        }
+        if (cmd === 'load') {
+            const files = positionals.slice(1);
+            if (!files.length) {
+                console.log(USAGE);
+                return 2;
+            }
+            if (values.trust)
+                throw new Error('letopis: removed: --trust снят в 1.0.0 — запрос по целям вне загрузки стоит 0,1–1,3 % её времени');
+            // несколько файлов — одна загрузка и одна транзакция; в файле — объект на строку
+            const rows = [];
+            for (const f of files) {
+                for (const line of (await readFile(f, 'utf8')).split(/\r?\n/))
+                    if (line.trim())
+                        rows.push(JSON.parse(line));
+            }
+            const r = await db.load(rows, {
+                class: values.class,
+                duplicates: values.duplicates,
+                existing: values.existing,
+                commitEvery: values['commit-every'] ? Number(values['commit-every']) : undefined,
+                verify: values.verify,
+            });
+            console.log(JSON.stringify(r));
+            return 0;
+        }
+        if (cmd === 'verify') {
+            const r = await db.verify({ data: values.data });
+            console.log(JSON.stringify(r, null, 2));
+            return r.ok ? 0 : 1;
+        }
+        if (cmd === 'maintain') {
+            const r = await db.maintain({ batches: values.batches ? Number(values.batches) : undefined });
+            console.log(JSON.stringify(r));
+            return 0;
+        }
+        if (cmd === 'describe') {
+            const d = db.describe();
+            const text = values.format === 'text' ? describeText(d) : JSON.stringify(d, null, 2);
+            if (values.out)
+                await writeFile(values.out, text);
+            else
+                console.log(text);
+            return 0;
+        }
+        if (cmd === 'types') {
+            const text = generateTypes(db.registry);
+            if (values.out)
+                await writeFile(values.out, text);
+            else
+                console.log(text);
+            return 0;
+        }
+        console.log(USAGE);
+        return 2;
+    }
+    finally {
+        await db.close();
+    }
+}
+if (import.meta.url === pathToFileURL(process.argv[1] ?? '').href) {
+    main(process.argv.slice(2)).then((code) => process.exit(code), (e) => {
+        console.error(e.message);
+        const rows = e.detail?.rows;
+        if (rows)
+            console.error(JSON.stringify(rows, null, 2));
+        process.exit(1);
+    });
+}

package/dist/demo/booking.d.ts

@@ -0,0 +1,289 @@
+import { type AnyModel } from '../model.js';
+export declare const Org: import("../model.js").Model<"Org", {
+    name: string;
+    timezone: string;
+    active: boolean;
+    address?: string | undefined;
+    phone?: string | undefined;
+    settings?: {
+        booking?: {
+            autoconfirm: boolean;
+            deposit?: {
+                amount: number;
+                currency: "RUB" | "USD" | "EUR" | "AED";
+            } | undefined;
+        } | undefined;
+    } | undefined;
+}, {} & {}, "Организация">;
+export declare const Person: import("../model.js").Model<"Person", {
+    name: string;
+    phone: string;
+}, {
+    readonly Org: string;
+} & {}, "Контрагент">;
+export declare const Staff: import("../model.js").Model<"Staff", Omit<{
+    name: string;
+    phone: string;
+}, "description" | "photo" | "specialization"> & {
+    photo?: string | undefined;
+    description?: string | undefined;
+    specialization?: string | undefined;
+}, Omit<{
+    readonly Org: string;
+} & {}, never> & {} & {}, "Мастер">;
+export declare const Customer: import("../model.js").Model<"Customer", Omit<{
+    name: string;
+    phone: string;
+}, "notes" | "preferred_contact"> & {
+    preferred_contact: "email" | "phone" | "messenger";
+    notes?: string | undefined;
+}, Omit<{
+    readonly Org: string;
+} & {}, never> & {} & {}, "Клиент">;
+export declare const Location: import("../model.js").Model<"Location", {
+    address: string;
+    coordinates?: {
+        lat: number;
+        lng: number;
+    } | undefined;
+    description?: string | undefined;
+}, {
+    readonly Org: string;
+} & {}, "Локация">;
+export declare const Element: import("../model.js").Model<"Element", {
+    name: string;
+    description?: string | undefined;
+}, {
+    readonly Org: string;
+} & {}, "Элемент">;
+export declare const Service: import("../model.js").Model<"Service", Omit<{
+    name: string;
+    description?: string | undefined;
+}, "duration"> & {
+    duration?: number | undefined;
+}, Omit<{
+    readonly Org: string;
+} & {}, never> & {} & {}, "Услуга">;
+export declare const Product: import("../model.js").Model<"Product", Omit<{
+    name: string;
+    description?: string | undefined;
+}, "sku" | "unit"> & {
+    unit: string;
+    sku?: string | undefined;
+}, Omit<{
+    readonly Org: string;
+} & {}, never> & {} & {}, "Товар">;
+export declare const Complex: import("../model.js").Model<"Complex", Omit<{
+    name: string;
+    description?: string | undefined;
+}, "duration" | "cost"> & {
+    cost: number;
+    duration: number;
+}, Omit<{
+    readonly Org: string;
+} & {}, never> & {} & {}, "Комплекс">;
+export declare const Schedule: import("../model.js").Model<"Schedule", {
+    name: string;
+    year: number;
+    month: number;
+}, {
+    readonly Org: string;
+} & {}, "Расписание">;
+export declare const Folder: import("../model.js").Model<"Folder", {
+    name: string;
+}, {
+    readonly Org: string;
+} & {
+    readonly Parent?: string | undefined;
+}, "Папка">;
+export declare const address: import("../model.js").Model<"address", {
+    default: boolean;
+    schedule_info?: string | undefined;
+}, {
+    readonly Staff: string;
+    readonly Location: string;
+} & {}, "адрес">;
+export declare const slot: import("../model.js").Model<"slot", {
+    start_datetime: string;
+    end_datetime: string;
+}, {
+    readonly Staff: string;
+    readonly Location: string;
+    readonly Schedule: string;
+} & {}, "окно">;
+export declare const booking: import("../model.js").Model<"booking", Omit<{
+    start_datetime: string;
+    end_datetime: string;
+}, "notes"> & {
+    notes?: string | undefined;
+}, Omit<{
+    readonly Staff: string;
+    readonly Location: string;
+    readonly Schedule: string;
+} & {}, "Customer" | "Item"> & {
+    readonly Item: string;
+} & {
+    readonly Customer?: string | undefined;
+}, "запись">;
+export declare const content: import("../model.js").Model<"content", {
+    order: number;
+}, {
+    readonly Folder: string;
+    readonly Item: string;
+} & {}, "содержимое">;
+export declare const compo: import("../model.js").Model<"compo", {
+    order: number;
+    quantity: number;
+}, {
+    readonly Complex: string;
+    readonly Part: string;
+} & {}, "состав">;
+export declare const skill: import("../model.js").Model<"skill", {
+    level: "basic" | "intermediate" | "advanced" | "expert";
+}, {
+    readonly Staff: string;
+    readonly Service: string;
+} & {}, "навык">;
+export declare const price: import("../model.js").Model<"price", {
+    note: string;
+    amounts: Partial<Record<"RUB" | "USD" | "EUR" | "AED", number>>;
+}, {
+    readonly Item: string;
+} & {}, "цена">;
+/** Все классы в порядке «предок раньше потомка». */
+export declare const BOOKING: readonly [import("../model.js").Model<"Org", {
+    name: string;
+    timezone: string;
+    active: boolean;
+    address?: string | undefined;
+    phone?: string | undefined;
+    settings?: {
+        booking?: {
+            autoconfirm: boolean;
+            deposit?: {
+                amount: number;
+                currency: "RUB" | "USD" | "EUR" | "AED";
+            } | undefined;
+        } | undefined;
+    } | undefined;
+}, {} & {}, "Организация">, import("../model.js").Model<"Person", {
+    name: string;
+    phone: string;
+}, {
+    readonly Org: string;
+} & {}, "Контрагент">, import("../model.js").Model<"Staff", Omit<{
+    name: string;
+    phone: string;
+}, "description" | "photo" | "specialization"> & {
+    photo?: string | undefined;
+    description?: string | undefined;
+    specialization?: string | undefined;
+}, Omit<{
+    readonly Org: string;
+} & {}, never> & {} & {}, "Мастер">, import("../model.js").Model<"Customer", Omit<{
+    name: string;
+    phone: string;
+}, "notes" | "preferred_contact"> & {
+    preferred_contact: "email" | "phone" | "messenger";
+    notes?: string | undefined;
+}, Omit<{
+    readonly Org: string;
+} & {}, never> & {} & {}, "Клиент">, import("../model.js").Model<"Location", {
+    address: string;
+    coordinates?: {
+        lat: number;
+        lng: number;
+    } | undefined;
+    description?: string | undefined;
+}, {
+    readonly Org: string;
+} & {}, "Локация">, import("../model.js").Model<"Element", {
+    name: string;
+    description?: string | undefined;
+}, {
+    readonly Org: string;
+} & {}, "Элемент">, import("../model.js").Model<"Service", Omit<{
+    name: string;
+    description?: string | undefined;
+}, "duration"> & {
+    duration?: number | undefined;
+}, Omit<{
+    readonly Org: string;
+} & {}, never> & {} & {}, "Услуга">, import("../model.js").Model<"Product", Omit<{
+    name: string;
+    description?: string | undefined;
+}, "sku" | "unit"> & {
+    unit: string;
+    sku?: string | undefined;
+}, Omit<{
+    readonly Org: string;
+} & {}, never> & {} & {}, "Товар">, import("../model.js").Model<"Complex", Omit<{
+    name: string;
+    description?: string | undefined;
+}, "duration" | "cost"> & {
+    cost: number;
+    duration: number;
+}, Omit<{
+    readonly Org: string;
+} & {}, never> & {} & {}, "Комплекс">, import("../model.js").Model<"Schedule", {
+    name: string;
+    year: number;
+    month: number;
+}, {
+    readonly Org: string;
+} & {}, "Расписание">, import("../model.js").Model<"Folder", {
+    name: string;
+}, {
+    readonly Org: string;
+} & {
+    readonly Parent?: string | undefined;
+}, "Папка">, import("../model.js").Model<"address", {
+    default: boolean;
+    schedule_info?: string | undefined;
+}, {
+    readonly Staff: string;
+    readonly Location: string;
+} & {}, "адрес">, import("../model.js").Model<"slot", {
+    start_datetime: string;
+    end_datetime: string;
+}, {
+    readonly Staff: string;
+    readonly Location: string;
+    readonly Schedule: string;
+} & {}, "окно">, import("../model.js").Model<"booking", Omit<{
+    start_datetime: string;
+    end_datetime: string;
+}, "notes"> & {
+    notes?: string | undefined;
+}, Omit<{
+    readonly Staff: string;
+    readonly Location: string;
+    readonly Schedule: string;
+} & {}, "Customer" | "Item"> & {
+    readonly Item: string;
+} & {
+    readonly Customer?: string | undefined;
+}, "запись">, import("../model.js").Model<"content", {
+    order: number;
+}, {
+    readonly Folder: string;
+    readonly Item: string;
+} & {}, "содержимое">, import("../model.js").Model<"compo", {
+    order: number;
+    quantity: number;
+}, {
+    readonly Complex: string;
+    readonly Part: string;
+} & {}, "состав">, import("../model.js").Model<"skill", {
+    level: "basic" | "intermediate" | "advanced" | "expert";
+}, {
+    readonly Staff: string;
+    readonly Service: string;
+} & {}, "навык">, import("../model.js").Model<"price", {
+    note: string;
+    amounts: Partial<Record<"RUB" | "USD" | "EUR" | "AED", number>>;
+}, {
+    readonly Item: string;
+} & {}, "цена">];
+/** Текст lib/sql/seed.booking.sql: строки Class системного арендатора, записанные владельцем. */
+export declare function bookingSeedSql(models?: readonly AnyModel[]): string;

package/dist/demo/booking.js

@@ -0,0 +1,159 @@
+/**
+ * Демо-домен booking на Zod (план, этап 2, п. 8): 18 классов 0.21 (`lib/sql/seed.booking.sql` тега
+ * v0.21.0) без корней `Entity` и `link` — они несли только правило id v7.
+ * - Ключи взяты из правил id 0.21: классы с v5 сохраняют поля ключа, классы с v4 и v7 — без ключа.
+ * - Концы получили имена ролей. Союз всех потомков Element стал полиморфным концом `Item: one(Element)`;
+ *   союз Service|Product в составе комплекса — `Part`; самоссылка Folder — `Parent`.
+ * - description, appearance и order 0.21 перешли в meta (§2.13).
+ * Из моделей генерируется lib/sql/seed.booking.sql (`npm run seed:booking`).
+ */
+import { z } from 'zod';
+import { hub, link, one } from '../model.js';
+const CURRENCY = z.enum(['RUB', 'USD', 'EUR', 'AED']);
+const meta = (description, icon, color, order) => ({ description, icon, color, order });
+export const Org = hub('Org', {
+    alias: 'Организация',
+    fields: z.object({
+        name: z.string(),
+        timezone: z.string().default('Europe/Moscow'),
+        address: z.string().optional(),
+        phone: z.string().optional(),
+        active: z.boolean().default(true),
+        settings: z.strictObject({
+            booking: z.strictObject({
+                deposit: z.strictObject({ amount: z.number().int().min(0).default(0), currency: CURRENCY.default('RUB') }).optional(),
+                autoconfirm: z.boolean().default(false),
+            }).optional(),
+        }).optional(),
+    }),
+    meta: meta('Организация — арендатор: владелец каталога, локаций и расписаний; settings — вложенные настройки (глубина 4)', 'mdi:domain', 'text-blue-600', 200),
+});
+export const Person = hub('Person', {
+    alias: 'Контрагент',
+    abstract: true,
+    ends: { Org },
+    fields: z.object({ name: z.string(), phone: z.string() }),
+    meta: meta('Абстрактный контрагент: имя и телефон; наследуют Мастер и Клиент', 'mdi:account-outline', 'text-blue-500', 300),
+});
+export const Staff = hub('Staff', {
+    alias: 'Мастер',
+    extends: Person,
+    fields: z.object({ photo: z.string().optional(), description: z.string().optional(), specialization: z.string().optional() }),
+    meta: meta('Мастер — бронируемый исполнитель; локации — связь адрес, доступность — связь окно', 'mdi:account-star', 'text-indigo-500', 400),
+});
+export const Customer = hub('Customer', {
+    alias: 'Клиент',
+    extends: Person,
+    fields: z.object({ notes: z.string().optional(), preferred_contact: z.enum(['phone', 'email', 'messenger']).default('phone') }),
+    meta: meta('Клиент — записывается на услуги', 'mdi:account', 'text-green-500', 500),
+});
+export const Location = hub('Location', {
+    alias: 'Локация',
+    ends: { Org },
+    fields: z.object({ address: z.string(), coordinates: z.object({ lat: z.number(), lng: z.number() }).optional(), description: z.string().optional() }),
+    meta: meta('Локация — точка обслуживания организации', 'mdi:map-marker', 'text-red-500', 600),
+});
+export const Element = hub('Element', {
+    alias: 'Элемент',
+    abstract: true,
+    ends: { Org },
+    fields: z.object({ name: z.string(), description: z.string().optional() }),
+    key: ['Org', 'name'],
+    meta: meta('Абстрактная каталожная единица (Услуга, Товар, Комплекс): имя уникально в организации; цена — связь цена', 'mdi:view-list', 'text-teal-500', 700),
+});
+export const Service = hub('Service', {
+    alias: 'Услуга',
+    extends: Element,
+    fields: z.object({ duration: z.number().min(0).optional() }),
+    meta: meta('Услуга: длительность в минутах', 'mdi:spa', 'text-purple-500', 800),
+});
+export const Product = hub('Product', {
+    alias: 'Товар',
+    extends: Element,
+    fields: z.object({ sku: z.string().optional(), unit: z.string().default('шт') }),
+    meta: meta('Товар: артикул и единица измерения', 'mdi:package', 'text-blue-400', 900),
+});
+export const Complex = hub('Complex', {
+    alias: 'Комплекс',
+    extends: Element,
+    fields: z.object({ cost: z.number().min(0), duration: z.number().min(0) }),
+    meta: meta('Комплекс: собственные стоимость и длительность; состав — связь состав', 'mdi:package-variant-closed', 'text-orange-500', 1000),
+});
+export const Schedule = hub('Schedule', {
+    alias: 'Расписание',
+    ends: { Org },
+    fields: z.object({ name: z.string(), year: z.number().int(), month: z.number().int().min(1).max(12) }),
+    meta: meta('Месячное расписание организации; наполнение — связь окно', 'mdi:calendar', 'text-cyan-500', 1100),
+});
+export const Folder = hub('Folder', {
+    alias: 'Папка',
+    ends: { Org, Parent: one('Folder').optional() },
+    fields: z.object({ name: z.string() }),
+    meta: meta('Папка-категория; вложенность — конец Parent на родительскую папку; наполнение — связь содержимое', 'mdi:folder', 'text-yellow-500', 1200),
+});
+export const address = link('address', {
+    alias: 'адрес',
+    ends: { Staff, Location },
+    fields: z.object({ default: z.boolean().default(false), schedule_info: z.string().optional() }),
+    key: ['Staff', 'Location'],
+    meta: meta('Адрес: Мастер работает в Локации; default — основная точка мастера', 'mdi:link', 'text-sky-500', 200),
+});
+export const slot = link('slot', {
+    alias: 'окно',
+    ends: { Staff, Location, Schedule },
+    fields: z.object({ start_datetime: z.iso.datetime({ precision: 3 }), end_datetime: z.iso.datetime({ precision: 3 }) }),
+    key: ['Staff', 'start_datetime'],
+    meta: meta('Окно доступности: Мастер × Локация × Расписание и интервал; мастер не задваивает время', 'mdi:clock-outline', 'text-amber-500', 300),
+});
+export const booking = link('booking', {
+    alias: 'запись',
+    extends: slot,
+    ends: { Item: one(Element), Customer: one(Customer).optional() },
+    onDelete: { Customer: 'unset' },
+    fields: z.object({ notes: z.string().optional() }),
+    meta: meta('Запись — наследник окна: бронь мастера на элемент каталога для клиента; ручная бронь — без клиента', 'mdi:calendar-check', 'text-emerald-500', 400),
+});
+export const content = link('content', {
+    alias: 'содержимое',
+    ends: { Folder, Item: one(Element) },
+    fields: z.object({ order: z.number().int().default(0) }),
+    key: ['Folder', 'Item'],
+    meta: meta('Содержимое папки: элемент может лежать в нескольких папках', 'mdi:link', 'text-sky-500', 500),
+});
+export const compo = link('compo', {
+    alias: 'состав',
+    ends: { Complex, Part: one(Service, Product) },
+    fields: z.object({ order: z.number().int().default(0), quantity: z.number().int().min(1).default(1) }),
+    key: ['Complex', 'Part'],
+    meta: meta('Состав комплекса: услуги и товары с порядком и количеством', 'mdi:link', 'text-sky-500', 600),
+});
+export const skill = link('skill', {
+    alias: 'навык',
+    ends: { Staff, Service },
+    fields: z.object({ level: z.enum(['basic', 'intermediate', 'advanced', 'expert']).default('intermediate') }),
+    key: ['Staff', 'Service'],
+    meta: meta('Навык: Мастер умеет Услугу; умение комплекса вычислимо по составу', 'mdi:link', 'text-sky-500', 700),
+});
+export const price = link('price', {
+    alias: 'цена',
+    ends: { Item: one(Element) },
+    fields: z.object({ note: z.string().default('базовая'), amounts: z.partialRecord(CURRENCY, z.number().int().min(0)) }),
+    key: ['Item', 'note'],
+    meta: meta('Вариант цены элемента: мультивалютные суммы и описание варианта', 'mdi:cash-multiple', 'text-green-600', 800),
+});
+/** Все классы в порядке «предок раньше потомка». */
+export const BOOKING = [Org, Person, Staff, Customer, Location, Element, Service, Product, Complex, Schedule, Folder,
+    address, slot, booking, content, compo, skill, price];
+/** Текст lib/sql/seed.booking.sql: строки Class системного арендатора, записанные владельцем. */
+export function bookingSeedSql(models = BOOKING) {
+    const lines = [
+        '-- letopis 1.0 — демо-домен booking (план, этап 2, п. 8). Сгенерировано из lib/src/demo/booking.ts',
+        '-- командой `npm run seed:booking`; руками не править. Классы — системного арендатора, пишет владелец.',
+        '',
+    ];
+    for (const m of models) {
+        const json = JSON.stringify(m.describe());
+        lines.push(`select @SCHEMA@.sys_create(@SCHEMA@.v5_id('@SYSTEM@'::uuid, 'Class', array['${m.name}']), 'Class', '@SYSTEM@'::uuid, '{}',\n  $json$${json}$json$::jsonb);`);
+    }
+    return lines.join('\n') + '\n';
+}

package/dist/errors.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Ошибки letopis 1.0 (план, §7.1, этап 2, п. 10). Текст — «letopis: <код>: <сообщение>», как у ошибок
+ * базы; код — имя из каталога (`error_catalog()` в lib/sql/15-errors.sql) или код самой библиотеки.
+ */
+/** Нарушение правила данных: путь, ключевое слово JSON Schema, сообщение. Один формат для Zod, валидатора и базы. */
+export interface Issue {
+    path: (string | number)[];
+    keyword: string;
+    message: string;
+}
+export declare class LetopisError extends Error {
+    readonly code: string;
+    readonly detail: unknown;
+    constructor(code: string, message: string, detail?: unknown);
+}
+/** Охранник снесённого API (план, этап 3, п. 11): понятная ошибка с версией и заменой. */
+export declare function removed(name: string, replacement: string): LetopisError;
+/** Метод зарезервирован, но появится на следующем этапе плана. */
+export declare function notYet(name: string, stage: number): LetopisError;
+/** Данные не проходят описание класса (`invalid_data`). */
+export declare class ValidationError extends LetopisError {
+    readonly issues: Issue[];
+    constructor(cls: string, issues: Issue[]);
+}
+/**
+ * Ошибка базы → LetopisError (ValidationError для invalid_data с нарушениями). Детали из DETAIL
+ * (JSON) переносятся в detail; прочие ошибки возвращаются как есть.
+ */
+export declare function fromDbError(e: unknown): unknown;