@kollors/deep-json-server 1.0.0-alpha.1 → 1.0.0-alpha.10

package/dist/src/auth/store.js

@@ -0,0 +1,82 @@
+import { JSONFile } from 'lowdb/node';
+import { domainError } from '../core/errors.js';
+import { createSerialQueue, hasOnlyKeys, isObject } from '../core/utils.js';
+import { MAX_USERNAME_LENGTH } from './contract.js';
+import { validPasswordHash } from './password.js';
+/** Проверяет записи и строит индексы по двум уникальным строковым ключам.
+ * @example Две записи с разными id и username → два индекса; повторяющийся ключ → ошибка.
+ */
+function indexUsers(records) {
+    if (!Array.isArray(records))
+        throw new Error('Auth users must be an array');
+    const byId = new Map();
+    const byUsername = new Map();
+    for (const record of records) {
+        if (!isObject(record) ||
+            !hasOnlyKeys(record, ['id', 'username', 'passwordHash', 'isAdmin']) ||
+            typeof record.id !== 'string' ||
+            !record.id.trim() ||
+            typeof record.username !== 'string' ||
+            !record.username.trim() ||
+            record.username.length > MAX_USERNAME_LENGTH ||
+            !validPasswordHash(record.passwordHash) ||
+            (record.isAdmin !== undefined && typeof record.isAdmin !== 'boolean'))
+            throw new Error('Auth users require id, username and a valid passwordHash');
+        if (byId.has(record.id) || byUsername.has(record.username))
+            throw new Error('Auth user ids and usernames must be unique');
+        const user = Object.freeze({ id: record.id, username: record.username, passwordHash: record.passwordHash, isAdmin: record.isAdmin ?? false });
+        byId.set(user.id, user);
+        byUsername.set(user.username, user);
+    }
+    return { byId, byUsername };
+}
+/** Хранит подтверждённые записи и последовательно сохраняет изменения одного пользователя. */
+export class AuthStore {
+    users;
+    file;
+    schedule = createSerialQueue();
+    constructor(users, file) {
+        this.users = users;
+        this.file = file;
+    }
+    /** Возвращает индексы последнего успешно сохранённого состояния.
+     * @example Во время записи нового пароля read() ещё возвращает запись с прежним хешем.
+     */
+    read() {
+        return this.users;
+    }
+    /** Проверяет изменение внутри очереди и публикует его после записи; обработчик подтверждения вызывается синхронно.
+     * @example Успешная запись → новый пользователь; ошибка файла → прежние индексы, обработчик не вызван.
+     */
+    update(operation, committed) {
+        return this.schedule(async () => {
+            const user = Object.freeze(operation(this.users));
+            const owner = this.users.byUsername.get(user.username);
+            if (owner && owner.id !== user.id)
+                throw domainError('CONFLICT', 'Username already exists');
+            const byId = new Map(this.users.byId);
+            const byUsername = new Map(this.users.byUsername);
+            const previous = byId.get(user.id);
+            if (previous)
+                byUsername.delete(previous.username);
+            byId.set(user.id, user);
+            byUsername.set(user.username, user);
+            if (this.file)
+                await this.file.write([...byId.values()]);
+            this.users = { byId, byUsername };
+            committed?.();
+            return user;
+        });
+    }
+}
+/** Загружает массив из файла или памяти и подключает запись в тот же источник.
+ * @example Массив → хранилище в памяти; 'users.json' → чтение и сохранение JSON-массива через JSONFile.
+ */
+export async function createAuthStore(source) {
+    const file = typeof source === 'string' ? new JSONFile(source) : undefined;
+    const records = file ? await file.read() : source;
+    if (file && records === null)
+        throw new Error(`Auth users file not found: ${source}`);
+    return new AuthStore(indexUsers(records), file);
+}
+//# sourceMappingURL=store.js.map

package/dist/src/auth/store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.js","sourceRoot":"","sources":["../../../src/auth/store.ts"],"names":[],"mappings":"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"}

package/dist/src/cli/index.d.ts

@@ -0,0 +1,7 @@
+import { createConfiguredServer } from '../server/create.js';
+/** Разбирает флаги, выполняет экспорт по секциям конфигурации и при необходимости запускает сервер.
+ * @example runCli(['--generate-only', 'config.mjs']) → файлы схем без открытия порта.
+ */
+export declare function runCli(args?: string[], services?: {
+    createServer: typeof createConfiguredServer;
+}): Promise<void>;

