@oneentry/mcp-platform-server 0.1.0 → 0.1.1

package/dist/api/build-catalog.js

@@ -0,0 +1,257 @@
+import { createHash } from 'node:crypto';
+import { capSchema, normalizeSchema } from './normalize-schema.js';
+const API_PREFIX = '/api/admin';
+const METHODS = ['get', 'post', 'put', 'patch', 'delete'];
+/**
+ * Операции, которые остаются за подтверждением при любом уровне `--allow`.
+ * Список путей, а не прав: право можно выдать админу по недоразумению,
+ * а этот барьер снять нельзя.
+ */
+const ALWAYS_CONFIRM = [
+    /^\/immutable-settings/,
+    /^\/admins/,
+    /^\/backups/,
+    /^\/modules/,
+    /^\/payments\/webhook/,
+    /^\/auth\/logout\/all-users/,
+    /^\/settings-general/,
+    /^\/system\/captcha-keys/,
+];
+/** Какие разделы документации объясняют операции конкретного тега. */
+const TAG_DOCS = {
+    Orders: ['back/docs/orders-module', 'back/docs/order-status-axis'],
+    Products: [
+        'back/docs/postgres-db-with-attribute-index',
+        'back/docs/product-relations',
+        'back/docs/isPrice-attribute',
+    ],
+    Payments: ['back/docs/payments-module', 'back/docs/isPrice-attribute'],
+    Blocks: ['back/docs/blocks-module'],
+    Pages: ['back/docs/pages-module'],
+    Discounts: ['back/docs/orders-module'],
+    Filters: ['back/docs/filters'],
+    'Attributes Sets': [
+        'back/docs/postgres-db-with-attribute-index',
+        'back/docs/attribute-indexing',
+        'back/tests/attributes-sets-e2e',
+    ],
+    Menus: ['back/docs/menus-module', 'back/tests/menus-e2e'],
+    'Index Attributes': ['back/docs/attribute-indexing'],
+    Modules: ['back/docs/user-permissions'],
+    Subscriptions: ['back/docs/subscriptions-module'],
+    Forms: ['back/docs/forms-and-form-data'],
+    FormData: ['back/docs/forms-and-form-data'],
+    'User Permissions': ['back/docs/user-permissions', 'front/docs/user-permissions'],
+    'User Groups': ['back/docs/user-permissions'],
+    Admins: ['back/docs/user-permissions', 'back/tests/admins-e2e'],
+    'Global Search': ['back/docs/global-search'],
+    'AI Gateway': ['back/docs/ai-gateway'],
+    'AI Gateway / settings': ['back/docs/ai-gateway'],
+    'File Uploading': ['back/docs/file-upload-dev-mode'],
+    System: ['back/docs/captcha-recaptcha'],
+    Templates: ['back/tests/templates-e2e'],
+    'Template previews': ['back/tests/template-previews-e2e'],
+    Import: ['back/tests/import-e2e'],
+};
+const riskOf = (method) => {
+    if (method === 'get') {
+        return 'read';
+    }
+    return method === 'delete' ? 'destructive' : 'write';
+};
+const isRecord = (value) => typeof value === 'object' && value !== null && !Array.isArray(value);
+const asString = (value) => typeof value === 'string' && value.trim() !== '' ? value.trim() : undefined;
+/** Собирает одну человекочитаемую строку описания успешного ответа. */
+const responseSummary = (responses) => {
+    if (!isRecord(responses)) {
+        return undefined;
+    }
+    for (const code of ['200', '201', '202']) {
+        const entry = responses[code];
+        if (isRecord(entry)) {
+            const description = asString(entry['description']);
+            if (description) {
+                return description.replace(/\s+/g, ' ').slice(0, 300);
+            }
+        }
+    }
+    return undefined;
+};
+const buildParams = (raw, components) => {
+    if (!Array.isArray(raw)) {
+        return [];
+    }
+    const params = [];
+    for (const item of raw) {
+        if (!isRecord(item)) {
+            continue;
+        }
+        const location = asString(item['in']);
+        const name = asString(item['name']);
+        if (!name || (location !== 'path' && location !== 'query' && location !== 'header')) {
+            continue;
+        }
+        params.push({
+            name,
+            location,
+            required: item['required'] === true || location === 'path',
+            description: asString(item['description']),
+            schema: normalizeSchema(item['schema'], components),
+            example: item['example'],
+        });
+    }
+    return params;
+};
+const buildBody = (raw, components) => {
+    if (!isRecord(raw)) {
+        return undefined;
+    }
+    const content = raw['content'];
+    if (!isRecord(content)) {
+        return undefined;
+    }
+    const contentType = Object.keys(content)[0];
+    if (!contentType) {
+        return undefined;
+    }
+    const media = content[contentType];
+    if (!isRecord(media)) {
+        return undefined;
+    }
+    return {
+        contentType,
+        schema: capSchema(normalizeSchema(media['schema'], components)),
+        required: raw['required'] === true,
+    };
+};
+/**
+ * Строит каталог операций из swagger стенда и карты прав.
+ * Два источника, потому что ни одного не хватает: swagger даёт пути и схемы,
+ * а требуемое право объявлено декоратором и в swagger не попадает.
+ * Классификация риска и список навсегда подтверждаемых путей вычисляются здесь,
+ * то есть в коде пакета, — swagger приходит по сети и не должен на них влиять.
+ */
+export const buildCatalog = (params) => {
+    const { rawSwagger } = params;
+    const swagger = JSON.parse(rawSwagger);
+    if (!isRecord(swagger) || !isRecord(swagger['paths'])) {
+        throw new Error('The fetched document does not look like an OpenAPI document');
+    }
+    const componentsNode = swagger['components'];
+    const components = isRecord(componentsNode) && isRecord(componentsNode['schemas'])
+        ? componentsNode['schemas']
+        : {};
+    const { byOpId, permissions } = params.permissions;
+    const operations = [];
+    /** Пути не из Admin API и операции без operationId — оба случая идут в warnings. */
+    const foreignPaths = [];
+    const withoutOpId = [];
+    for (const [fullPath, pathItem] of Object.entries(swagger['paths'])) {
+        if (!isRecord(pathItem)) {
+            continue;
+        }
+        /**
+         * Путь вне `/api/admin` в каталог не попадает никогда: сервер по замыслу
+         * не выпускает наружу Content и Developer API. Документ приходит по сети,
+         * поэтому здесь фильтр, а не исключение — одна лишняя запись не должна
+         * лишать агента всего каталога.
+         */
+        if (!fullPath.startsWith(API_PREFIX)) {
+            foreignPaths.push(fullPath);
+            continue;
+        }
+        const path = fullPath.slice(API_PREFIX.length) || '/';
+        for (const method of METHODS) {
+            const operation = pathItem[method];
+            if (!isRecord(operation)) {
+                continue;
+            }
+            const opId = asString(operation['operationId']);
+            if (!opId) {
+                withoutOpId.push(`${method.toUpperCase()} ${fullPath}`);
+                continue;
+            }
+            const tags = operation['tags'];
+            const tag = (Array.isArray(tags) ? asString(tags[0]) : undefined) ?? 'Other';
+            const summary = asString(operation['summary']) ?? asString(operation['description']) ?? '';
+            const risk = riskOf(method);
+            const alwaysConfirm = method !== 'get' && ALWAYS_CONFIRM.some((pattern) => pattern.test(path));
+            const permission = byOpId[opId];
+            const entry = {
+                opId,
+                method,
+                path,
+                fullPath,
+                tag,
+                summary,
+                ...(permission ? { permission } : {}),
+                risk,
+                alwaysConfirm,
+                params: buildParams(operation['parameters'], components),
+                ...(buildBody(operation['requestBody'], components)
+                    ? { body: buildBody(operation['requestBody'], components) }
+                    : {}),
+                ...(responseSummary(operation['responses'])
+                    ? { responseSummary: responseSummary(operation['responses']) }
+                    : {}),
+                docLinks: [...(TAG_DOCS[tag] ?? []), 'mcp/operating-rules'],
+                searchText: '',
+            };
+            entry.searchText = [opId, method.toUpperCase(), path, tag, summary, permission ?? '']
+                .join(' ')
+                .toLowerCase();
+            operations.push(entry);
+        }
+    }
+    operations.sort((a, b) => a.opId.localeCompare(b.opId));
+    const warnings = [];
+    if (foreignPaths.length > 0) {
+        warnings.push(`${String(foreignPaths.length)} path(s) outside ${API_PREFIX} were dropped from the catalog ` +
+            `(e.g. ${foreignPaths.slice(0, 3).join(', ')}). This server exposes the Admin API only.`);
+    }
+    if (withoutOpId.length > 0) {
+        warnings.push(`${String(withoutOpId.length)} operation(s) have no operationId and cannot be called ` +
+            `(e.g. ${withoutOpId.slice(0, 3).join(', ')}). Report it against the CMS.`);
+    }
+    /**
+     * Обработчик объявляет право, но живой swagger о нём не знает.
+     * Раньше это означало устаревший снимок swagger; теперь документ приходит
+     * со стенда, поэтому смысл другой: карта прав собрана с другой версии кода,
+     * чем развёрнута на стенде. Агенту это важно так же — иначе он получит 404
+     * на существующий, по его данным, эндпоинт.
+     */
+    const known = new Set(operations.map((o) => o.opId));
+    const missing = Object.keys(byOpId).filter((opId) => !known.has(opId) && !opId.startsWith('Developer') && !opId.startsWith('Content'));
+    if (missing.length > 0) {
+        warnings.push(`${String(missing.length)} admin handler(s) declare a permission but are absent from the ` +
+            `stand's swagger (e.g. ${missing.slice(0, 3).join(', ')}). data/permissions.json was ` +
+            'generated from a different revision of dnk-back than the stand runs — re-run ' +
+            'npm run sync:permissions if the catalog looks incomplete.');
+    }
+    /**
+     * Право, объявленное контроллером, но отсутствующее в `AdminPermissionsEnum`,
+     * никогда не будет выдано администратору — такой эндпоинт отвечает 403 всегда.
+     * Это дефект dnk-back, и о нём должен знать и агент, и человек.
+     */
+    const knownPermissions = new Set(permissions);
+    const orphanPermissions = [
+        ...new Set(operations
+            .map((operation) => operation.permission)
+            .filter((value) => value !== undefined && !knownPermissions.has(value))),
+    ];
+    if (orphanPermissions.length > 0) {
+        warnings.push(`${orphanPermissions.length} permission(s) are required by controllers but missing from ` +
+            `AdminPermissionsEnum (${orphanPermissions.join(', ')}). No admin can hold them, so those ` +
+            'operations always answer 403 — report it rather than retrying.');
+    }
+    return {
+        version: 1,
+        builtAt: params.builtAt,
+        apiPrefix: API_PREFIX,
+        swaggerHash: createHash('sha256').update(rawSwagger).digest('hex').slice(0, 16),
+        permissions,
+        warnings,
+        operations,
+    };
+};
+//# sourceMappingURL=build-catalog.js.map

