@kollors/deep-json-server 0.7.0 → 0.8.1

package/dist/src/openapi/config.js

@@ -0,0 +1,204 @@
+import { readJsonObjectFile, validateJsonValue } from '../database.js';
+import { assertKnownKeys, isObject } from '../utils.js';
+import { applyRequiredFields, getSchemasAtPath, updateSchemasAtPath } from './inference.js';
+const SCHEMA_CONFIG_KEYS = new Set(['$info', '$schema']);
+const RESOURCE_CONFIG_KEYS = new Set(['formats', 'name', 'properties', 'required']);
+const OPENAPI_TYPES = new Set(['array', 'boolean', 'integer', 'number', 'object', 'string']);
+const COMPONENT_NAME_PATTERN = /^[A-Za-z0-9._-]+$/;
+const SCHEMA_OVERRIDE_KEYS = new Set([
+    '$ref',
+    'additionalProperties',
+    'allOf',
+    'anyOf',
+    'default',
+    'deprecated',
+    'description',
+    'enum',
+    'example',
+    'format',
+    'items',
+    'maximum',
+    'maxItems',
+    'maxLength',
+    'minimum',
+    'minItems',
+    'minLength',
+    'not',
+    'nullable',
+    'oneOf',
+    'pattern',
+    'properties',
+    'readOnly',
+    'required',
+    'title',
+    'type',
+    'uniqueItems',
+    'writeOnly',
+]);
+const STRING_SCHEMA_KEYS = ['description', 'format', 'pattern', 'title'];
+const NUMBER_SCHEMA_KEYS = ['maximum', 'minimum'];
+const INTEGER_SCHEMA_KEYS = ['maxItems', 'maxLength', 'minItems', 'minLength'];
+const BOOLEAN_SCHEMA_KEYS = ['deprecated', 'nullable', 'readOnly', 'uniqueItems', 'writeOnly'];
+function validateSchemaOverride(schema, path) {
+    if (!isObject(schema)) {
+        throw new Error(`OpenAPI-схема свойства «${path}» должна содержать JSON-объект`);
+    }
+    assertKnownKeys(schema, SCHEMA_OVERRIDE_KEYS, `properties.${path}`);
+    if (schema.type != null && (typeof schema.type !== 'string' || !OPENAPI_TYPES.has(schema.type))) {
+        throw new Error(`type свойства «${path}» должен содержать поддерживаемый тип OpenAPI`);
+    }
+    if (schema.required != null && (!Array.isArray(schema.required) || schema.required.some((key) => typeof key !== 'string' || key === ''))) {
+        throw new Error(`required свойства «${path}» должен содержать массив непустых строк`);
+    }
+    if (schema.$ref != null && (typeof schema.$ref !== 'string' || schema.$ref === '')) {
+        throw new Error(`$ref свойства «${path}» должен содержать непустую строку`);
+    }
+    STRING_SCHEMA_KEYS.forEach((key) => {
+        if (schema[key] != null && typeof schema[key] !== 'string') {
+            throw new Error(`${key} свойства «${path}» должен содержать строку`);
+        }
+    });
+    NUMBER_SCHEMA_KEYS.forEach((key) => {
+        if (schema[key] != null && (typeof schema[key] !== 'number' || !Number.isFinite(schema[key]))) {
+            throw new Error(`${key} свойства «${path}» должен содержать конечное число`);
+        }
+    });
+    INTEGER_SCHEMA_KEYS.forEach((key) => {
+        if (schema[key] != null && (typeof schema[key] !== 'number' || !Number.isInteger(schema[key]) || schema[key] < 0)) {
+            throw new Error(`${key} свойства «${path}» должен содержать неотрицательное целое число`);
+        }
+    });
+    BOOLEAN_SCHEMA_KEYS.forEach((key) => {
+        if (schema[key] != null && typeof schema[key] !== 'boolean') {
+            throw new Error(`${key} свойства «${path}» должен содержать boolean`);
+        }
+    });
+    if (schema.enum != null && (!Array.isArray(schema.enum) || schema.enum.length === 0)) {
+        throw new Error(`enum свойства «${path}» должен содержать непустой массив`);
+    }
+    if (schema.properties != null) {
+        if (!isObject(schema.properties)) {
+            throw new Error(`properties свойства «${path}» должен содержать JSON-объект`);
+        }
+        Object.entries(schema.properties).forEach(([key, value]) => {
+            validateSchemaOverride(value, `${path}.${key}`);
+        });
+    }
+    if (schema.items != null) {
+        validateSchemaOverride(schema.items, `${path}[]`);
+    }
+    for (const keyword of ['allOf', 'anyOf', 'oneOf']) {
+        if (schema[keyword] != null) {
+            if (!Array.isArray(schema[keyword]) || schema[keyword].length === 0) {
+                throw new Error(`${keyword} свойства «${path}» должен содержать непустой массив`);
+            }
+            schema[keyword].forEach((value, index) => {
+                validateSchemaOverride(value, `${path}.${keyword}[${index}]`);
+            });
+        }
+    }
+    if (schema.not != null) {
+        validateSchemaOverride(schema.not, `${path}.not`);
+    }
+    if (schema.additionalProperties != null && typeof schema.additionalProperties !== 'boolean') {
+        validateSchemaOverride(schema.additionalProperties, `${path}.additionalProperties`);
+    }
+    if (schema.type != null) {
+        const objectKeywords = ['additionalProperties', 'properties', 'required'];
+        const arrayKeywords = ['items', 'maxItems', 'minItems', 'uniqueItems'];
+        const stringKeywords = ['maxLength', 'minLength', 'pattern'];
+        const numberKeywords = ['maximum', 'minimum'];
+        const incompatibleKeyword = [
+            ...(schema.type === 'object' ? [] : objectKeywords),
+            ...(schema.type === 'array' ? [] : arrayKeywords),
+            ...(schema.type === 'string' ? [] : stringKeywords),
+            ...(['integer', 'number'].includes(schema.type) ? [] : numberKeywords),
+        ].find((key) => schema[key] != null);
+        if (incompatibleKeyword != null) {
+            throw new Error(`${incompatibleKeyword} свойства «${path}» несовместим с type «${schema.type}»`);
+        }
+    }
+}
+export const normalizeSchemaConfig = (schemaConfig, resources) => {
+    validateJsonValue(schemaConfig, 'Схема базы данных');
+    assertKnownKeys(schemaConfig, SCHEMA_CONFIG_KEYS, 'schema');
+    const info = schemaConfig.$info;
+    const normalizedInfo = isObject(info) ? info : undefined;
+    if (Object.hasOwn(schemaConfig, '$info') && (normalizedInfo == null || !['title', 'version'].every((key) => typeof normalizedInfo[key] === 'string' && normalizedInfo[key].trim() !== ''))) {
+        throw new Error('$info должен содержать непустые строковые поля title и version');
+    }
+    if (Object.hasOwn(schemaConfig, '$schema') && !isObject(schemaConfig.$schema)) {
+        throw new Error('$schema должен содержать JSON-объект');
+    }
+    const resourceConfigs = (schemaConfig.$schema ?? {});
+    Object.entries(resourceConfigs).forEach(([resource, resourceConfig]) => {
+        if (!resources.includes(resource)) {
+            throw new Error(`В $schema указан неизвестный ресурс «${resource}»`);
+        }
+        if (!isObject(resourceConfig)) {
+            throw new Error(`Настройки ресурса «${resource}» должны содержать JSON-объект`);
+        }
+        assertKnownKeys(resourceConfig, RESOURCE_CONFIG_KEYS, `$schema.${resource}`);
+        if (resourceConfig.name != null && (typeof resourceConfig.name !== 'string' || !COMPONENT_NAME_PATTERN.test(resourceConfig.name))) {
+            throw new Error(`$schema.${resource}.name должен соответствовать шаблону ${COMPONENT_NAME_PATTERN}`);
+        }
+        if (resourceConfig.required != null && (!Array.isArray(resourceConfig.required) || resourceConfig.required.some((path) => typeof path !== 'string' || path === ''))) {
+            throw new Error(`$schema.${resource}.required должен содержать массив непустых строк`);
+        }
+        if (resourceConfig.formats != null &&
+            (!isObject(resourceConfig.formats) || Object.entries(resourceConfig.formats).some(([path, format]) => path === '' || typeof format !== 'string' || format === ''))) {
+            throw new Error(`$schema.${resource}.formats должен содержать JSON-объект с непустыми строковыми путями и форматами`);
+        }
+        if (resourceConfig.properties != null) {
+            if (!isObject(resourceConfig.properties)) {
+                throw new Error(`$schema.${resource}.properties должен содержать JSON-объект`);
+            }
+            Object.entries(resourceConfig.properties).forEach(([key, value]) => {
+                validateSchemaOverride(value, `${resource}.${key}`);
+            });
+        }
+    });
+    return Object.fromEntries(resources.map((resource) => {
+        const resourceConfig = (resourceConfigs[resource] ?? {});
+        return [
+            resource,
+            {
+                formats: (resourceConfig.formats ?? {}),
+                name: typeof resourceConfig.name === 'string' ? resourceConfig.name : undefined,
+                properties: (resourceConfig.properties ?? {}),
+                required: (resourceConfig.required ?? []),
+            },
+        ];
+    }));
+};
+export const applyConfiguredFields = (schema, resource, resourceConfig) => {
+    const { formats, required: requiredFields } = resourceConfig;
+    [...requiredFields, ...Object.keys(formats)].forEach((path) => {
+        if (getSchemasAtPath(schema, path.split('.')).length === 0) {
+            throw new Error(`Путь «${path}» из настроек ресурса «${resource}» отсутствует в итоговой схеме`);
+        }
+    });
+    const schemaWithFormats = Object.entries(formats).reduce((result, [path, format]) => {
+        const schemas = getSchemasAtPath(result, path.split('.'));
+        if (!schemas.some((nestedSchema) => nestedSchema.type === 'string')) {
+            throw new Error(`Формат «${format}» для пути «${resource}.${path}» можно применить только к строковому полю`);
+        }
+        return updateSchemasAtPath(result, path.split('.'), (nestedSchema) => (nestedSchema.type === 'string' ? { ...nestedSchema, format } : nestedSchema));
+    }, schema);
+    return applyRequiredFields(schemaWithFormats, '', new Set(requiredFields));
+};
+export const resolveSchemaConfig = async (schema) => {
+    if (schema == null) {
+        return {};
+    }
+    if (typeof schema === 'string') {
+        return (await readJsonObjectFile(schema, 'Файл схемы базы данных'));
+    }
+    if (!isObject(schema)) {
+        throw new Error('Схема базы данных должна содержать JSON-объект');
+    }
+    const clonedSchema = structuredClone(schema);
+    validateJsonValue(clonedSchema, 'Схема базы данных');
+    return clonedSchema;
+};
+//# sourceMappingURL=config.js.map

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

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

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