package/dist/src/cli/index.js

@@ -0,0 +1,122 @@
+import process from 'node:process';
+import { DEFAULT_HOST, DEFAULT_PORT, VERSION } from '../core/constants.js';
+import { inputPaths, validateExportPaths } from '../core/paths.js';
+import { isObject } from '../core/utils.js';
+import { writeGraphql } from '../graphql/entry.js';
+import { writeOpenapi } from '../openapi/entry.js';
+import { configure, readConfigModule } from '../server/config.js';
+import { createConfiguredServer } from '../server/create.js';
+import { configuredModel } from '../server/model.js';
+const HELP_TEXT = `Deep JSON Server
+
+Usage:
+  deep-json-server [options] <server.config.js>
+
+  --generate       Export configured schemas, then start the server
+  --generate-only  Export configured schemas and exit
+  --host <host>    Server address
+  --port <port>    Server port
+  --help, -h       Show help
+  --version, -v    Show version
+
+Modules and export formats are selected by configuration sections.
+Generate flags are mutually exclusive and require output targets.`;
+/** Проверяет все назначения, строит обе схемы и только затем сохраняет файлы.
+ * @example Секции openapi и graphql с target → два файла; нет target → ошибка до записи.
+ */
+async function generate(config, source, directory, sourcePath) {
+    if (!config.openapi && !config.graphql)
+        throw new Error('Generation requires an openapi or graphql section');
+    const outputs = [];
+    for (const format of ['openapi', 'graphql']) {
+        if (!config[format])
+            continue;
+        const target = config[format].target;
+        if (!target)
+            throw new Error(`Укажите config.${format}.target`);
+        outputs.push(target);
+    }
+    await validateExportPaths(outputs, inputPaths(source, directory, sourcePath));
+    const model = await configuredModel(config);
+    const openapi = config.openapi
+        ? (await import('../openapi/generate.js')).openapiFromModel(model, {
+            files: config.files !== undefined,
+            auth: config.auth !== undefined,
+            host: config.server.host,
+            port: config.server.port,
+            pageSize: config.server.pageSize,
+            maxPageSize: config.server.maxPageSize,
+            info: config.openapi.info,
+        })
+        : undefined;
+    const graphql = config.graphql ? (await import('../graphql/generate.js')).graphqlFromModel(model) : undefined;
+    if (openapi && config.openapi?.target) {
+        await writeOpenapi(openapi, config.openapi.target);
+        process.stdout.write(`OpenAPI: ${config.openapi.target}\n`);
+    }
+    if (graphql && config.graphql?.target) {
+        await writeGraphql(graphql, config.graphql.target);
+        process.stdout.write(`GraphQL: ${config.graphql.target}\n`);
+    }
+}
+/** Разбирает флаги, выполняет экспорт по секциям конфигурации и при необходимости запускает сервер.
+ * @example runCli(['--generate-only', 'config.mjs']) → файлы схем без открытия порта.
+ */
+export async function runCli(args = process.argv.slice(2), services = { createServer: createConfiguredServer }) {
+    if (args.includes('--help') || args.includes('-h')) {
+        process.stdout.write(`${HELP_TEXT}\n`);
+        return;
+    }
+    if (args.includes('--version') || args.includes('-v')) {
+        process.stdout.write(`${VERSION}\n`);
+        return;
+    }
+    const positional = [];
+    const seen = new Set();
+    let host;
+    let port;
+    for (let index = 0; index < args.length; index++) {
+        const arg = args[index];
+        if (!arg.startsWith('-')) {
+            positional.push(arg);
+            continue;
+        }
+        if (!['--generate', '--generate-only', '--host', '--port'].includes(arg) || seen.has(arg))
+            throw new Error(`Неизвестный параметр или повтор: ${arg}`);
+        seen.add(arg);
+        if (arg === '--host' || arg === '--port') {
+            const value = args[++index];
+            if (!value || value.startsWith('-'))
+                throw new Error(`Укажите значение ${arg}`);
+            if (arg === '--host')
+                host = value;
+            else {
+                if (!/^\d+$/.test(value))
+                    throw new Error('Invalid --port');
+                port = Number(value);
+            }
+        }
+    }
+    if (seen.has('--generate') && seen.has('--generate-only'))
+        throw new Error('--generate and --generate-only are mutually exclusive');
+    if (!positional.length)
+        throw new Error('Укажите путь к файлу конфигурации');
+    if (positional.length !== 1)
+        throw new Error('Можно указать только один файл конфигурации');
+    const source = await readConfigModule(positional[0]);
+    const server = source.config.server ?? {};
+    if (!isObject(server))
+        throw new Error('config.server must be an object');
+    const config = configure({
+        ...source.config,
+        server: { ...server, host: host ?? server.host ?? process.env.HOST ?? DEFAULT_HOST, port: port ?? server.port ?? Number(process.env.PORT ?? DEFAULT_PORT) },
+    }, source.directory, source.path);
+    if (seen.has('--generate') || seen.has('--generate-only'))
+        await generate(config, source.config, source.directory, source.path);
+    if (seen.has('--generate-only'))
+        return;
+    const app = (await services.createServer(config)).fastify();
+    await app.listen();
+    app.log.info('Deep JSON Server started');
+}
+//# sourceMappingURL=index.js.map

