@kollors/deep-json-server 0.3.2 → 0.4.0

package/README.md

@@ -19,7 +19,7 @@ Add a script to `package.json`:
 ```json
 {
   "scripts": {
-    "mock": "deep-json-server mock/database.json --port 4001",
+    "mock": "deep-json-server mock/database.json --schema mock/database-schema.json --port 4001",
     "openapi": "deep-json-server mock/database.json --generate mock/database-schema.json mock/openapi-schema.yaml"
   }
 }
@@ -106,7 +106,9 @@ PATCH  /movies/:id
 DELETE /movies/:id
 ```
 
-`POST` generates a string ID, while `PUT` and `PATCH` preserve the stored ID type. All write operations — `POST`, `PUT`, `PATCH` and `DELETE` — persist their changes in the JSON file. The database file must exist before startup and contain a JSON object whose every top-level property is an array of resource records.
+`POST` generates a string ID, while `PUT` and `PATCH` preserve the stored ID type. All write operations — `POST`, `PUT`, `PATCH` and `DELETE` — persist their changes in the JSON file.
+
+The database file must exist before startup. Resource names may contain Latin letters, numbers, `_` and `-`, and must start with a letter. Every resource is an array of JSON objects. Every record must have a non-empty string or finite numeric `id`; IDs must be unique within a resource when compared as strings, so `1` and `"1"` cannot coexist.
 
 ## Pagination and sorting
 
@@ -128,9 +130,9 @@ A GET collection always returns a page object. `_page` defaults to `1`, and `_pe
 }
 ```
 
-Both pagination parameters must be positive integers. Invalid values return `400` instead of being silently corrected.
+Both pagination parameters must be positive integers. `_perPage` cannot exceed `1000` by default; use the programmatic `maxPageSize` option to change that limit. Invalid values return `400` instead of being silently corrected. A page beyond the last page returns an empty `data` array and points `prev` to the last available page instead of silently clamping the request.
 
-Prefix a sort field with `-` for descending order.
+Prefix a sort field with `-` for descending order. Unknown or unsafe sort fields return `400`.
 
 ## Filters
 
@@ -185,6 +187,8 @@ GET /movies/1?_embed=actors.user.country
 GET /genres/2?_embed=parents.parents
 ```
 
+Unknown or malformed `_embed` paths return `400`.
+
 Reverse relationships work as well:
 
 ```http
@@ -273,22 +277,24 @@ Use `name` when a resource needs an explicit schema name instead of the automati
 }
 ```
 
-The generated document describes CRUD endpoints, pagination, sorting, deep filters, `_embed`, and response relations inferred from `...Id` and `...Ids` fields. It can be used as input for tools such as RTK Query OpenAPI Codegen. OpenAPI is generated only when `--generate` is passed; normal server startup does not rewrite the file.
+The generated document describes CRUD endpoints, pagination, sorting, deep filters, `_embed`, and both direct and reverse response relations inferred from `...Id` and `...Ids` fields. A numeric database ID is described as `integer | string`, because a later `POST` creates a string ID in the same resource. The document can be used as input for tools such as RTK Query OpenAPI Codegen. OpenAPI is generated only when `--generate` is passed; normal server startup does not rewrite the file.
+
+During normal startup, request bodies are validated against the inferred resource schemas. Pass `--schema mock/database-schema.json` to apply the same explicit `required`, `formats` and `properties` constraints at runtime. Invalid `POST`, `PUT` and `PATCH` bodies return `400`.
 
 ## Programmatic API
 
 ```js
 import { createServer, generateOpenApi, startServer } from '@kollors/deep-json-server';
 
-const server = await createServer({ databasePath: 'mock/database.json', logger: false });
+const server = await createServer({ databasePath: 'mock/database.json', logger: false, maxPageSize: 1000, schemaPath: 'mock/database-schema.json' });
 
 const response = await server.inject({ method: 'GET', url: '/movies' });
 
 await server.close();
 
-await startServer({ databasePath: 'mock/database.json', host: '127.0.0.1', port: 4001 });
+await startServer({ databasePath: 'mock/database.json', host: '127.0.0.1', port: 4001, schemaPath: 'mock/database-schema.json' });
 
 await generateOpenApi({ databasePath: 'mock/database.json', host: '127.0.0.1', port: 4001, schemaPath: 'mock/database-schema.json', outputPath: 'mock/openapi-schema.yaml' });
 ```
 
-`createServer()` is useful for tests because it returns a Fastify instance without opening a network port.
+`createServer()` is useful for tests because it returns a Fastify instance without opening a network port. The package includes generated TypeScript declarations for all exported functions.

package/README.ru.md

@@ -19,7 +19,7 @@ npm install --save-dev @kollors/deep-json-server
 ```json
 {
   "scripts": {
-    "mock": "deep-json-server mock/database.json --port 4001",
+    "mock": "deep-json-server mock/database.json --schema mock/database-schema.json --port 4001",
     "openapi": "deep-json-server mock/database.json --generate mock/database-schema.json mock/openapi-schema.yaml"
   }
 }