@@ -0,0 +1,9 @@
+import type { DatabaseData, JsonObject, OpenapiDocument } from '../types.js';
+export interface BuildOpenapiOptions {
+    database: DatabaseData;
+    files?: boolean;
+    maxPageSize?: number;
+    schema?: JsonObject;
+}
+/** Builds an OpenAPI document without runtime server addresses. */
+export declare function buildOpenapiDocument(options: BuildOpenapiOptions): OpenapiDocument;

package/dist/src/openapi/document.js

@@ -0,0 +1,338 @@
+import { DEFAULT_MAX_PAGE_SIZE, DEFAULT_PAGE_SIZE } from '../constants.js';
+import { validateDatabase } from '../database.js';
+import { FILE_HEADERS, FILE_METADATA_SCHEMA, FILE_ROUTES, FILE_UPDATE_SCHEMA } from '../files/contract.js';
+import { getRelationMetadata } from '../relation-metadata.js';
+import { getResourceNames, isObject, singularize, toPascalCase } from '../utils.js';
+import { applyConfiguredFields, normalizeSchemaConfig } from './config.js';
+import { ensureGeneratedIdSchema, inferObjectSchema, mergeSchemaOverrides, omitId } from './inference.js';
+const createSchemaReference = (name) => ({ $ref: `#/components/schemas/${name}` });
+const addForwardRelations = (schema, resources, componentNames, sourceResource) => {
+    if (Array.isArray(schema.oneOf)) {
+        return { ...schema, oneOf: schema.oneOf.map((nestedSchema) => addForwardRelations(nestedSchema, resources, componentNames, sourceResource)) };
+    }
+    if (schema.type === 'array') {
+        return { ...schema, items: addForwardRelations(schema.items ?? {}, resources, componentNames, sourceResource) };
+    }
+    if (schema.type !== 'object' || !isObject(schema.properties)) {
+        return schema;
+    }
+    const properties = Object.fromEntries(Object.entries(schema.properties).map(([key, value]) => [key, addForwardRelations(value, resources, componentNames, sourceResource)]));
+    Object.keys(schema.properties).forEach((key) => {
+        const relation = getRelationMetadata(key, resources, sourceResource);
+        if (relation != null) {
+            const relationSchema = createSchemaReference(componentNames[relation.targetResource]);
+            properties[relation.relationName] = relation.isMany ? { items: relationSchema, type: 'array' } : relationSchema;
+        }
+    });
+    return { ...schema, properties };
+};
+const collectRelations = (schema, resources, sourceResource, relations = []) => {
+    if (Array.isArray(schema.oneOf)) {
+        schema.oneOf.forEach((nestedSchema) => {
+            collectRelations(nestedSchema, resources, sourceResource, relations);
+        });
+        return relations;
+    }
+    if (schema.type === 'array') {
+        collectRelations(schema.items ?? {}, resources, sourceResource, relations);
+        return relations;
+    }
+    if (schema.type !== 'object' || !isObject(schema.properties)) {
+        return relations;
+    }
+    Object.entries(schema.properties).forEach(([key, value]) => {
+        const relation = getRelationMetadata(key, resources, sourceResource);
+        if (relation != null) {
+            relations.push(relation);
+        }
+        collectRelations(value, resources, sourceResource, relations);
+    });
+    return relations;
+};
+const addReverseRelations = (schemas, rawSchemas, resources, componentNames) => {
+    resources.forEach((sourceResource) => {
+        collectRelations(rawSchemas[sourceResource], resources, sourceResource).forEach(({ reverseRelationName, targetResource }) => {
+            const targetComponentName = componentNames[targetResource];
+            const targetSchema = schemas[targetComponentName];
+            if (targetSchema.type === 'object' && isObject(targetSchema.properties) && !Object.hasOwn(targetSchema.properties, reverseRelationName)) {
+                schemas[targetComponentName] = {
+                    ...targetSchema,
+                    properties: {
+                        ...targetSchema.properties,
+                        [reverseRelationName]: { items: createSchemaReference(componentNames[sourceResource]), type: 'array' },
+                    },
+                };
+            }
+        });
+    });
+};
+const createParameters = (maxPageSize) => ({
+    ContentDirectory: { description: 'URI-encoded relative storage directory', in: 'header', name: FILE_HEADERS.directory.name, schema: { type: 'string' } },
+    ContentName: { description: 'URI-encoded file name', in: 'header', name: FILE_HEADERS.name.name, required: true, schema: { type: 'string' } },
+    ContentOverride: {
+        description: 'Overwrite an existing file at the same path',
+        in: 'header',
+        name: FILE_HEADERS.override.name,
+        schema: { default: 'false', enum: ['false', 'true'], type: 'string' },
+    },
+    Embed: { description: 'Relationship paths to embed', explode: true, in: 'query', name: '_embed', schema: { items: { type: 'string' }, type: 'array' }, style: 'form' },
+    FilePath: { description: 'Percent-encoded file path relative to the storage directory', in: 'path', name: 'path', required: true, schema: { type: 'string' } },
+    Id: { in: 'path', name: 'id', required: true, schema: { type: 'string' } },
+    Page: { in: 'query', name: '_page', required: false, schema: { default: 1, minimum: 1, type: 'integer' } },
+    PerPage: { in: 'query', name: '_perPage', required: false, schema: { default: DEFAULT_PAGE_SIZE, maximum: maxPageSize, minimum: 1, type: 'integer' } },
+    Sort: { description: 'Comma-separated fields; prefix with - for descending order', in: 'query', name: '_sort', schema: { type: 'string' } },
+    Where: { description: 'JSON-encoded filter for nested data', in: 'query', name: '_where', schema: { type: 'string' } },
+});
+const createJsonContent = (schema) => ({ content: { 'application/json': { schema } } });
+const createResponse = (description, schema) => ({ description, ...(schema != null && createJsonContent(schema)) });
+const createErrorResponse = (description) => createResponse(description, createSchemaReference('Error'));
+const createParameterReference = (name) => ({ $ref: `#/components/parameters/${name}` });
+const createRequestBody = (name) => ({ required: true, ...createJsonContent(createSchemaReference(name)) });
+const createFilePaths = () => ({
+    [`${FILE_ROUTES.download}/{path}`]: {
+        get: {
+            operationId: 'downloadFile',
+            parameters: [createParameterReference('FilePath')],
+            responses: {
+                200: { content: { '*/*': { schema: { format: 'binary', type: 'string' } } }, description: 'File download' },
+                400: createErrorResponse('Invalid path'),
+                404: createErrorResponse('Not found'),
+            },
+            tags: ['files'],
+        },
+    },
+    [`${FILE_ROUTES.metadata}/{path}`]: {
+        get: {
+            operationId: 'getFileMetadata',
+            parameters: [createParameterReference('FilePath')],
+            responses: {
+                200: createResponse('File metadata', createSchemaReference('FileMetadata')),
+                400: createErrorResponse('Invalid path'),
+                404: createErrorResponse('Not found'),
+            },
+            tags: ['files'],
+        },
+    },
+    [FILE_ROUTES.storage]: {
+        post: {
+            operationId: 'uploadFile',
+            parameters: ['ContentName', 'ContentDirectory', 'ContentOverride'].map(createParameterReference),
+            requestBody: { content: { '*/*': { schema: { format: 'binary', type: 'string' } } }, required: true },
+            responses: {
+                200: createResponse('Overwritten', createSchemaReference('FileMetadata')),
+                201: createResponse('Created', createSchemaReference('FileMetadata')),
+                400: createErrorResponse('Invalid request'),
+                409: createErrorResponse('Already exists'),
+                413: createErrorResponse('File is too large'),
+                415: createErrorResponse('Unsupported media type'),
+            },
+            tags: ['files'],
+        },
+    },
+    [`${FILE_ROUTES.storage}/{path}`]: {
+        delete: {
+            operationId: 'deleteFile',
+            parameters: [createParameterReference('FilePath')],
+            responses: {
+                204: { description: 'Deleted' },
+                400: createErrorResponse('Invalid path'),
+                404: createErrorResponse('Not found'),
+            },
+            tags: ['files'],
+        },
+        get: {
+            operationId: 'getFileContent',
+            parameters: [createParameterReference('FilePath')],
+            responses: {
+                200: { content: { '*/*': { schema: { format: 'binary', type: 'string' } } }, description: 'File contents' },
+                400: createErrorResponse('Invalid path'),
+                404: createErrorResponse('Not found'),
+            },
+            tags: ['files'],
+        },
+        patch: {
+            operationId: 'updateFile',
+            parameters: [createParameterReference('FilePath')],
+            requestBody: createRequestBody('FileUpdate'),
+            responses: {
+                200: createResponse('Updated', createSchemaReference('FileMetadata')),
+                400: createErrorResponse('Invalid request'),
+                404: createErrorResponse('Not found'),
+                409: createErrorResponse('Already exists'),
+                413: createErrorResponse('Request is too large'),
+                415: createErrorResponse('Unsupported media type'),
+            },
+            tags: ['files'],
+        },
+    },
+});
+const createResourceOperationIds = (resource) => {
+    const resourceName = toPascalCase(resource);
+    return {
+        create: `post${resourceName}`,
+        get: `get${resourceName}ById`,
+        list: `get${resourceName}`,
+        remove: `delete${resourceName}ById`,
+        replace: `put${resourceName}ById`,
+        update: `patch${resourceName}ById`,
+    };
+};
+const createResourcePaths = (resource, componentName) => {
+    const operationIds = createResourceOperationIds(resource);
+    return {
+        [`/${resource}`]: {
+            get: {
+                operationId: operationIds.list,
+                parameters: ['Page', 'PerPage', 'Sort', 'Where', 'Embed'].map(createParameterReference),
+                responses: { 200: createResponse('Successful response', createSchemaReference(`${componentName}Page`)), 400: createErrorResponse('Invalid query') },
+                tags: [resource],
+            },
+            post: {
+                operationId: operationIds.create,
+                requestBody: createRequestBody(`${componentName}Create`),
+                responses: { 201: createResponse('Created', createSchemaReference(componentName)), 400: createErrorResponse('Invalid request') },
+                tags: [resource],
+            },
+        },
+        [`/${resource}/{id}`]: {
+            delete: {
+                operationId: operationIds.remove,
+                parameters: [createParameterReference('Id')],
+                responses: { 200: createResponse('Deleted', createSchemaReference(componentName)), 404: createErrorResponse('Not found') },
+                tags: [resource],
+            },
+            get: {
+                operationId: operationIds.get,
+                parameters: [createParameterReference('Id'), createParameterReference('Embed')],
+                responses: {
+                    200: createResponse('Successful response', createSchemaReference(componentName)),
+                    400: createErrorResponse('Invalid query'),
+                    404: createErrorResponse('Not found'),
+                },
+                tags: [resource],
+            },
+            patch: {
+                operationId: operationIds.update,
+                parameters: [createParameterReference('Id')],
+                requestBody: createRequestBody(`${componentName}Update`),
+                responses: {
+                    200: createResponse('Updated', createSchemaReference(componentName)),
+                    400: createErrorResponse('Invalid request'),
+                    404: createErrorResponse('Not found'),
+                },
+                tags: [resource],
+            },
+            put: {
+                operationId: operationIds.replace,
+                parameters: [createParameterReference('Id')],
+                requestBody: createRequestBody(`${componentName}Create`),
+                responses: {
+                    200: createResponse('Replaced', createSchemaReference(componentName)),
+                    400: createErrorResponse('Invalid request'),
+                    404: createErrorResponse('Not found'),
+                },
+                tags: [resource],
+            },
+        },
+    };
+};
+const validateGeneratedNames = (resources, componentNames, files) => {
+    const schemaOwners = new Map([
+        ['Error', 'встроенная схема ошибки'],
+        ...(files
+            ? [
+                ['FileMetadata', 'встроенная схема метаданных файла'],
+                ['FileUpdate', 'встроенная схема изменения файла'],
+            ]
+            : []),
+    ]);
+    resources.forEach((resource) => {
+        const componentName = componentNames[resource];
+        if (componentName === '') {
+            throw new Error(`Не удалось сформировать имя OpenAPI-схемы для ресурса «${resource}». Укажите $schema.${resource}.name`);
+        }
+        [componentName, `${componentName}Create`, `${componentName}Update`, `${componentName}Page`].forEach((schemaName) => {
+            const owner = schemaOwners.get(schemaName);
+            if (owner != null) {
+                throw new Error(`Имя OpenAPI-схемы «${schemaName}» используется ресурсами «${owner}» и «${resource}». Укажите уникальный $schema.${resource}.name`);
+            }
+            schemaOwners.set(schemaName, resource);
+        });
+    });
+};
+const validateOperationIds = (paths) => {
+    const operationOwners = new Map();
+    Object.entries(paths).forEach(([path, pathItem]) => {
+        Object.entries(pathItem).forEach(([method, operation]) => {
+            if (!isObject(operation) || typeof operation.operationId !== 'string') {
+                return;
+            }
+            const owner = operationOwners.get(operation.operationId);
+            if (owner != null) {
+                throw new Error(`operationId «${operation.operationId}» используется операциями «${owner}» и «${method.toUpperCase()} ${path}»`);
+            }
+            operationOwners.set(operation.operationId, `${method.toUpperCase()} ${path}`);
+        });
+    });
+};
+/** Builds an OpenAPI document without runtime server addresses. */
+export function buildOpenapiDocument(options) {
+    const { database, files = false, maxPageSize = DEFAULT_MAX_PAGE_SIZE, schema: schemaConfig = {} } = options ?? {};
+    if (typeof files !== 'boolean') {
+        throw new Error('Ключ files должен содержать boolean');
+    }
+    validateDatabase(database);
+    if (!Number.isInteger(maxPageSize) || maxPageSize < 1) {
+        throw new Error('Максимальный размер страницы должен быть положительным целым числом');
+    }
+    if (!isObject(schemaConfig)) {
+        throw new Error('Схема базы данных должна содержать JSON-объект');
+    }
+    const resources = getResourceNames(database);
+    const resourceConfigs = normalizeSchemaConfig(schemaConfig, resources);
+    const componentNames = Object.fromEntries(resources.map((resource) => {
+        const resourceConfig = resourceConfigs[resource];
+        const componentName = resourceConfig.name ?? toPascalCase(singularize(resource));
+        return [resource, componentName];
+    }));
+    validateGeneratedNames(resources, componentNames, files);
+    const rawSchemas = Object.fromEntries(resources.map((resource) => {
+        const resourceConfig = resourceConfigs[resource];
+        const inferredSchema = database[resource].length === 0 ? { properties: { id: { type: 'string' } }, type: 'object' } : inferObjectSchema(database[resource]);
+        const configuredSchema = mergeSchemaOverrides(inferredSchema, { properties: resourceConfig.properties });
+        return [resource, applyConfiguredFields(ensureGeneratedIdSchema(configuredSchema), resource, resourceConfig)];
+    }));
+    const schemas = {
+        Error: { properties: { error: { type: 'string' } }, required: ['error'], type: 'object' },
+        ...(files && {
+            FileMetadata: FILE_METADATA_SCHEMA,
+            FileUpdate: FILE_UPDATE_SCHEMA,
+        }),
+    };
+    resources.forEach((resource) => {
+        const componentName = componentNames[resource];
+        const rawSchema = rawSchemas[resource];
+        schemas[componentName] = addForwardRelations(rawSchema, resources, componentNames, resource);
+        schemas[`${componentName}Create`] = omitId(rawSchema, true);
+        schemas[`${componentName}Update`] = omitId(rawSchema, false);
+        schemas[`${componentName}Page`] = {
+            properties: {
+                data: { items: createSchemaReference(componentName), type: 'array' },
+                total: { minimum: 0, type: 'integer' },
+            },
+            required: ['data', 'total'],
+            type: 'object',
+        };
+    });
+    addReverseRelations(schemas, rawSchemas, resources, componentNames);
+    const paths = Object.assign({}, ...resources.map((resource) => createResourcePaths(resource, componentNames[resource])), files ? createFilePaths() : {});
+    validateOperationIds(paths);
+    return {
+        components: { parameters: createParameters(maxPageSize), schemas },
+        info: isObject(schemaConfig.$info) ? schemaConfig.$info : { title: 'Deep JSON Server API', version: '1.0.0' },
+        openapi: '3.0.3',
+        paths,
+        tags: [...new Set([...resources, ...(files ? ['files'] : [])])].map((name) => ({ name })),
+    };
+}
+//# sourceMappingURL=document.js.map

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

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

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