package/dist/src/cli/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/cli/index.ts"],"names":[],"mappings":"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"}

package/dist/src/core/config-values.d.ts

@@ -0,0 +1,28 @@
+/** Проверяет объект и обязательность значения; необязательные null и undefined пропускает.
+ * @example getObject(undefined, 'data') → undefined; getObject([], 'data', true) → ошибка.
+ */
+export declare function getObject(value: unknown, path: string, required: true): Record<string, unknown>;
+export declare function getObject(value: unknown, path: string, required?: false): Record<string, unknown> | undefined;
+/** Проверяет непустую строку, не обрезая её; необязательные null и undefined пропускает.
+ * @example getString(' a ', 'name') → ' a '; getString('', 'name') → ошибка.
+ */
+export declare function getString(value: unknown, path: string, required: true): string;
+export declare function getString(value: unknown, path: string, required?: false): string | undefined;
+/** Принимает положительное безопасное целое число или отсутствие значения.
+ * @example getPositiveInteger(2, 'size') → 2; getPositiveInteger(0, 'size') → ошибка.
+ */
+export declare const getPositiveInteger: (value: unknown, path: string) => number | undefined;
+/** Проверяет необязательный логический флаг, не преобразуя строки в boolean.
+ * @example getBoolean(false, 'flag') → false; getBoolean('false', 'flag') → ошибка.
+ */
+export declare function getBoolean(value: unknown, path: string): boolean | undefined;
+/** Проверяет адрес и порт и подставляет значения по умолчанию.
+ * @example normalizeAddress({ port: 0 }) → { host: '127.0.0.1', port: 0 }.
+ */
+export declare function normalizeAddress(options: {
+    host?: unknown;
+    port?: unknown;
+}): {
+    host: string;
+    port: number;
+};

package/dist/src/core/config-values.js

@@ -0,0 +1,53 @@
+import { DEFAULT_HOST, DEFAULT_PORT } from './constants.js';
+import { isObject, isPortNumber } from './utils.js';
+export function getObject(value, path, required = false) {
+    if (value == null && !required) {
+        return undefined;
+    }
+    if (!isObject(value)) {
+        throw new Error(`Ключ ${path} должен быть JSON-объектом`);
+    }
+    return value;
+}
+export function getString(value, path, required = false) {
+    if (value == null && !required) {
+        return undefined;
+    }
+    if (typeof value !== 'string' || value.trim() === '') {
+        throw new Error(`Ключ ${path} должен содержать непустую строку`);
+    }
+    return value;
+}
+/** Принимает положительное безопасное целое число или отсутствие значения.
+ * @example getPositiveInteger(2, 'size') → 2; getPositiveInteger(0, 'size') → ошибка.
+ */
+export const getPositiveInteger = (value, path) => {
+    if (value == null) {
+        return undefined;
+    }
+    if (typeof value !== 'number' || !Number.isSafeInteger(value) || value < 1) {
+        throw new Error(`Ключ ${path} должен быть положительным целым числом`);
+    }
+    return value;
+};
+/** Проверяет необязательный логический флаг, не преобразуя строки в boolean.
+ * @example getBoolean(false, 'flag') → false; getBoolean('false', 'flag') → ошибка.
+ */
+export function getBoolean(value, path) {
+    if (value === undefined)
+        return undefined;
+    if (typeof value !== 'boolean')
+        throw new Error(`${path} must be boolean`);
+    return value;
+}
+/** Проверяет адрес и порт и подставляет значения по умолчанию.
+ * @example normalizeAddress({ port: 0 }) → { host: '127.0.0.1', port: 0 }.
+ */
+export function normalizeAddress(options) {
+    const host = getString(options.host, 'config.server.host') ?? DEFAULT_HOST;
+    const port = options.port ?? DEFAULT_PORT;
+    if (!isPortNumber(port))
+        throw new Error('Ключ config.server.port должен быть целым числом от 0 до 65535');
+    return { host, port };
+}
+//# sourceMappingURL=config-values.js.map