@@ -106,7 +106,9 @@ PATCH  /movies/:id
 DELETE /movies/:id
 ```
 
-`POST` генерирует строковый ID, а `PUT` и `PATCH` сохраняют исходный тип ID. Все операции записи — `POST`, `PUT`, `PATCH` и `DELETE` — сохраняют изменения в JSON-файле. Файл базы должен существовать до запуска и содержать JSON-объект, каждое свойство верхнего уровня которого является массивом записей отдельного ресурса.
+`POST` генерирует строковый ID, а `PUT` и `PATCH` сохраняют исходный тип ID. Все операции записи — `POST`, `PUT`, `PATCH` и `DELETE` — сохраняют изменения в JSON-файле.
+
+Файл базы должен существовать до запуска. Имена ресурсов могут содержать латинские буквы, цифры, `_` и `-` и должны начинаться с буквы. Каждый ресурс является массивом JSON-объектов. У каждой записи должен быть непустой строковый или конечный числовой `id`; ID должны быть уникальны внутри ресурса при сравнении как строки, поэтому `1` и `"1"` не могут существовать одновременно.
 
 ## Пагинация и сортировка
 
@@ -128,9 +130,9 @@ GET-запрос к коллекции всегда возвращает объ
 }
 ```
 
-Оба параметра пагинации должны быть положительными целыми числами. При некорректном значении сервер возвращает `400`, а не исправляет его автоматически.
+Оба параметра пагинации должны быть положительными целыми числами. По умолчанию `_perPage` не может превышать `1000`; лимит можно изменить программным параметром `maxPageSize`. При некорректном значении сервер возвращает `400`, а не исправляет его автоматически. Страница после последней возвращает пустой массив `data`, а `prev` указывает на последнюю доступную страницу.
 
-Префикс `-` перед полем включает сортировку по убыванию.
+Префикс `-` перед полем включает сортировку по убыванию. Неизвестные и небезопасные поля сортировки возвращают `400`.
 
 ## Фильтры
 
@@ -185,6 +187,8 @@ GET /movies/1?_embed=actors.user.country
 GET /genres/2?_embed=parents.parents
 ```
 
+Неизвестные и некорректные пути `_embed` возвращают `400`.
+
 Поддерживаются и обратные связи:
 
 ```http
@@ -273,22 +277,24 @@ deep-json-server mock/database.json --generate mock/database-schema.json mock/op
 }
 ```
 
-В сгенерированном документе описаны CRUD, пагинация, сортировка, глубокие фильтры, `_embed` и связи в ответах, определённые по полям `...Id` и `...Ids`. Файл можно передать, например, в RTK Query OpenAPI Codegen. OpenAPI создаётся только с параметром `--generate`; обычный запуск сервера файл не перезаписывает.
+В сгенерированном документе описаны CRUD, пагинация, сортировка, глубокие фильтры, `_embed`, а также прямые и обратные связи в ответах, определённые по полям `...Id` и `...Ids`. Числовой ID базы описывается как `integer | string`, поскольку последующий `POST` создаст строковый ID в том же ресурсе. Файл можно передать, например, в RTK Query OpenAPI Codegen. OpenAPI создаётся только с параметром `--generate`; обычный запуск сервера файл не перезаписывает.
+
+При обычном запуске тела запросов проверяются по автоматически выведенным схемам ресурсов. Передайте `--schema mock/database-schema.json`, чтобы в runtime применялись те же явные ограничения `required`, `formats` и `properties`. Некорректные тела `POST`, `PUT` и `PATCH` возвращают `400`.
 
 ## Программный API
 
 ```js
 import { createServer, generateOpenApi, startServer } from '@kollors/deep-json-server';
 
-const server = await createServer({ databasePath: 'mock/database.json', logger: false });
+const server = await createServer({ databasePath: 'mock/database.json', logger: false, maxPageSize: 1000, schemaPath: 'mock/database-schema.json' });
 
 const response = await server.inject({ method: 'GET', url: '/movies' });
 
 await server.close();
 
