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

package/dist/src/openapi/options.d.ts

@@ -0,0 +1,18 @@
+export type OpenapiInfo = {
+    title: string;
+    version: string;
+    description?: string;
+};
+/** Проверяет метаданные спецификации и возвращает независимую копию.
+ * @example normalizeOpenapiInfo({ title: 'API', version: '1' }) → { title: 'API', version: '1' }; description: 42 → ошибка.
+ */
+export declare function normalizeOpenapiInfo(value: unknown): OpenapiInfo | undefined;
+export interface OpenapiOptions {
+    auth?: boolean;
+    files?: boolean;
+    host?: string;
+    port?: number;
+    pageSize?: number;
+    maxPageSize?: number;
+    info?: OpenapiInfo;
+}

package/dist/src/openapi/options.js

@@ -0,0 +1,13 @@
+import { getObject } from '../core/config-values.js';
+/** Проверяет метаданные спецификации и возвращает независимую копию.
+ * @example normalizeOpenapiInfo({ title: 'API', version: '1' }) → { title: 'API', version: '1' }; description: 42 → ошибка.
+ */
+export function normalizeOpenapiInfo(value) {
+    const info = getObject(value, 'openapi.info');
+    if (!info)
+        return undefined;
+    if (typeof info.title !== 'string' || typeof info.version !== 'string' || (info.description !== undefined && typeof info.description !== 'string'))
+        throw new Error('Invalid OpenAPI info');
+    return structuredClone(info);
+}
+//# sourceMappingURL=options.js.map

package/dist/src/openapi/options.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"options.js","sourceRoot":"","sources":["../../../src/openapi/options.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AAErD;;GAEG;AACH,MAAM,UAAU,oBAAoB,CAAC,KAAc;IACjD,MAAM,IAAI,GAAG,SAAS,CAAC,KAAK,EAAE,cAAc,CAAC,CAAC;IAC9C,IAAI,CAAC,IAAI;QAAE,OAAO,SAAS,CAAC;IAC5B,IAAI,OAAO,IAAI,CAAC,KAAK,KAAK,QAAQ,IAAI,OAAO,IAAI,CAAC,OAAO,KAAK,QAAQ,IAAI,CAAC,IAAI,CAAC,WAAW,KAAK,SAAS,IAAI,OAAO,IAAI,CAAC,WAAW,KAAK,QAAQ,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,sBAAsB,CAAC,CAAC;IAC5L,OAAO,eAAe,CAAC,IAAI,CAAgB,CAAC;AAC9C,CAAC"}

package/dist/src/{types.d.ts → openapi/types.d.ts}