package/dist/src/core/config-values.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-values.js","sourceRoot":"","sources":["../../../src/core/config-values.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC5D,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAOpD,MAAM,UAAU,SAAS,CAAC,KAAc,EAAE,IAAY,EAAE,QAAQ,GAAG,KAAK;IACtE,IAAI,KAAK,IAAI,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;QAC/B,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;QACrB,MAAM,IAAI,KAAK,CAAC,QAAQ,IAAI,4BAA4B,CAAC,CAAC;IAC5D,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC;AAOD,MAAM,UAAU,SAAS,CAAC,KAAc,EAAE,IAAY,EAAE,QAAQ,GAAG,KAAK;IACtE,IAAI,KAAK,IAAI,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;QAC/B,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;QACrD,MAAM,IAAI,KAAK,CAAC,QAAQ,IAAI,mCAAmC,CAAC,CAAC;IACnE,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,KAAc,EAAE,IAAY,EAAsB,EAAE;IACrF,IAAI,KAAK,IAAI,IAAI,EAAE,CAAC;QAClB,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,KAAK,CAAC,IAAI,KAAK,GAAG,CAAC,EAAE,CAAC;QAC3E,MAAM,IAAI,KAAK,CAAC,QAAQ,IAAI,yCAAyC,CAAC,CAAC;IACzE,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC,CAAC;AAEF;;GAEG;AACH,MAAM,UAAU,UAAU,CAAC,KAAc,EAAE,IAAY;IACrD,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IAC1C,IAAI,OAAO,KAAK,KAAK,SAAS;QAAE,MAAM,IAAI,KAAK,CAAC,GAAG,IAAI,kBAAkB,CAAC,CAAC;IAC3E,OAAO,KAAK,CAAC;AACf,CAAC;AACD;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAAC,OAA2C;IAC1E,MAAM,IAAI,GAAG,SAAS,CAAC,OAAO,CAAC,IAAI,EAAE,oBAAoB,CAAC,IAAI,YAAY,CAAC;IAC3E,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,IAAI,YAAY,CAAC;IAC1C,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,gEAAgE,CAAC,CAAC;IAC3G,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;AACxB,CAAC"}

package/dist/src/{constants.d.ts → core/constants.d.ts}

@@ -3,3 +3,4 @@ export declare const DEFAULT_MAX_FILE_SIZE: number;
 export declare const DEFAULT_MAX_PAGE_SIZE = 100;
 export declare const DEFAULT_PAGE_SIZE = 10;
 export declare const DEFAULT_PORT = 4001;
+export declare const VERSION = "1.0.0-alpha.10";

package/dist/src/{constants.js → core/constants.js}

@@ -3,4 +3,5 @@ export const DEFAULT_MAX_FILE_SIZE = 100 * 1024 * 1024;
 export const DEFAULT_MAX_PAGE_SIZE = 100;
 export const DEFAULT_PAGE_SIZE = 10;
 export const DEFAULT_PORT = 4001;
+export const VERSION = '1.0.0-alpha.10';
 //# sourceMappingURL=constants.js.map