-await startServer({ databasePath: 'mock/database.json', host: '127.0.0.1', port: 4001 });
+await startServer({ databasePath: 'mock/database.json', host: '127.0.0.1', port: 4001, schemaPath: 'mock/database-schema.json' });
 
 await generateOpenApi({ databasePath: 'mock/database.json', host: '127.0.0.1', port: 4001, schemaPath: 'mock/database-schema.json', outputPath: 'mock/openapi-schema.yaml' });
 ```
 
-`createServer()` удобен для тестов: он возвращает экземпляр Fastify, не открывая сетевой порт.
+`createServer()` удобен для тестов: он возвращает экземпляр Fastify, не открывая сетевой порт. Пакет содержит сгенерированные TypeScript-декларации для всех экспортируемых функций.

package/bin/deep-json-server.js

@@ -0,0 +1,11 @@
+#!/usr/bin/env node
+
+import process from 'node:process';
+import { runCli } from '../src/cli.js';
+
+try {
+  await runCli();
+} catch (error) {
+  process.stderr.write(`${error.message}\n`);
+  process.exitCode = 1;
+}

package/index.js

@@ -1,12 +1,2 @@
-#!/usr/bin/env node
-
-import process from 'node:process';
-import { runCli } from './src/cli.js';
-import { isMainModule } from './src/utils.js';
-
-export { createOpenApiDocument, generateOpenApi } from './src/openapi.js';
+export { createOpenApiDocument, generateOpenApi } from './src/openapi/index.js';
 export { createServer, startServer } from './src/server.js';
-
-if (isMainModule(process.argv[1], import.meta.url)) {
-  await runCli();
-}

package/package.json

@@ -1,24 +1,37 @@
 {
   "name": "@kollors/deep-json-server",
-  "version": "0.3.2",
+  "version": "0.4.0",
   "description": "JSON mock server with deep filters and recursive relationship embedding",
   "type": "module",
+  "types": "./types/index.d.ts",
   "bin": {
-    "deep-json-server": "index.js"
+    "deep-json-server": "bin/deep-json-server.js"
   },
   "exports": {
-    ".": "./index.js"
+    ".": {
+      "types": "./types/index.d.ts",
+      "import": "./index.js"
+    }
   },
   "files": [
+    "bin",
     "index.js",
     "src",
+    "types",
     "LICENSE",
     "README.md",
     "README.ru.md"
   ],
   "scripts": {
-    "check": "node --check index.js && node --check src/*.js",
-    "test": "node --test"
+    "check": "node --check index.js && node --check bin/deep-json-server.js && node --check src/*.js && node --check src/openapi/*.js && node --check src/query/*.js",
+    "lint": "biome check .",
+    "lint:fix": "biome check --write .",
+    "prepack": "npm run types",
+    "prepublishOnly": "npm run verify",
+    "test": "node --test",
+    "test:coverage": "node --test --experimental-test-coverage --test-coverage-lines=90 --test-coverage-branches=80 --test-coverage-functions=90",
+    "types": "tsc -p tsconfig.types.json",
+    "verify": "npm run check && npm run lint && npm run test:coverage && npm run types"
   },
   "engines": {
     "node": ">=20"
@@ -49,5 +62,9 @@
   "license": "MIT",
   "publishConfig": {
     "access": "public"
+  },
+  "devDependencies": {
+    "@biomejs/biome": "^2.5.11",
+    "typescript": "^7.0.2"
   }
 }

package/src/cli.js

@@ -1,27 +1,29 @@
 import process from 'node:process';
-import { generateOpenApi } from './openapi.js';
+import { DEFAULT_HOST, DEFAULT_PORT } from './constants.js';
+import { generateOpenApi } from './openapi/index.js';
 import { startServer } from './server.js';
 
-const HELP = `Deep JSON Server
+const HELP_TEXT = `Deep JSON Server
 
 Использование:
-  deep-json-server <database.json> [--host <host>] [--port <port>]
+  deep-json-server <database.json> [--schema <database-schema.json>] [--host <host>] [--port <port>]
   deep-json-server <database.json> --generate <database-schema.json> <openapi-schema.yaml> [--host <host>] [--port <port>]
 
 Параметры:
   --generate  Сгенерировать OpenAPI и завершить работу
   --host, -h  Адрес сервера (по умолчанию 127.0.0.1)
   --port, -p  Порт сервера (по умолчанию 4001)
+  --schema    Проверять запросы записи по указанной схеме
   --help      Показать справку`;
 