@@ -1,11 +1,4 @@
-export type JsonPrimitive = boolean | number | string | null;
-export type JsonValue = JsonPrimitive | JsonObject | JsonValue[];
-export type JsonObject = {
-    [key: string]: JsonValue;
-};
-export type DatabaseId = number | string;
-export type DatabaseRecord = JsonObject;
-export type DatabaseData = Record<string, DatabaseRecord[]>;
+import type { JsonValue } from '../core/types.js';
 export type OpenapiType = 'array' | 'boolean' | 'integer' | 'number' | 'object' | 'string';
 export interface OpenapiSchema {
     [key: string]: unknown;
@@ -38,6 +31,7 @@ export interface OpenapiDocument {
     components: {
         parameters: Record<string, unknown>;
         schemas: Record<string, OpenapiSchema>;
+        securitySchemes?: Record<string, unknown>;
     };
     info: Record<string, unknown>;
     openapi: string;
@@ -46,5 +40,3 @@ export interface OpenapiDocument {
         url: string;
     }>;
 }
-export type QueryValue = string | string[] | undefined;
-export type Query = Record<string, QueryValue>;

package/dist/src/openapi/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/src/openapi/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/openapi/types.ts"],"names":[],"mappings":""}

package/dist/src/openapi/write.d.ts

@@ -0,0 +1,5 @@
+import type { OpenapiDocument } from './types.js';
+/** Сохраняет документ в YAML, создавая родительские каталоги.
+ * @example writeOpenapi(document, './out/api.yaml') → Promise<void>; результат записан в файл.
+ */
+export declare const writeOpenapi: (document: OpenapiDocument, outputPath: string) => Promise<void>;

package/dist/src/openapi/write.js

@@ -0,0 +1,12 @@
+import { mkdir, writeFile } from 'node:fs/promises';
+import { dirname, resolve } from 'node:path';
+import { stringify } from 'yaml';
+/** Сохраняет документ в YAML, создавая родительские каталоги.
+ * @example writeOpenapi(document, './out/api.yaml') → Promise<void>; результат записан в файл.
+ */
+export const writeOpenapi = async (document, outputPath) => {
+    const resolvedOutputPath = resolve(outputPath);
+    await mkdir(dirname(resolvedOutputPath), { recursive: true });
+    await writeFile(resolvedOutputPath, stringify(document, { aliasDuplicateObjects: false, lineWidth: 0 }), 'utf8');
+};
+//# sourceMappingURL=write.js.map

package/dist/src/openapi/write.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"write.js","sourceRoot":"","sources":["../../../src/openapi/write.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAC7C,OAAO,EAAE,SAAS,EAAE,MAAM,MAAM,CAAC;AAGjC;;GAEG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,KAAK,EAAE,QAAyB,EAAE,UAAkB,EAAiB,EAAE;IACjG,MAAM,kBAAkB,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;IAE/C,MAAM,KAAK,CAAC,OAAO,CAAC,kBAAkB,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC9D,MAAM,SAAS,CAAC,kBAAkB,EAAE,SAAS,CAAC,QAAQ,EAAE,EAAE,qBAAqB,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC,EAAE,CAAC,EAAE,MAAM,CAAC,CAAC;AACnH,CAAC,CAAC"}

package/dist/src/rest/options.d.ts

@@ -0,0 +1,22 @@
+import type { Node } from '../core/model.js';
+import { type ListOptions } from '../core/query/options.js';
+export interface Fields {
+    [key: string]: Scope | true;
+}
+export type Scope = [Fields, ListOptions?];
+export interface RestOptions {
+    scope: Scope;
+}
+export declare const ownScope: Scope;
+/** Выбирает вложенный набор полей; для отсутствующего поля или true возвращает выбор собственных полей.
+ * @example scopeFor([{ '*': true }], 'name') → [{ '*': true }].
+ */
+export declare function scopeFor(scope: Scope, key: string): Scope;
+/** Читает JSON-массив выбора полей из единственного параметра URL; проверяет длину и синтаксис JSON.
+ * @example parseRestOptions({ scope: '[{"id":true}]' }) → { scope: [{ id: true }] }.
+ */
+export declare function parseRestOptions(query: unknown): RestOptions;
+/** Проверяет выбор полей рекурсивно; аргументы разрешены только для однородных списков.
+ * @example Для узла со строковым id: [{ id: true }] → undefined; [{ missing: true }] → ошибка.
+ */
+export declare function validateScope(node: Node, scope: unknown, list?: boolean, depth?: number): asserts scope is Scope;

package/dist/src/rest/options.js

@@ -0,0 +1,65 @@
+import { badQuery, childrenOf } from '../core/query/options.js';
+import { hasOnlyKeys, isObject, isSafeKey } from '../core/utils.js';
+export const ownScope = [{ '*': true }];
+/** Выбирает вложенный набор полей; для отсутствующего поля или true возвращает выбор собственных полей.
+ * @example scopeFor([{ '*': true }], 'name') → [{ '*': true }].
+ */
+export function scopeFor(scope, key) {
+    const selection = Object.hasOwn(scope[0], key) ? scope[0][key] : true;
+    return selection === true ? ownScope : selection;
+}
+/** Читает JSON-массив выбора полей из единственного параметра URL; проверяет длину и синтаксис JSON.
+ * @example parseRestOptions({ scope: '[{"id":true}]' }) → { scope: [{ id: true }] }.
+ */
+export function parseRestOptions(query) {
+    if (!isObject(query))
+        badQuery('Invalid query');
+    for (const key of Object.keys(query))
+        if (key !== 'scope')
+            badQuery(`Unknown query parameter ${key}`);
+    if (query.scope === undefined)
+        return { scope: ownScope };
+    if (typeof query.scope !== 'string')
+        badQuery('scope must occur once and contain JSON');
+    if (query.scope.length > 10000)
+        badQuery('scope must contain at most 10000 characters');
+    try {
+        return { scope: JSON.parse(query.scope) };
+    }
+    catch {
+        badQuery('Invalid JSON in scope');
+    }
+}
+/** Проверяет выбор полей рекурсивно; аргументы разрешены только для однородных списков.
+ * @example Для узла со строковым id: [{ id: true }] → undefined; [{ missing: true }] → ошибка.
+ */
+export function validateScope(node, scope, list = false, depth = 0) {
+    if (depth > 32)
+        badQuery('scope is too deep');
+    if (!Array.isArray(scope) || scope.length < 1 || scope.length > 2 || !isObject(scope[0]))
+        badQuery('scope must be [fields, arguments?]');
+    if (scope.length === 2) {
+        if (!list || node.mixed)
+            badQuery('scope arguments require a list with consistent object types');
+        if (!isObject(scope[1]) || !hasOnlyKeys(scope[1], ['where', 'order', 'pager']))
+            badQuery('Invalid scope arguments');
+    }
+    const children = childrenOf(node);
+    for (const [key, selection] of Object.entries(scope[0])) {
+        if (key === '*') {
+            if (selection !== true)
+                badQuery('scope wildcard must be true');
+            continue;
+        }
+        if (!/^[A-Za-z][A-Za-z0-9_]*$/.test(key) || !isSafeKey(key))
+            badQuery(`Invalid scope field ${key}`);
+        const child = children[key];
+        if (!Object.hasOwn(children, key) || child.writeOnly)
+            badQuery(`Unknown or inaccessible scope field ${key}`);
+        if (child.relation || child.base === 'object')
+            validateScope(child, selection, child.many, depth + 1);
+        else if (selection !== true)
+            badQuery(`Scalar field ${key} must be true`);
+    }
+}
+//# sourceMappingURL=options.js.map

package/dist/src/rest/options.js.map

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

package/dist/src/rest/projection.d.ts

@@ -0,0 +1,13 @@
+import type { Engine, PreparedList } from '../core/engine.js';
+import type { Entity, Node } from '../core/model.js';
+import { type Ref } from '../core/records.js';
+import type { JsonObject } from '../core/types.js';
+import { type RestOptions, type Scope } from './options.js';
+/** Проверяет дерево выбора и заранее подготавливает фильтры, сортировку и пагинацию вложенных списков.
+ * @example Выбор без аргументов у одиночной записи → пустая Map; неверное поле → ошибка.
+ */
+export declare function validateRest(engine: Engine, entity: Entity, options: RestOptions, list?: boolean): Map<Scope | Node, PreparedList>;
+/** Строит новый объект из выбранных полей, разворачивая связи и обрабатывая вложенные списки.
+ * @example Запись { id: '1', name: 'Анна' } и выбор [{ name: true }] → { name: 'Анна' }.
+ */
+export declare function project(engine: Engine, ref: Ref, scope?: Scope, plans?: Map<Node | Scope, PreparedList>): JsonObject;

package/dist/src/rest/projection.js

@@ -0,0 +1,61 @@
+import { childrenOf } from '../core/query/options.js';
+import { isRef, resolveField } from '../core/records.js';
+import { ownScope, scopeFor, validateScope } from './options.js';
+/** Проверяет дерево выбора и заранее подготавливает фильтры, сортировку и пагинацию вложенных списков.
+ * @example Выбор без аргументов у одиночной записи → пустая Map; неверное поле → ошибка.
+ */
+export function validateRest(engine, entity, options, list = false) {
+    validateScope(entity.root, options.scope, list);
+    const plans = new Map();
+    if (list)
+        plans.set(options.scope, engine.prepareOptions(entity.root, options.scope[1]));
+    const visit = (node, scope) => {
+        for (const [key, selection] of Object.entries(scope[0])) {
+            if (selection === true)
+                continue;
+            const child = childrenOf(node)[key];
+            if (selection[1])
+                plans.set(selection, engine.prepareOptions(child, selection[1]));
+            visit(child, selection);
+        }
+    };
+    visit(entity.root, options.scope);
+    return plans;
+}
+/** Строит новый объект из выбранных полей, разворачивая связи и обрабатывая вложенные списки.
+ * @example Запись { id: '1', name: 'Анна' } и выбор [{ name: true }] → { name: 'Анна' }.
+ */
+export function project(engine, ref, scope = ownScope, plans = new Map()) {
+    const output = Object.create(null);
+    const children = childrenOf(ref.node);
+    for (const [key, node] of Object.entries(children)) {
+        if (node.writeOnly || (!Object.hasOwn(scope[0], key) && !(Object.hasOwn(scope[0], '*') && !node.relation)))
+            continue;
+        const value = resolveField(ref, node);
+        const selection = scopeFor(scope, key);
+        if (value === undefined)
+            continue;
+        if (isRef(value))
+            output[key] = project(engine, value, selection, plans);
+        else if (Array.isArray(value)) {
+            if (value.every(isRef) && (value.length > 0 || node.relation || node.base === 'object')) {
+                const planKey = selection === ownScope ? node : selection;
+                const prepared = plans.get(planKey) ?? engine.prepareOptions(node, selection[1]);
+                plans.set(planKey, prepared);
+                const page = engine.list(value, node, selection[1], prepared);
+                output[key] = { data: page.data.map((v) => project(engine, v, selection, plans)), total: page.total };
+            }
+            else
+                output[key] = value.map((item) => (isRef(item) ? project(engine, item, selection, plans) : structuredClone(item)));
+        }
+        else
+            output[key] = structuredClone(value);
+    }
+    // При выведенной модели добавляем исходные поля, которые не удалось описать.
+    if (!ref.context.model.explicit && scope[0]['*'] === true)
+        for (const [key, value] of Object.entries(ref.value))
+            if (!Object.hasOwn(output, key) && !children[key]?.relation && !children[key]?.writeOnly)
+                output[key] = structuredClone(value);
+    return output;
+}
+//# sourceMappingURL=projection.js.map

package/dist/src/rest/projection.js.map

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

package/dist/src/rest/routes.d.ts

@@ -0,0 +1,7 @@
+import type { FastifyInstance } from 'fastify';
+import type { Engine } from '../core/engine.js';
+import type { Authenticate } from '../core/lifecycle/options.js';
+/** Регистрирует чтение коллекций и операции создания, замены, изменения и удаления записей.
+ * @example После регистрации GET / → { resources: [...] }; функция возвращает undefined.
+ */
+export declare function registerRestRoutes(server: FastifyInstance, engine: Engine, authenticate?: Authenticate): void;

package/dist/src/rest/routes.js

@@ -0,0 +1,49 @@
+import { domainError } from '../core/errors.js';
+import { MUTATIONS } from '../core/operations.js';
+import { parseRestOptions } from './options.js';
+import { project, validateRest } from './projection.js';
+/** Регистрирует чтение коллекций и операции создания, замены, изменения и удаления записей.
+ * @example После регистрации GET / → { resources: [...] }; функция возвращает undefined.
+ */
+export function registerRestRoutes(server, engine, authenticate) {
+    server.get('/', async () => ({ resources: engine.model.entities.map((entity) => entity.collection) }));
+    for (const initial of engine.model.entities) {
+        const path = `/${initial.collection}`;
+        const itemPath = `${path}/:${initial.primary}`;
+        server.get(path, async (request) => {
+            const context = await engine.context();
+            const entity = context.model.byCollection.get(initial.collection);
+            const options = parseRestOptions(request.query);
+            const plans = validateRest(engine, entity, options, true);
+            const page = engine.list(engine.records(context, entity), entity.root, undefined, plans.get(options.scope));
+            return { data: page.data.map((ref) => project(engine, ref, options.scope, plans)), total: page.total };
+        });
+        server.get(itemPath, async (request) => {
+            const context = await engine.context();
+            const entity = context.model.byCollection.get(initial.collection);
+            const options = parseRestOptions(request.query);
+            const plans = validateRest(engine, entity, options);
+            const ref = engine.find(context, entity, request.params[entity.primary]);
+            if (!ref)
+                throw domainError('NOT_FOUND', 'Record not found');
+            return project(engine, ref, options.scope, plans);
+        });
+        for (const { method, mode, hasKey, status } of MUTATIONS) {
+            server.route({
+                method,
+                url: hasKey ? itemPath : path,
+                handler: async (request, reply) => {
+                    const actor = authenticate ? () => authenticate(request.headers.authorization) : undefined;
+                    actor?.();
+                    const options = parseRestOptions(request.query);
+                    const result = await engine.mutate(initial, mode, request.params[initial.primary], request.body, (ref) => {
+                        const plans = validateRest(engine, ref.entity, options);
+                        return project(engine, ref, options.scope, plans);
+                    }, actor);
+                    return reply.code(status).send(result);
+                },
+            });
+        }
+    }
+}
+//# sourceMappingURL=routes.js.map

package/dist/src/rest/routes.js.map

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

package/dist/src/server/config.d.ts

@@ -0,0 +1,74 @@
+import type { FastifyServerOptions } from 'fastify';
+import type { AuthConfig } from '../auth/contract.js';
+import type { DatabaseConfig } from '../core/database.js';
+import type { ModelSchema } from '../core/model.js';
+import type { Storage } from '../core/storage.js';
+import type { FilesConfig } from '../files/contract.js';
+import { type OpenapiInfo } from '../openapi/options.js';
+export type { AuthConfig } from '../auth/contract.js';
+export type { DatabaseConfig } from '../core/database.js';
+export type { Storage } from '../core/storage.js';
+export type { FilesConfig, MemoryFile } from '../files/contract.js';
+export type DatabaseSchema = ModelSchema;
+export interface OpenapiConfig {
+    endpoint?: string;
+    target?: string;
+    info?: OpenapiInfo;
+}
+export interface GraphqlConfig {
+    target?: string;
+    endpoint?: string;
+}
+export interface ServerConfig {
+    cors?: boolean;
+    host?: string;
+    logger?: FastifyServerOptions['logger'];
+    maxFileSize?: number;
+    maxPageSize?: number;
+    pageSize?: number;
+    port?: number;
+}
+export type DeepJsonServerConfig = {
+    [S in Storage]: {
+        storage: S;
+        database: DatabaseConfig<S>;
+        files?: FilesConfig<S>;
+        auth?: AuthConfig<S>;
+        openapi?: OpenapiConfig;
+        graphql?: GraphqlConfig;
+        server?: ServerConfig;
+    };
+}[Storage];
+export interface NormalizedServerConfig {
+    storage: Storage;
+    database: DatabaseConfig;
+    files?: FilesConfig;
+    auth?: AuthConfig;
+    openapi?: OpenapiConfig & {
+        endpoint: string;
+    };
+    graphql?: GraphqlConfig & {
+        endpoint: string;
+    };
+    server: Required<ServerConfig>;
+}
+/** Нормализует объект конфигурации без чтения содержимого файлов.
+ * @example Путь './db.json' с directory = '/tmp' → '/tmp/db.json'.
+ */
+export declare const normalizeServerConfig: (config: DeepJsonServerConfig, directory?: string) => NormalizedServerConfig;
+/** Загружает default-экспорт ES-модуля, обходя кеш повторного импорта; выполняет код модуля.
+ * @example Файл /tmp/config.mjs с export default {} → { config: {}, directory: '/tmp', path: '/tmp/config.mjs' }.
+ */
+export declare function readConfigModule(configPath: string): Promise<{
+    config: Record<string, unknown>;
+    directory: string;
+    path: string;
+}>;
+/** Возвращает сохранённый путь исходного файла для данного объекта настроек.
+ * @example Для объекта без зарегистрированного источника → undefined.
+ */
+export declare const configSourcePath: (config: NormalizedServerConfig) => string | undefined;
+/** Нормализует настройки и запоминает путь их источника во внутренней таблице.
+ * @example configure(config, '/tmp', '/tmp/config.mjs') → настройки; configSourcePath(result) → '/tmp/config.mjs'.
+ */
+export declare function configure(config: unknown, directory: string, sourcePath?: string): NormalizedServerConfig;

package/dist/src/server/config.js

@@ -0,0 +1,142 @@
+import { dirname, resolve } from 'node:path';
+import { pathToFileURL } from 'node:url';
+import { getBoolean, getObject, getPositiveInteger, getString, normalizeAddress } from '../core/config-values.js';
+import { DEFAULT_MAX_FILE_SIZE } from '../core/constants.js';
+import { normalizePagination } from '../core/pagination.js';
+import { assertKnownKeys, errorMessage, isObject } from '../core/utils.js';
+import { normalizeOpenapiInfo } from '../openapi/options.js';
+const CONFIG_KEYS = new Set(['storage', 'database', 'files', 'auth', 'openapi', 'graphql', 'server']);
+const SERVER_KEYS = new Set(['cors', 'host', 'logger', 'maxFileSize', 'maxPageSize', 'pageSize', 'port']);
+let configImportIndex = 0;
+/** Проверяет секцию и её допустимые ключи; undefined означает отсутствие секции.
+ * @example section({}, 'auth', []) → {}; section(null, 'auth', []) → ошибка.
+ */
+function section(value, name, keys) {
+    if (value === undefined)
+        return undefined;
+    const object = getObject(value, `config.${name}`, true);
+    assertKnownKeys(object, new Set(keys), `config.${name}`);
+    return object;
+}
+/** Проверяет путь либо начальные данные в соответствии с общим режимом хранения.
+ * @example source('db.json', 'file', 'database.source', '/tmp') → '/tmp/db.json'.
+ */
+function source(value, storage, name, directory, array = false) {
+    if (storage === 'file')
+        return resolve(directory, getString(value, `config.${name}`, true));
+    if (array ? !Array.isArray(value) : !isObject(value))
+        throw new Error(`config.${name} must contain ${array ? 'an array' : 'an object'} for memory storage`);
+    try {
+        return structuredClone(value);
+    }
+    catch (error) {
+        throw new Error(`config.${name} must contain structured data`, { cause: error });
+    }
+}
+/** Проверяет секции настроек и возвращает независимые данные с абсолютными путями.
+ * @example { storage: 'file', database: { source: 'db.json' } } → абсолютный database.source.
+ */
+function normalizeConfig(value, directory = '.') {
+    const config = getObject(value, 'config', true);
+    assertKnownKeys(config, CONFIG_KEYS, 'config');
+    if (config.storage !== 'file' && config.storage !== 'memory')
+        throw new Error("config.storage must be 'file' or 'memory'");
+    const storage = config.storage;
+    const database = section(config.database, 'database', ['source', 'schema']);
+    if (!database)
+        throw new Error('config.database is required');
+    const normalizedDatabase = {
+        source: source(database.source, storage, 'database.source', directory),
+        ...(database.schema !== undefined ? { schema: source(database.schema, storage, 'database.schema', directory) } : {}),
+    };
+    const files = section(config.files, 'files', storage === 'file' ? ['source', 'metadata'] : ['source']);
+    const normalizedFiles = files === undefined
+        ? undefined
+        : storage === 'file'
+            ? {
+                source: source(files.source, storage, 'files.source', directory),
+                metadata: files.metadata === undefined
+                    ? resolve(directory, getString(files.source, 'config.files.source', true), '.files.json')
+                    : resolve(directory, getString(files.metadata, 'config.files.metadata', true)),
+            }
+            : { source: source(files.source, storage, 'files.source', directory, true) };
+    const auth = section(config.auth, 'auth', ['source', 'expiresIn']);
+    let normalizedAuth;
+    if (auth) {
+        const expiresIn = getPositiveInteger(auth.expiresIn, 'config.auth.expiresIn');
+        if (expiresIn !== undefined && expiresIn > 2147483647)
+            throw new Error('config.auth.expiresIn must be at most 2147483647 seconds');
+        normalizedAuth = { source: source(auth.source, storage, 'auth.source', directory, true), expiresIn };
+    }
+    const openapi = section(config.openapi, 'openapi', ['target', 'info', 'endpoint']);
+    const graphql = section(config.graphql, 'graphql', ['target', 'endpoint']);
+    if ((openapi || graphql) && normalizedDatabase.schema === undefined)
+        throw new Error('GraphQL and OpenAPI require an explicit model schema');
+    const exportPath = (value, name) => (value === undefined ? undefined : resolve(directory, getString(value, name, true)));
+    const openapiEndpoint = getString(openapi?.endpoint, 'config.openapi.endpoint') ?? '/openapi.json';
+    const graphqlEndpoint = getString(graphql?.endpoint, 'config.graphql.endpoint') ?? '/graphql';
+    if (!/^\/[A-Za-z][A-Za-z0-9_./-]*$/.test(openapiEndpoint))
+        throw new Error('Invalid OpenAPI endpoint');
+    if (!/^\/[A-Za-z][A-Za-z0-9_/-]*$/.test(graphqlEndpoint))
+        throw new Error('Invalid GraphQL endpoint');
+    const server = getObject(config.server, 'config.server') ?? {};
+    assertKnownKeys(server, SERVER_KEYS, 'config.server');
+    const logger = server.logger;
+    if (logger != null && typeof logger !== 'boolean' && !isObject(logger))
+        throw new Error('config.server.logger must be boolean or an object');
+    return {
+        storage,
+        database: normalizedDatabase,
+        files: normalizedFiles,
+        auth: normalizedAuth,
+        openapi: openapi ? { endpoint: openapiEndpoint, target: exportPath(openapi.target, 'config.openapi.target'), info: normalizeOpenapiInfo(openapi.info) } : undefined,
+        graphql: graphql ? { endpoint: graphqlEndpoint, target: exportPath(graphql.target, 'config.graphql.target') } : undefined,
+        server: {
+            ...normalizeAddress(server),
+            ...normalizePagination(server),
+            cors: getBoolean(server.cors, 'config.server.cors') ?? true,
+            logger: (logger ?? true),
+            maxFileSize: getPositiveInteger(server.maxFileSize, 'config.server.maxFileSize') ?? DEFAULT_MAX_FILE_SIZE,
+        },
+    };
+}
+/** Нормализует объект конфигурации без чтения содержимого файлов.
+ * @example Путь './db.json' с directory = '/tmp' → '/tmp/db.json'.
+ */
+export const normalizeServerConfig = (config, directory) => normalizeConfig(config, directory);
+/** Загружает default-экспорт ES-модуля, обходя кеш повторного импорта; выполняет код модуля.
+ * @example Файл /tmp/config.mjs с export default {} → { config: {}, directory: '/tmp', path: '/tmp/config.mjs' }.
+ */
+export async function readConfigModule(configPath) {
+    const resolvedConfigPath = resolve(getString(configPath, 'config', true));
+    let config;
+    try {
+        const configUrl = pathToFileURL(resolvedConfigPath);
+        // Обходим кеш модуля, чтобы повторное чтение выполняло обновлённый файл.
+        configUrl.searchParams.set('deep-json-server-import', String(configImportIndex++));
+        config = (await import(configUrl.href)).default;
+    }
+    catch (error) {
+        const message = errorMessage(error);
+        throw new Error(`Не удалось загрузить конфигурацию ${resolvedConfigPath}: ${message}`, { cause: error });
+    }
+    if (!isObject(config)) {
+        throw new Error('Конфигурация сервера должна экспортировать JSON-объект через export default');
+    }
+    return { config, directory: dirname(resolvedConfigPath), path: resolvedConfigPath };
+}
+const sourcePaths = new WeakMap();
+/** Возвращает сохранённый путь исходного файла для данного объекта настроек.
+ * @example Для объекта без зарегистрированного источника → undefined.
+ */
+export const configSourcePath = (config) => sourcePaths.get(config);
+/** Нормализует настройки и запоминает путь их источника во внутренней таблице.
+ * @example configure(config, '/tmp', '/tmp/config.mjs') → настройки; configSourcePath(result) → '/tmp/config.mjs'.
+ */
+export function configure(config, directory, sourcePath) {
+    const normalized = normalizeConfig(config, directory);
+    if (sourcePath)
+        sourcePaths.set(normalized, sourcePath);
+    return normalized;
+}
+//# sourceMappingURL=config.js.map

package/dist/src/server/config.js.map

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

package/dist/src/server/create.d.ts

@@ -0,0 +1,16 @@
+import type { FastifyInstance } from 'fastify';
+import type { OpenapiDocument } from '../openapi/types.js';
+import { type DeepJsonServerConfig, type NormalizedServerConfig } from './config.js';
+export interface ServerFacade {
+    fastify(): FastifyInstance;
+    openapi(): Promise<OpenapiDocument>;
+    graphql(): Promise<string>;
+}
+/** Проверяет настройки и создаёт интерфейс запуска и генерации схем; сетевой порт ещё не открывает.
+ * @example await createServer({ storage: 'memory', database: { source: { notes: [] } } }) → объект с fastify(), openapi(), graphql().
+ */
+export declare function createServer(config: DeepJsonServerConfig): Promise<ServerFacade>;
+/** Собирает сервер из нормализованных настроек; хранилища открываются при инициализации HTTP-экземпляра.
+ * @example Нормализованные настройки → Promise<ServerFacade>; listen() затем открывает сетевой порт.
+ */
+export declare function createConfiguredServer(normalized: NormalizedServerConfig): Promise<ServerFacade>;