package/dist/src/core/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../../src/core/constants.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,YAAY,GAAG,WAAW,CAAC;AACxC,MAAM,CAAC,MAAM,qBAAqB,GAAG,GAAG,GAAG,IAAI,GAAG,IAAI,CAAC;AACvD,MAAM,CAAC,MAAM,qBAAqB,GAAG,GAAG,CAAC;AACzC,MAAM,CAAC,MAAM,iBAAiB,GAAG,EAAE,CAAC;AACpC,MAAM,CAAC,MAAM,YAAY,GAAG,IAAI,CAAC;AACjC,MAAM,CAAC,MAAM,OAAO,GAAG,gBAAgB,CAAC"}

package/dist/src/core/database.d.ts

@@ -0,0 +1,48 @@
+import type { ModelSchema } from './model.js';
+import type { Source, Storage } from './storage.js';
+import type { DatabaseData, DatabaseRecord } from './types.js';
+export interface DatabaseConfig<S extends Storage = Storage> {
+    source: Source<S, DatabaseData>;
+    schema?: Source<S, ModelSchema>;
+}
+export interface DatabaseContainer {
+    data: DatabaseData;
+    counters?: Record<string, number>;
+}
+export interface DatabaseStore {
+    database: DatabaseContainer;
+    path?: string;
+    read(): Promise<DatabaseData>;
+    /** Передаёт изменяемый черновик и исходные данные только для чтения; сохраняет черновик после проверки.
+     * @example update((draft, before) => { draft.data.notes = []; return before.notes.length; }) → прежнее число записей.
+     */
+    update<T>(operation: (database: DatabaseContainer, before: Readonly<DatabaseData>) => T): Promise<T>;
+}
+/** Проверяет сериализуемое JSON-значение; отвергает циклы, разреженные массивы, NaN и бесконечности.
+ * @example validateJsonValue({ a: [1, null] }, 'data') → undefined; NaN → ошибка.
+ */
+export declare const validateJsonValue: (value: unknown, path: string, ancestors?: WeakSet<object>) => void;
+/** Проверяет объект коллекций, записи и уникальность ключей; возвращает исходный объект.
+ * @example validateDatabase({ notes: [{ id: '1' }] }) → тот же объект; повторный id → ошибка.
+ */
+export declare const validateDatabase: (data: unknown, primaryKeys?: Map<string, string>) => DatabaseData;
+/** Читает UTF-8 JSON-файл и проверяет, что верхний уровень является объектом.
+ * @example Файл с {"a":1} → Promise<{ a: 1 }>; файл с [] → ошибка.
+ */
+export declare const readJsonObjectFile: (path: string, label: string) => Promise<Record<string, unknown>>;
+/** Читает файл и проверяет коллекции и первичные ключи.
+ * @example Файл с {"notes":[]} → Promise<{ notes: [] }>.
+ */
+export declare const readDatabaseFile: (databasePath: string, keys?: Map<string, string>) => Promise<DatabaseData>;
+/** Создаёт дисковое хранилище или хранилище в памяти по настройкам.
+ * @example createDatabaseStore({ source: { notes: [] } }) → Promise<DatabaseStore>.
+ */
+export declare const createDatabaseStore: (config: DatabaseConfig, keys?: Map<string, string>) => Promise<DatabaseStore>;
+/** Ищет индекс записи, сравнивая строковые представления id.
+ * @example findItemIndex([{ id: 1 }], '1') → 0; пустой массив → -1.
+ */
+export declare const findItemIndex: (collection: DatabaseRecord[], id: unknown) => number;
+/** Генерирует случайный строковый id, отсутствующий в переданной коллекции.
+ * @example createId([]) → строка из 11 символов; конкретное значение зависит от генератора случайных чисел.
+ */
+export declare const createId: (collection: DatabaseRecord[]) => string;

package/dist/src/{database.js → core/database.js}

@@ -2,8 +2,12 @@ import { readFile } from 'node:fs/promises';
 import { resolve } from 'node:path';
 import { Low } from 'lowdb';
 import { JSONFile } from 'lowdb/node';
-import { createHttpError, createSerialQueue, createUniqueId, isObject, isSafeKey, isSystemError, resolveDatabasePath } from './utils.js';
+import { domainError } from './errors.js';
+import { createSerialQueue, createUniqueId, isObject, isSafeKey, isSystemError, resolveDatabasePath } from './utils.js';
 const RESOURCE_NAME_PATTERN = /^[A-Za-z][A-Za-z0-9_-]*$/;