package/dist/api/build-catalog.js.map

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

package/dist/api/catalog.d.ts

@@ -1,3 +1,5 @@
+import type { Config } from '../config/config.js';
+import { type PermissionMap } from './build-catalog.js';
 import type { Catalog, Operation } from './types.js';
 /** Найденная операция с оценкой релевантности. */
 export interface OperationHit {
@@ -17,10 +19,27 @@ export interface OperationHit {
  * полнотекстовый движок дал бы ту же выдачу при большем весе.
  */
 export declare class OperationCatalog {
-    private readonly byOpId;
-    readonly catalog: Catalog;
+    private byOpId;
+    catalog: Catalog;
     constructor(catalog: Catalog);
-    static load(): OperationCatalog;
+    /** Карта прав — единственное, что осталось предсобранным: её нет в swagger. */
+    static permissionMap(): PermissionMap;
+    /**
+     * Строит каталог из swagger подключённого стенда.
+     * Недоступный стенд не мешает серверу подняться: каталог получается пустым,
+     * а причина уходит в `warnings` и оттуда в `cms_guide` и `cms_whoami`.
+     * Пустой каталог безопасен — вызвать по нему нечего, — но молчать о нём нельзя.
+     */
+    static resolve(config: Config, bearer?: string): Promise<OperationCatalog>;
+    /** Каталог не удалось собрать при старте — стенд был недоступен или закрыт авторизацией. */
+    get isEmpty(): boolean;
+    /**
+     * Заменяет содержимое каталога, собранного вхолостую.
+     * Нужно remote-режиму: процесс поднимается без учётных данных, и если стенд
+     * отдаёт swagger только авторизованным, единственный шанс получить каталог —
+     * первая сессия с токеном. Каталог общий на процесс, поэтому и подмена одна.
+     */
+    adopt(other: OperationCatalog): void;
     get(opId: string): Operation | undefined;
     operations(): readonly Operation[];
     /**

package/dist/api/catalog.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"catalog.d.ts","sourceRoot":"","sources":["../../src/api/catalog.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAErD,kDAAkD;AAClD,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,SAAS,CAAC,MAAM,CAAC,CAAC;IACxB,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;;;;GAKG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAyB;IAChD,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;gBAEd,OAAO,EAAE,OAAO;IAS5B,MAAM,CAAC,IAAI,IAAI,gBAAgB;IAK/B,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS;IAIxC,UAAU,IAAI,SAAS,SAAS,EAAE;IAIlC;;;OAGG;IACH,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,SAAI,GAAG,MAAM,EAAE;IAU1C,MAAM,CAAC,MAAM,EAAE;QACb,KAAK,EAAE,MAAM,CAAC;QACd,GAAG,CAAC,EAAE,MAAM,CAAC;QACb,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,QAAQ,CAAC,EAAE,OAAO,CAAC;QACnB,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB,GAAG,YAAY,EAAE;CA+CnB"}
+{"version":3,"file":"catalog.d.ts","sourceRoot":"","sources":["../../src/api/catalog.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAElD,OAAO,EAAgB,KAAK,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAEtE,OAAO,KAAK,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAErD,kDAAkD;AAClD,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,SAAS,CAAC,MAAM,CAAC,CAAC;IACxB,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;;;;GAKG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,MAAM,CAAyB;IACvC,OAAO,EAAE,OAAO,CAAC;gBAEL,OAAO,EAAE,OAAO;IAS5B,+EAA+E;IAC/E,MAAM,CAAC,aAAa,IAAI,aAAa;IAMrC;;;;;OAKG;WACU,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC;IA2ChF,4FAA4F;IAC5F,IAAI,OAAO,IAAI,OAAO,CAErB;IAED;;;;;OAKG;IACH,KAAK,CAAC,KAAK,EAAE,gBAAgB,GAAG,IAAI;IAKpC,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS;IAIxC,UAAU,IAAI,SAAS,SAAS,EAAE;IAIlC;;;OAGG;IACH,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,SAAI,GAAG,MAAM,EAAE;IAU1C,MAAM,CAAC,MAAM,EAAE;QACb,KAAK,EAAE,MAAM,CAAC;QACd,GAAG,CAAC,EAAE,MAAM,CAAC;QACb,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,QAAQ,CAAC,EAAE,OAAO,CAAC;QACnB,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB,GAAG,YAAY,EAAE;CA+CnB"}

package/dist/api/catalog.js

@@ -1,6 +1,8 @@
 import { readFileSync } from 'node:fs';
 import { resolve } from 'node:path';
 import { dataDir } from '../knowledge/loader.js';
+import { buildCatalog } from './build-catalog.js';
+import { fetchSwagger } from './swagger-source.js';
 /**
  * Индекс каталога операций.
  * Поиск здесь примитивный — подсчёт совпадений термов по склеенной строке.
@@ -14,13 +16,76 @@ export class OperationCatalog {
         if (catalog.version !== 1) {
             throw new Error(`Unsupported catalog version ${String(catalog.version)}`);
         }
-        /** Снапшот приходит из файла, поэтому необязательные поля нормализуем на входе. */
+        /** Каталог собирается из документа, полученного по сети: поля нормализуем на входе. */
         this.catalog = { ...catalog, warnings: catalog.warnings ?? [] };
         this.byOpId = new Map(catalog.operations.map((o) => [o.opId, o]));
     }
-    static load() {
-        const file = resolve(dataDir(), 'catalog.json');
-        return new OperationCatalog(JSON.parse(readFileSync(file, 'utf8')));
+    /** Карта прав — единственное, что осталось предсобранным: её нет в swagger. */
+    static permissionMap() {
+        const file = resolve(dataDir(), 'permissions.json');
+        const parsed = JSON.parse(readFileSync(file, 'utf8'));
+        return { byOpId: parsed.byOpId, permissions: parsed.permissions };
+    }
+    /**
+     * Строит каталог из swagger подключённого стенда.
+     * Недоступный стенд не мешает серверу подняться: каталог получается пустым,
+     * а причина уходит в `warnings` и оттуда в `cms_guide` и `cms_whoami`.
+     * Пустой каталог безопасен — вызвать по нему нечего, — но молчать о нём нельзя.
+     */
+    static async resolve(config, bearer) {
+        const builtAt = new Date().toISOString();
+        try {
+            const swagger = await fetchSwagger({
+                baseUrl: config.baseUrl,
+                cacheDir: config.cacheDir,
+                timeoutMs: config.requestTimeoutMs,
+                ...(bearer ? { bearer } : {}),
+            });
+            const catalog = buildCatalog({
+                rawSwagger: swagger.raw,
+                permissions: OperationCatalog.permissionMap(),
+                builtAt,
+            });
+            return new OperationCatalog(swagger.origin === 'cache'
+                ? {
+                    ...catalog,
+                    warnings: [
+                        ...catalog.warnings,
+                        `The stand at ${config.baseUrl} was unreachable; this catalog came from the ` +
+                            'on-disk cache and may not match the API that is actually running.',
+                    ],
+                }
+                : catalog);
+        }
+        catch (error) {
+            return new OperationCatalog({
+                version: 1,
+                builtAt,
+                apiPrefix: '/api/admin',
+                swaggerHash: '',
+                permissions: [],
+                warnings: [
+                    `The operation catalog is EMPTY: ${config.baseUrl} did not serve its swagger ` +
+                        `(${error instanceof Error ? error.message : String(error)}). ` +
+                        'No API operation can be searched or called until the stand is reachable.',
+                ],
+                operations: [],
+            });
+        }
+    }
+    /** Каталог не удалось собрать при старте — стенд был недоступен или закрыт авторизацией. */
+    get isEmpty() {
+        return this.catalog.operations.length === 0;
+    }
+    /**
+     * Заменяет содержимое каталога, собранного вхолостую.
+     * Нужно remote-режиму: процесс поднимается без учётных данных, и если стенд
+     * отдаёт swagger только авторизованным, единственный шанс получить каталог —
+     * первая сессия с токеном. Каталог общий на процесс, поэтому и подмена одна.
+     */
+    adopt(other) {
+        this.catalog = other.catalog;
+        this.byOpId = new Map(other.catalog.operations.map((o) => [o.opId, o]));
     }
     get(opId) {
         return this.byOpId.get(opId);

package/dist/api/catalog.js.map

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

package/dist/api/normalize-schema.d.ts

@@ -0,0 +1,14 @@
+import type { JsonSchema } from './types.js';
+/**
+ * Разворачивает `$ref` и нормализует типы за один проход.
+ * Циклы (а они есть: сущности ссылаются друг на друга) обрываются заглушкой,
+ * иначе разворачивание не завершится; глубина ограничена, чтобы схема осталась читаемой.
+ */
+export declare const normalizeSchema: (node: unknown, components: Record<string, unknown>, depth?: number, refStack?: readonly string[]) => JsonSchema;
+/**
+ * Урезает слишком большую схему до верхнего уровня свойств.
+ * Схема тела запроса уходит прямо в контекст модели, и развёрнутый DTO
+ * на 40 КБ вытеснит из него саму задачу.
+ */
+export declare const capSchema: (schema: JsonSchema) => JsonSchema;
+//# sourceMappingURL=normalize-schema.d.ts.map

package/dist/api/normalize-schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalize-schema.d.ts","sourceRoot":"","sources":["../../src/api/normalize-schema.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AA2C7C;;;;GAIG;AACH,eAAO,MAAM,eAAe,GAC1B,MAAM,OAAO,EACb,YAAY,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACnC,cAAS,EACT,WAAU,SAAS,MAAM,EAAO,KAC/B,UA8FF,CAAC;AAIF;;;;GAIG;AACH,eAAO,MAAM,SAAS,GAAI,QAAQ,UAAU,KAAG,UAmB9C,CAAC"}

package/dist/api/normalize-schema.js

@@ -0,0 +1,151 @@
+/** Валидные типы JSON Schema. Всё остальное в этом swagger — TypeScript-выражения. */
+const VALID_TYPES = new Set(['object', 'array', 'string', 'number', 'integer', 'boolean', 'null']);
+/**
+ * Приведение TypeScript-подобных типов из swagger к JSON Schema.
+ * Проект генерирует схемы из декораторов NestJS, и `type` часто содержит
+ * TS-выражение; таблица покрывает частые случаи, остальное помечается x-loose.
+ */
+const TYPE_MAP = {
+    date: { type: 'string', format: 'date-time' },
+    Date: { type: 'string', format: 'date-time' },
+    'iso-date': { type: 'string', format: 'date-time' },
+    float: { type: 'number' },
+    int: { type: 'integer' },
+    json: { type: 'object' },
+    list: { type: 'array' },
+    text: { type: 'string' },
+    textWithHeader: { type: 'string' },
+    image: { type: 'object' },
+    file: { type: 'object' },
+    'number[]': { type: 'array', items: { type: 'number' } },
+    'string[]': { type: 'array', items: { type: 'string' } },
+};
+const MAX_DESCRIPTION = 240;
+const MAX_DEPTH = 6;
+const trimDescription = (value) => {
+    if (typeof value !== 'string' || value.trim() === '') {
+        return undefined;
+    }
+    const flat = value.replace(/\s+/g, ' ').trim();
+    return flat.length > MAX_DESCRIPTION ? `${flat.slice(0, MAX_DESCRIPTION)}…` : flat;
+};
+const isRecord = (value) => typeof value === 'object' && value !== null && !Array.isArray(value);
+/**
+ * Разворачивает `$ref` и нормализует типы за один проход.
+ * Циклы (а они есть: сущности ссылаются друг на друга) обрываются заглушкой,
+ * иначе разворачивание не завершится; глубина ограничена, чтобы схема осталась читаемой.
+ */
+export const normalizeSchema = (node, components, depth = 0, refStack = []) => {
+    if (!isRecord(node)) {
+        return {};
+    }
+    const ref = node['$ref'];
+    if (typeof ref === 'string') {
+        const name = ref.split('/').pop() ?? '';
+        if (refStack.includes(name)) {
+            return { type: 'object', description: `(recursive ${name}, omitted)` };
+        }
+        const target = components[name];
+        if (target === undefined) {
+            return { type: 'object', description: `(unresolved ${name})` };
+        }
+        return normalizeSchema(target, components, depth, [...refStack, name]);
+    }
+    /** allOf/oneOf/anyOf в этом swagger встречаются только как обёртки — берём первый член. */
+    for (const key of ['allOf', 'oneOf', 'anyOf']) {
+        const variants = node[key];
+        if (Array.isArray(variants) && variants.length > 0) {
+            const merged = normalizeSchema(variants[0], components, depth, refStack);
+            const description = trimDescription(node['description']);
+            return description ? { ...merged, description } : merged;
+        }
+    }
+    const out = {};
+    const rawType = node['type'];
+    if (typeof rawType === 'string') {
+        if (VALID_TYPES.has(rawType)) {
+            out.type = rawType;
+        }
+        else {
+            const mapped = TYPE_MAP[rawType];
+            if (mapped) {
+                out.type = mapped.type;
+                if (mapped.format) {
+                    out.format = mapped.format;
+                }
+                if (mapped.items) {
+                    out.items = mapped.items;
+                }
+            }
+            else if (rawType.startsWith('Record<')) {
+                out.type = 'object';
+            }
+            out['x-source-type'] = rawType;
+            out['x-loose'] = true;
+        }
+    }
+    const format = node['format'];
+    if (typeof format === 'string' && !out.format) {
+        out.format = format;
+    }
+    const description = trimDescription(node['description']);
+    if (description) {
+        out.description = description;
+    }
+    if (node['example'] !== undefined) {
+        out.example = node['example'];
+    }
+    if (Array.isArray(node['enum'])) {
+        out.enum = node['enum'];
+    }
+    if (depth >= MAX_DEPTH) {
+        out['x-truncated'] = true;
+        return out;
+    }
+    if (node['items'] !== undefined) {
+        out.items = normalizeSchema(node['items'], components, depth + 1, refStack);
+        if (!out.type) {
+            out.type = 'array';
+        }
+    }
+    const properties = node['properties'];
+    if (isRecord(properties)) {
+        out.type = out.type ?? 'object';
+        out.properties = {};
+        for (const [key, value] of Object.entries(properties)) {
+            out.properties[key] = normalizeSchema(value, components, depth + 1, refStack);
+        }
+    }
+    const required = node['required'];
+    if (Array.isArray(required) && required.every((r) => typeof r === 'string')) {
+        out.required = required;
+    }
+    return out;
+};
+const MAX_SCHEMA_BYTES = 6_144;
+/**
+ * Урезает слишком большую схему до верхнего уровня свойств.
+ * Схема тела запроса уходит прямо в контекст модели, и развёрнутый DTO
+ * на 40 КБ вытеснит из него саму задачу.
+ */
+export const capSchema = (schema) => {
+    if (Buffer.byteLength(JSON.stringify(schema), 'utf8') <= MAX_SCHEMA_BYTES) {
+        return schema;
+    }
+    if (!schema.properties) {
+        return { ...schema, 'x-truncated': true };
+    }
+    const shallow = {};
+    for (const [key, value] of Object.entries(schema.properties)) {
+        shallow[key] = {
+            ...(value.type ? { type: value.type } : {}),
+            ...(value.format ? { format: value.format } : {}),
+            ...(value.description ? { description: value.description } : {}),
+            ...(value.example !== undefined ? { example: value.example } : {}),
+            ...(value['x-loose'] ? { 'x-loose': true } : {}),
+            ...(value.properties || value.items ? { 'x-truncated': true } : {}),
+        };
+    }
+    return { ...schema, properties: shallow, 'x-truncated': true };
+};
+//# sourceMappingURL=normalize-schema.js.map

package/dist/api/normalize-schema.js.map

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

package/dist/api/swagger-source.d.ts

@@ -0,0 +1,22 @@
+/** Откуда и как забирать swagger. */
+export interface SwaggerSource {
+    /** Базовый URL Admin API, уже нормализованный (с `/api/admin`, без слэша на конце). */
+    baseUrl: string;
+    cacheDir: string;
+    timeoutMs: number;
+    /** Bearer-токен: нужен, если стенд закрывает этот эндпоинт авторизацией. */
+    bearer?: string;
+}
+/** Полученный документ и то, откуда он взялся. */
+export interface FetchedSwagger {
+    raw: string;
+    origin: 'stand' | 'cache';
+}
+/**
+ * Забирает swagger со стенда, с откатом на кэш.
+ * Эндпоинт публичный на большинстве стендов, поэтому первый запрос идёт без
+ * авторизации: в remote-режиме на момент старта процесса учётных данных может
+ * не быть вовсе. Токен добавляется только если стенд ответил 401/403.
+ */
+export declare const fetchSwagger: (source: SwaggerSource) => Promise<FetchedSwagger>;
+//# sourceMappingURL=swagger-source.d.ts.map