-const parseServerOptions = (args) => {
+const parseOptions = (args, allowedOptions) => {
   const options = {};
 
-  for (let index = 1; index < args.length; index += 2) {
+  for (let index = 0; index < args.length; index += 2) {
     const option = args[index];
     const value = args[index + 1];
 
-    if (!['--host', '-h', '--port', '-p'].includes(option)) {
+    if (!allowedOptions.includes(option)) {
       throw new Error(`Неизвестный параметр: ${option}`);
     }
 
@@ -29,7 +31,9 @@ const parseServerOptions = (args) => {
       throw new Error(`Не указано значение параметра ${option}`);
     }
 
-    options[['--host', '-h'].includes(option) ? 'host' : 'port'] = value;
+    const optionName = ['--host', '-h'].includes(option) ? 'host' : ['--port', '-p'].includes(option) ? 'port' : 'schemaPath';
+
+    options[optionName] = value;
   }
 
   return options;
@@ -37,7 +41,7 @@ const parseServerOptions = (args) => {
 
 export async function runCli(args = process.argv.slice(2)) {
   if (args.includes('--help')) {
-    process.stdout.write(`${HELP}\n`);
+    process.stdout.write(`${HELP_TEXT}\n`);
     return;
   }
 
@@ -57,18 +61,18 @@ export async function runCli(args = process.argv.slice(2)) {
       throw new Error('Используйте: deep-json-server <database.json> --generate <database-schema.json> <openapi-schema.yaml> [--host <host>] [--port <port>]');
     }
 
-    const options = parseServerOptions([databasePath, ...args.slice(4)]);
-    const host = options.host ?? process.env.HOST ?? '127.0.0.1';
-    const port = Number(options.port ?? process.env.PORT ?? 4001);
+    const options = parseOptions(args.slice(4), ['--host', '-h', '--port', '-p']);
+    const host = options.host ?? process.env.HOST ?? DEFAULT_HOST;
+    const port = Number(options.port ?? process.env.PORT ?? DEFAULT_PORT);
 
     await generateOpenApi({ databasePath, host, outputPath, port, schemaPath });
     process.stdout.write(`OpenAPI-схема сохранена в ${outputPath}\n`);
     return;
   }
 
-  const options = parseServerOptions(args);
-  const host = options.host ?? process.env.HOST ?? '127.0.0.1';
-  const port = Number(options.port ?? process.env.PORT ?? 4001);
+  const options = parseOptions(args.slice(1), ['--host', '-h', '--port', '-p', '--schema']);
+  const host = options.host ?? process.env.HOST ?? DEFAULT_HOST;
+  const port = Number(options.port ?? process.env.PORT ?? DEFAULT_PORT);
 
-  await startServer({ databasePath, host, port });
+  await startServer({ databasePath, host, port, schemaPath: options.schemaPath });
 }

package/src/constants.js

@@ -0,0 +1,4 @@
+export const DEFAULT_HOST = '127.0.0.1';
+export const DEFAULT_PAGE_SIZE = 10;
+export const DEFAULT_PORT = 4001;
+export const MAX_PAGE_SIZE = 1000;

package/src/database.js

@@ -0,0 +1,128 @@
+import { randomBytes } from 'node:crypto';
+import { readFile } from 'node:fs/promises';
+import { resolve } from 'node:path';
+import { JSONFilePreset } from 'lowdb/node';
+import { createHttpError, isObject, isSafeKey, resolveDatabasePath } from './utils.js';
+
+const RESOURCE_NAME_PATTERN = /^[A-Za-z][A-Za-z0-9_-]*$/;
+
+export const validateDatabase = (data) => {
+  if (!isObject(data)) {
+    throw new Error('База данных должна содержать JSON-объект');
+  }
+
+  Object.entries(data).forEach(([resource, records]) => {
+    if (!RESOURCE_NAME_PATTERN.test(resource) || !isSafeKey(resource)) {
+      throw new Error(`Недопустимое имя ресурса «${resource}»`);
+    }
+
+    if (!Array.isArray(records)) {
+      throw new Error(`Ресурс «${resource}» должен содержать JSON-массив`);
+    }
+
+    const ids = new Set();
+
+    records.forEach((record, index) => {
+      if (!isObject(record)) {
+        throw new Error(`Запись ${index} ресурса «${resource}» должна содержать JSON-объект`);
+      }
+
+      if (typeof record.id !== 'string' && !(typeof record.id === 'number' && Number.isFinite(record.id))) {
+        throw new Error(`Запись ${index} ресурса «${resource}» должна содержать строковый или числовой id`);
+      }
+
+      if (String(record.id) === '') {
+        throw new Error(`Запись ${index} ресурса «${resource}» должна содержать непустой id`);
+      }
+
+      const id = String(record.id);
+
+      if (ids.has(id)) {
+        throw new Error(`Ресурс «${resource}» содержит повторяющийся id «${id}»`);
+      }
+
+      ids.add(id);
+    });
+  });
+
+  return data;
+};
+
+export const readJsonObject = async (path, label) => {
+  let source;
+
+  try {
+    source = await readFile(resolve(path), 'utf8');
+  } catch (error) {
+    if (error?.code === 'ENOENT') {
+      throw new Error(`${label} не найден: ${resolve(path)}`);
+    }
+
+    throw error;
+  }
+
+  const value = JSON.parse(source);
+
+  if (!isObject(value)) {
+    throw new Error(`${label} должен содержать JSON-объект`);
+  }
+
+  return value;
+};
+
+export const readDatabaseFile = async (databasePath) => validateDatabase(await readJsonObject(databasePath, 'Файл базы данных'));
+
+/** @returns {Promise<any>} Internal LowDB-backed store. */
+export const createDatabaseStore = async (databasePath) => {
+  const resolvedDatabasePath = resolveDatabasePath(databasePath);
+  const initialData = await readDatabaseFile(resolvedDatabasePath);
+  const database = await JSONFilePreset(resolvedDatabasePath, initialData);
+  let writeQueue = Promise.resolve();
+
+  const read = async () => {
+    database.data = await readDatabaseFile(resolvedDatabasePath);
+
+    return database.data;
+  };
+
+  const update = (operation) => {
+    const pendingOperation = writeQueue.then(async () => {
+      await read();
+
+      const result = operation(database);
+
+      validateDatabase(database.data);
+      await database.write();
+
+      return result;
+    });
+
+    writeQueue = pendingOperation.catch(() => undefined);
+
+    return pendingOperation;
+  };
+
+  return { database, path: resolvedDatabasePath, read, update };
+};
+
+export const getCollection = (database, resource) => {
+  const collection = isSafeKey(resource) ? database.data[resource] : undefined;
+
+  if (!Array.isArray(collection)) {
+    throw createHttpError(404, 'Ресурс не найден');
+  }
+
+  return collection;
+};
+
+export const findItem = (collection, id) => collection.find((item) => String(item.id) === String(id));
+
+export const createId = (collection) => {
+  let id;
+
+  do {
+    id = randomBytes(8).toString('base64url');
+  } while (findItem(collection, id) != null);
+
+  return id;
+};

package/src/openapi/config.js

@@ -0,0 +1,110 @@
+import { readJsonObject } from '../database.js';
+import { isObject } from '../utils.js';
+import { applyRequiredFields, getSchemasAtPath, updateSchemasAtPath } from './inference.js';
+
+const validateSchemaOverride = (schema, path) => {
+  if (!isObject(schema)) {
+    throw new Error(`OpenAPI-схема свойства «${path}» должна содержать JSON-объект`);
+  }
+
+  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}[]`);
+  }
+
+  if (schema.oneOf != null) {
+    if (!Array.isArray(schema.oneOf) || schema.oneOf.length === 0) {
+      throw new Error(`oneOf свойства «${path}» должен содержать непустой массив`);
+    }
+
+    schema.oneOf.forEach((value, index) => {
+      validateSchemaOverride(value, `${path}.oneOf[${index}]`);
+    });
+  }
+};
+
+export const validateSchemaConfig = (schemaConfig, resources) => {
+  if (
+    Object.hasOwn(schemaConfig, '$info') &&
+    (!isObject(schemaConfig.$info) || !['title', 'version'].every((key) => typeof schemaConfig.$info[key] === 'string' && schemaConfig.$info[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-объект`);
+    }
+
+    if (resourceConfig.name != null && (typeof resourceConfig.name !== 'string' || resourceConfig.name.trim() === '')) {
+      throw new Error(`$schema.${resource}.name должен содержать непустую строку`);
+    }
+
+    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 resourceConfigs;
+};
+
+export const applyConfiguredFields = (schema, resource, resourceConfig) => {
+  const requiredFields = Array.isArray(resourceConfig.required) ? resourceConfig.required : [];
+  const formats = isObject(resourceConfig.formats) ? resourceConfig.formats : {};
+
+  [...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 readSchemaConfig = async (schemaPath) => (schemaPath == null ? {} : readJsonObject(schemaPath, 'Файл схемы базы данных'));