+/** Проверяет сериализуемое JSON-значение; отвергает циклы, разреженные массивы, NaN и бесконечности.
+ * @example validateJsonValue({ a: [1, null] }, 'data') → undefined; NaN → ошибка.
+ */
 export const validateJsonValue = (value, path, ancestors = new WeakSet()) => {
     if (value === null || typeof value === 'string' || typeof value === 'boolean') {
         return;
@@ -40,6 +44,9 @@ export const validateJsonValue = (value, path, ancestors = new WeakSet()) => {
     }
     ancestors.delete(value);
 };
+/** Проверяет объект коллекций, записи и уникальность ключей; возвращает исходный объект.
+ * @example validateDatabase({ notes: [{ id: '1' }] }) → тот же объект; повторный id → ошибка.
+ */
 export const validateDatabase = (data, primaryKeys) => {
     if (!isObject(data)) {
         throw new Error('База данных должна содержать JSON-объект');
@@ -73,6 +80,9 @@ export const validateDatabase = (data, primaryKeys) => {
     });
     return data;
 };
+/** Читает UTF-8 JSON-файл и проверяет, что верхний уровень является объектом.
+ * @example Файл с {"a":1} → Promise<{ a: 1 }>; файл с [] → ошибка.
+ */
 export const readJsonObjectFile = async (path, label) => {
     const resolvedPath = resolve(path);
     let source;
@@ -91,7 +101,18 @@ export const readJsonObjectFile = async (path, label) => {
     }
     return value;
 };
+/** Читает файл и проверяет коллекции и первичные ключи.
+ * @example Файл с {"notes":[]} → Promise<{ notes: [] }>.
+ */
 export const readDatabaseFile = async (databasePath, keys) => validateDatabase(await readJsonObjectFile(databasePath, 'Файл базы данных'), keys);
+const validateDraft = (data, keys) => {
+    try {
+        validateDatabase(data, keys);
+    }
+    catch (error) {
+        throw domainError('INVALID_INPUT', error.message);
+    }
+};
 const createDiskDatabaseStore = async (databasePath, keys) => {
     const resolvedDatabasePath = resolveDatabasePath(databasePath);
     const initialData = await readDatabaseFile(resolvedDatabasePath, keys);
@@ -107,8 +128,8 @@ const createDiskDatabaseStore = async (databasePath, keys) => {
         await read();
         await counterStore.read();
         const draft = { data: structuredClone(database.data), counters: structuredClone(counterStore.data) };
-        const result = operation(draft);
-        validateDatabase(draft.data, keys);
+        const result = operation(draft, database.data);
+        validateDraft(draft.data, keys);
         // Reserve generated numbers first: failed data writes may leave gaps, never reused IDs.
         if (JSON.stringify(draft.counters) !== JSON.stringify(counterStore.data)) {
             counterStore.data = draft.counters;
@@ -127,23 +148,24 @@ const createMemoryDatabaseStore = (sourceData, keys) => {
     const read = async () => database.data;
     const update = (operation) => schedule(() => {
         const draft = structuredClone(database);
-        const result = operation(draft);
-        validateDatabase(draft.data, keys);
+        const result = operation(draft, database.data);
+        validateDraft(draft.data, keys);
         database.data = draft.data;
         database.counters = draft.counters;
         return result;
     });
     return { database, read, update };
 };
-/** Creates a disk- or memory-backed database with serialized updates. */
-export const createDatabaseStore = async (config, keys) => config.data != null ? createMemoryDatabaseStore(config.data, keys) : createDiskDatabaseStore(config.path, keys);
-export const getCollection = (database, resource) => {
-    const collection = isSafeKey(resource) ? database.data[resource] : undefined;
-    if (!Array.isArray(collection)) {
-        throw createHttpError(404, 'Ресурс не найден');
-    }
-    return collection;
-};
+/** Создаёт дисковое хранилище или хранилище в памяти по настройкам.
+ * @example createDatabaseStore({ source: { notes: [] } }) → Promise<DatabaseStore>.
+ */
+export const createDatabaseStore = async (config, keys) => typeof config.source === 'string' ? createDiskDatabaseStore(config.source, keys) : createMemoryDatabaseStore(config.source, keys);
+/** Ищет индекс записи, сравнивая строковые представления id.
+ * @example findItemIndex([{ id: 1 }], '1') → 0; пустой массив → -1.
+ */
 export const findItemIndex = (collection, id) => collection.findIndex((item) => String(item.id) === String(id));
+/** Генерирует случайный строковый id, отсутствующий в переданной коллекции.
+ * @example createId([]) → строка из 11 символов; конкретное значение зависит от генератора случайных чисел.
+ */
 export const createId = (collection) => createUniqueId((id) => findItemIndex(collection, id) !== -1);
 //# sourceMappingURL=database.js.map

package/dist/src/core/database.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"database.js","sourceRoot":"","sources":["../../../src/core/database.ts"],"names":[],"mappings":"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"}

package/dist/src/core/engine.d.ts

@@ -0,0 +1,65 @@
+import type { DatabaseStore } from './database.js';
+import type { ActorSource } from './lifecycle/options.js';
+import { type Entity, type Model, type Node } from './model.js';
+import type { MutationMode } from './operations.js';
+import { type Predicate } from './query/filter.js';
+import { type ListOptions } from './query/options.js';
+import { type Context, type Ref } from './records.js';
+import type { DatabaseData } from './types.js';
+export interface PreparedList {
+    page: number;
+    pageSize: number;
+    predicate?: Predicate;
+    rules: Array<{
+        direction: 'ASC' | 'DESC';
+        keys: string[];
+    }>;
+}
+export interface Page {
+    data: Ref[];
+    total: number;
+}
+export declare class Engine {
+    readonly store: DatabaseStore;
+    model: Model;
+    readonly pageSize: number;
+    readonly maxPageSize: number;
+    private inferredModels;
+    constructor(store: DatabaseStore, model: Model, pageSize?: number, maxPageSize?: number);
+    /** Возвращает явную модель или кешированное описание, выведенное из переданного снимка данных.
+     * @example Повторный вызов с тем же объектом data → тот же объект Model.
+     */
+    private modelFor;
+    /** Читает актуальный снимок хранилища и создаёт контекст с пустым кешем индексов.
+     * @example context() → Promise<Context>; при ошибке чтения хранилища → отклонённый Promise.
+     */
+    context(): Promise<Context>;
+    /** Оборачивает все записи выбранной коллекции ссылками с контекстом.
+     * @example Пустая коллекция → []; две записи → две ссылки Ref.
+     */
+    records(context: Context, entity: Entity): Ref[];
+    /** Ищет запись по строковому представлению первичного ключа, включая удалённые записи.
+     * @example Ключ '1' находит запись с числовым ключом 1; отсутствующий ключ → undefined.
+     */
+    find(context: Context, entity: Entity, key: unknown): Ref | undefined;
+    /** Проверяет аргументы списка и подготавливает предикат, пути сортировки и размеры страницы.
+     * @example pager: { page: 2, pageSize: 5 } → план с page: 2 и pageSize: 5; page: 0 → ошибка.
+     */
+    prepareOptions(node: Node, options?: ListOptions): PreparedList;
+    /** Фильтрует, сортирует и возвращает страницу, не меняя порядок исходного массива.
+     * @example Три подходящие записи, page: 2, pageSize: 2 → { data: [третья запись], total: 3 }.
+     */
+    list(records: Ref[], node: Node, options?: ListOptions, prepared?: PreparedList): Page;
+    /** Проверяет коллекции, значения полей и целостность активных связей.
+     * @example Согласованные записи → undefined; обязательная связь без цели → исключение.
+     */
+    validateData(data: DatabaseData): void;
+    /** Выполняет одну операцию записи в транзакции, включая связи, права и подготовку ответа.
+     * @example Режим update с { name: 'Анна' } → обновлённая запись; ошибка проверки → прежние данные.
+     */
+    mutate<T = Ref>(entity: Entity, mode: MutationMode, key?: unknown, body?: unknown, prepare?: (ref: Ref) => T, actor?: ActorSource): Promise<T>;
+    /** Вычисляет каскад удаления, проверяет запрещающие связи и меняет только черновик данных.
+     * @example Удаление родителя при cascade → удалённые зависимые записи; restrict → исключение.
+     */
+    private cascade;
+}