@@ -0,0 +1,10 @@
+import type { DatabaseData, JsonObject, OpenapiDocument } from '../types.js';
+export declare const createOpenapi: ({ database, files, host, maxPageSize, port, schema, }: {
+    database: DatabaseData;
+    files: boolean;
+    host?: string;
+    maxPageSize: number;
+    port?: number;
+    schema: JsonObject;
+}) => OpenapiDocument;
+export declare const writeOpenapi: (document: OpenapiDocument, outputPath: string) => Promise<void>;

package/dist/src/openapi/index.js

@@ -0,0 +1,27 @@
+import { mkdir, writeFile } from 'node:fs/promises';
+import { dirname, resolve } from 'node:path';
+import { stringify } from 'yaml';
+import { DEFAULT_HOST, DEFAULT_PORT } from '../constants.js';
+import { buildOpenapiDocument } from './document.js';
+const getServerUrl = (host, port) => {
+    const serverPort = Number(port);
+    if (typeof host !== 'string' || host === '') {
+        throw new Error('Адрес сервера не должен быть пустым');
+    }
+    if (!Number.isInteger(serverPort) || serverPort < 1 || serverPort > 65_535) {
+        throw new Error('Порт должен быть целым числом от 1 до 65535');
+    }
+    const serverHost = host.includes(':') && !host.startsWith('[') ? `[${host}]` : host;
+    return `http://${serverHost}:${serverPort}`;
+};
+export const createOpenapi = ({ database, files, host = DEFAULT_HOST, maxPageSize, port = DEFAULT_PORT, schema, }) => {
+    const document = buildOpenapiDocument({ database, files, maxPageSize, schema });
+    document.servers = [{ url: getServerUrl(host, port) }];
+    return document;
+};
+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=index.js.map