@makebelieve21213-packages/nest-common 1.0.0 → 1.1.0

package/README.md

@@ -261,6 +261,53 @@ async publish(userId: string, event: SOCKET_EVENTS, payload: unknown) {
 }
 ```
 
+### JsonRpcException
+
+Класс исключений для JSON-RPC 2.0 протокола. Используется для обработки ошибок в формате JSON-RPC.
+
+**Расположение:** `src/errors/json-rpc.error.ts`
+
+**Наследование:** `HttpException` (NestJS) - для совместимости с NestJS фильтрами
+
+**Особенности:**
+- Поддерживает стандартные коды ошибок JSON-RPC 2.0
+- Автоматически маппит HTTP статусы на JSON-RPC коды ошибок
+- Поддерживает дополнительные данные в поле `data`
+- Может быть создан из `HttpException` или обычной `Error`
+- Возвращает ответ в формате JSON-RPC 2.0
+
+**Пример использования:**
+
+```typescript
+import { JsonRpcException, JsonRpcErrorCode } from "@packages/nest-common";
+
+// Создание исключения с кодом ошибки
+throw new JsonRpcException(
+    JsonRpcErrorCode.INVALID_REQUEST,
+    "Invalid request parameters",
+    { requestId: "123", details: "Missing required field" },
+);
+
+// Создание из HttpException
+const httpException = new HttpException("Not found", HttpStatus.NOT_FOUND);
+const rpcException = JsonRpcException.fromHttpException(httpException, "request-id");
+
+// Создание из обычной Error
+const error = new Error("Something went wrong");
+const rpcException = JsonRpcException.fromError(error, "request-id");
+```
+
+**Коды ошибок JSON-RPC 2.0:**
+- `PARSE_ERROR` (-32700) - Ошибка парсинга JSON
+- `INVALID_REQUEST` (-32600) - Невалидный запрос
+- `METHOD_NOT_FOUND` (-32601) - Метод не найден
+- `INVALID_PARAMS` (-32602) - Невалидные параметры
+- `INTERNAL_ERROR` (-32603) - Внутренняя ошибка сервера
+- `UNAUTHORIZED` (-32001) - Неавторизованный доступ
+- `FORBIDDEN` (-32002) - Доступ запрещен
+- `NOT_FOUND` (-32003) - Ресурс не найден
+- И другие кастомные коды (-32004 до -32099)
+
 ---
 
 ## 🛡️ Глобальные фильтры
@@ -271,6 +318,70 @@ async publish(userId: string, event: SOCKET_EVENTS, payload: unknown) {
 
 **Расположение:** `src/filters/unified-exception.filter.ts`
 
+### JsonRpcExceptionFilter
+
+Фильтр исключений для обработки ошибок в формате JSON-RPC 2.0. Преобразует все исключения NestJS в формат JSON-RPC 2.0.
+
+**Расположение:** `src/filters/json-rpc-exception.filter.ts`
+
+**Особенности:**
+- Автоматически извлекает `requestId` из тела запроса
+- Преобразует `JsonRpcException` в JSON-RPC формат ответа
+- Преобразует обычные `Error` в JSON-RPC формат с автоматическим определением статуса
+- Обрабатывает неизвестные типы исключений
+- Логирует все ошибки с контекстом
+
+**Использование:**
+
+```typescript
+import { Controller, Post, Body, UseFilters } from "@nestjs/common";
+import { JsonRpcExceptionFilter, JsonRpcValidationPipe } from "@packages/nest-common";
+import type { JsonRpcRequest } from "@packages/nest-common";
+
+@Controller("mcp")
+@UseFilters(JsonRpcExceptionFilter)
+export default class McpController extends BaseController {
+    constructor(private readonly logger: LoggerService) {
+        super();
+    }
+
+    @Post()
+    async handleJsonRpcRequest(
+        @Body(JsonRpcValidationPipe) request: JsonRpcRequest,
+    ) {
+        // Обработка запроса
+        if (request.method === "test.method") {
+            return {
+                jsonrpc: "2.0",
+                id: request.id,
+                result: { success: true },
+            };
+        }
+        
+        throw new JsonRpcException(
+            JsonRpcErrorCode.METHOD_NOT_FOUND,
+            `Method ${request.method} not found`,
+        );
+    }
+}
+```
+
+**Регистрация глобально:**
+
+```typescript
+// В main.ts
+import { JsonRpcExceptionFilter } from "@packages/nest-common";
+
+async function bootstrap() {
+    const app = await NestFactory.create(AppModule);
+    const logger = await connectLogger(app, "ServiceName");
+    
+    app.useGlobalFilters(new JsonRpcExceptionFilter(logger));
+    
+    await app.listen(PORT);
+}
+```
+
 **Регистрация:**
 
 ```typescript
@@ -617,6 +728,45 @@ export default class ApiController extends BaseController {
 }
 ```
 
+### JsonRpcValidationPipe
+
+Валидация JSON-RPC 2.0 запросов согласно спецификации протокола.
+
+**Расположение:** `src/pipes/json-rpc-validation.pipe.ts`
+
+**Особенности:**
+- Проверяет структуру запроса согласно спецификации JSON-RPC 2.0
+- Валидирует версию протокола (`jsonrpc: "2.0"`)
+- Проверяет наличие и тип поля `method` (должно быть строкой)
+- Валидирует тип поля `id` (должно быть string, number или null)
+- Валидирует тип поля `params` (должно быть object или undefined)
+- Игнорирует объекты с NestJS метаданными (constructorRef, handler, contextType)
+- Выбрасывает `JsonRpcException` при ошибках валидации
+
+**Использование:**
+
+```typescript
+import { Controller, Post, Body } from "@nestjs/common";
+import { JsonRpcValidationPipe, JsonRpcExceptionFilter } from "@packages/nest-common";
+import type { JsonRpcRequest } from "@packages/nest-common";
+
+@Controller("mcp")
+@UseFilters(JsonRpcExceptionFilter)
+export default class McpController extends BaseController {
+    @Post()
+    async handleJsonRpcRequest(
+        @Body(JsonRpcValidationPipe) request: JsonRpcRequest,
+    ) {
+        // Обработка JSON-RPC запроса
+        return {
+            jsonrpc: "2.0",
+            id: request.id,
+            result: { /* результат */ },
+        };
+    }
+}
+```
+
 ---
 
 ## 🔍 Перехватчики (дополнительные)

package/dist/errors/__tests__/json-rpc.error.spec.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=json-rpc.error.spec.d.ts.map

package/dist/errors/__tests__/json-rpc.error.spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"json-rpc.error.spec.d.ts","sourceRoot":"","sources":["../../../src/errors/__tests__/json-rpc.error.spec.ts"],"names":[],"mappings":""}

package/dist/errors/__tests__/json-rpc.error.spec.js

@@ -0,0 +1,175 @@
+import { describe, it, expect } from "@jest/globals";
+import { HttpException, HttpStatus } from "@nestjs/common";
+import JsonRpcException from "../../errors/json-rpc.error.js";
+import { JsonRpcErrorCode, JSON_RPC_ERROR_MESSAGES } from "../../types/json-rpc-error-codes.js";
+describe("JsonRpcException", () => {
+    describe("constructor", () => {
+        it("должен создать исключение с кодом ошибки и сообщением по умолчанию", () => {
+            const exception = new JsonRpcException(JsonRpcErrorCode.INTERNAL_ERROR);
+            expect(exception).toBeInstanceOf(HttpException);
+            expect(exception.getRpcErrorCode()).toBe(JsonRpcErrorCode.INTERNAL_ERROR);
+            expect(exception.getStatus()).toBe(HttpStatus.INTERNAL_SERVER_ERROR);
+            const response = exception.getResponse();
+            expect(response).toEqual({
+                jsonrpc: "2.0",
+                error: {
+                    code: JsonRpcErrorCode.INTERNAL_ERROR,
+                    message: JSON_RPC_ERROR_MESSAGES[JsonRpcErrorCode.INTERNAL_ERROR],
+                },
+            });
+        });
+        it("должен создать исключение с кастомным сообщением", () => {
+            const customMessage = "Custom error message";
+            const exception = new JsonRpcException(JsonRpcErrorCode.INVALID_REQUEST, customMessage);
+            expect(exception.getRpcErrorCode()).toBe(JsonRpcErrorCode.INVALID_REQUEST);
+            const response = exception.getResponse();
+            expect(response).toEqual({
+                jsonrpc: "2.0",
+                error: {
+                    code: JsonRpcErrorCode.INVALID_REQUEST,
+                    message: customMessage,
+                },
+            });
+        });
+        it("должен создать исключение с данными", () => {
+            const data = { requestId: "123", details: "Some details" };
+            const exception = new JsonRpcException(JsonRpcErrorCode.INVALID_PARAMS, "Invalid params", data);
+            expect(exception.getRpcData()).toEqual(data);
+            const response = exception.getResponse();
+            expect(response).toEqual({
+                jsonrpc: "2.0",
+                error: {
+                    code: JsonRpcErrorCode.INVALID_PARAMS,
+                    message: "Invalid params",
+                    data,
+                },
+            });
+        });
+        it("должен создать исключение с кастомным HTTP статусом", () => {
+            const exception = new JsonRpcException(JsonRpcErrorCode.INTERNAL_ERROR, "Error", undefined, HttpStatus.BAD_REQUEST);
+            expect(exception.getStatus()).toBe(HttpStatus.BAD_REQUEST);
+        });
+    });
+    describe("getRpcErrorCode", () => {
+        it("должен вернуть код ошибки JSON-RPC", () => {
+            const exception = new JsonRpcException(JsonRpcErrorCode.PARSE_ERROR);
+            expect(exception.getRpcErrorCode()).toBe(JsonRpcErrorCode.PARSE_ERROR);
+        });
+    });
+    describe("getRpcData", () => {
+        it("должен вернуть данные ошибки", () => {
+            const data = { key: "value" };
+            const exception = new JsonRpcException(JsonRpcErrorCode.INTERNAL_ERROR, "Error", data);
+            expect(exception.getRpcData()).toEqual(data);
+        });
+        it("должен вернуть undefined если данные не были переданы", () => {
+            const exception = new JsonRpcException(JsonRpcErrorCode.INTERNAL_ERROR);
+            expect(exception.getRpcData()).toBeUndefined();
+        });
+    });
+    describe("fromHttpException", () => {
+        it("должен создать JsonRpcException из HttpException со строковым ответом", () => {
+            const httpException = new HttpException("Error message", HttpStatus.BAD_REQUEST);
+            const rpcException = JsonRpcException.fromHttpException(httpException, "123");
+            expect(rpcException).toBeInstanceOf(JsonRpcException);
+            expect(rpcException.getStatus()).toBe(HttpStatus.BAD_REQUEST);
+            expect(rpcException.getRpcData()).toEqual({ requestId: "123" });
+        });
+        it("должен создать JsonRpcException из HttpException с объектным ответом", () => {
+            const httpException = new HttpException({ message: "Error message" }, HttpStatus.NOT_FOUND);
+            const rpcException = JsonRpcException.fromHttpException(httpException, 456);
+            expect(rpcException).toBeInstanceOf(JsonRpcException);
+            expect(rpcException.getStatus()).toBe(HttpStatus.NOT_FOUND);
+            expect(rpcException.getRpcData()).toEqual({ requestId: 456 });
+        });
+        it("должен использовать message из exception если response не содержит message", () => {
+            const httpException = new HttpException({ error: "Error" }, HttpStatus.INTERNAL_SERVER_ERROR);
+            httpException.message = "Exception message";
+            const rpcException = JsonRpcException.fromHttpException(httpException);
+            const response = rpcException.getResponse();
+            expect(typeof response === "object" &&
+                response !== null &&
+                "error" in response &&
+                typeof response.error === "object" &&
+                response.error !== null &&
+                "message" in response.error
+                ? response.error.message
+                : "").toBe("Exception message");
+        });
+    });
+    describe("fromError", () => {
+        it("должен создать JsonRpcException из обычной Error", () => {
+            const error = new Error("Something went wrong");
+            const rpcException = JsonRpcException.fromError(error, "789");
+            expect(rpcException).toBeInstanceOf(JsonRpcException);
+            expect(rpcException.getRpcErrorCode()).toBe(JsonRpcErrorCode.INTERNAL_ERROR);
+            expect(rpcException.getRpcData()).toEqual({
+                requestId: "789",
+                name: "Error",
+            });
+        });
+        it("должен использовать null как requestId по умолчанию", () => {
+            const error = new Error("Error");
+            const rpcException = JsonRpcException.fromError(error);
+            expect(rpcException.getRpcData()).toEqual({
+                requestId: null,
+                name: "Error",
+            });
+        });
+    });
+    describe("HTTP статусы для различных кодов ошибок", () => {
+        it("должен вернуть BAD_REQUEST для PARSE_ERROR", () => {
+            const exception = new JsonRpcException(JsonRpcErrorCode.PARSE_ERROR);
+            expect(exception.getStatus()).toBe(HttpStatus.BAD_REQUEST);
+        });
+        it("должен вернуть BAD_REQUEST для INVALID_REQUEST", () => {
+            const exception = new JsonRpcException(JsonRpcErrorCode.INVALID_REQUEST);
+            expect(exception.getStatus()).toBe(HttpStatus.BAD_REQUEST);
+        });
+        it("должен вернуть BAD_REQUEST для INVALID_PARAMS", () => {
+            const exception = new JsonRpcException(JsonRpcErrorCode.INVALID_PARAMS);
+            expect(exception.getStatus()).toBe(HttpStatus.BAD_REQUEST);
+        });
+        it("должен вернуть UNAUTHORIZED для UNAUTHORIZED", () => {
+            const exception = new JsonRpcException(JsonRpcErrorCode.UNAUTHORIZED);
+            expect(exception.getStatus()).toBe(HttpStatus.UNAUTHORIZED);
+        });
+        it("должен вернуть FORBIDDEN для FORBIDDEN", () => {
+            const exception = new JsonRpcException(JsonRpcErrorCode.FORBIDDEN);
+            expect(exception.getStatus()).toBe(HttpStatus.FORBIDDEN);
+        });
+        it("должен вернуть NOT_FOUND для NOT_FOUND", () => {
+            const exception = new JsonRpcException(JsonRpcErrorCode.NOT_FOUND);
+            expect(exception.getStatus()).toBe(HttpStatus.NOT_FOUND);
+        });
+        it("должен вернуть NOT_FOUND для METHOD_NOT_FOUND", () => {
+            const exception = new JsonRpcException(JsonRpcErrorCode.METHOD_NOT_FOUND);
+            expect(exception.getStatus()).toBe(HttpStatus.NOT_FOUND);
+        });
+        it("должен вернуть TOO_MANY_REQUESTS для TOO_MANY_REQUESTS", () => {
+            const exception = new JsonRpcException(JsonRpcErrorCode.TOO_MANY_REQUESTS);
+            expect(exception.getStatus()).toBe(HttpStatus.TOO_MANY_REQUESTS);
+        });
+        it("должен вернуть BAD_GATEWAY для BAD_GATEWAY", () => {
+            const exception = new JsonRpcException(JsonRpcErrorCode.BAD_GATEWAY);
+            expect(exception.getStatus()).toBe(HttpStatus.BAD_GATEWAY);
+        });
+        it("должен вернуть SERVICE_UNAVAILABLE для SERVICE_UNAVAILABLE", () => {
+            const exception = new JsonRpcException(JsonRpcErrorCode.SERVICE_UNAVAILABLE);
+            expect(exception.getStatus()).toBe(HttpStatus.SERVICE_UNAVAILABLE);
+        });
+        it("должен вернуть GATEWAY_TIMEOUT для GATEWAY_TIMEOUT", () => {
+            const exception = new JsonRpcException(JsonRpcErrorCode.GATEWAY_TIMEOUT);
+            expect(exception.getStatus()).toBe(HttpStatus.GATEWAY_TIMEOUT);
+        });
+        it("должен вернуть INTERNAL_SERVER_ERROR для INTERNAL_ERROR", () => {
+            const exception = new JsonRpcException(JsonRpcErrorCode.INTERNAL_ERROR);
+            expect(exception.getStatus()).toBe(HttpStatus.INTERNAL_SERVER_ERROR);
+        });
+        it("должен вернуть INTERNAL_SERVER_ERROR для SERVER_ERROR", () => {
+            const exception = new JsonRpcException(JsonRpcErrorCode.SERVER_ERROR);
+            expect(exception.getStatus()).toBe(HttpStatus.INTERNAL_SERVER_ERROR);
+        });
+    });
+});
+//# sourceMappingURL=json-rpc.error.spec.js.map

package/dist/errors/__tests__/json-rpc.error.spec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"json-rpc.error.spec.js","sourceRoot":"","sources":["../../../src/errors/__tests__/json-rpc.error.spec.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AACrD,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAC3D,OAAO,gBAAgB,MAAM,2BAA2B,CAAC;AACzD,OAAO,EAAE,gBAAgB,EAAE,uBAAuB,EAAE,MAAM,gCAAgC,CAAC;AAE3F,QAAQ,CAAC,kBAAkB,EAAE,GAAG,EAAE;IACjC,QAAQ,CAAC,aAAa,EAAE,GAAG,EAAE;QAC5B,EAAE,CAAC,oEAAoE,EAAE,GAAG,EAAE;YAC7E,MAAM,SAAS,GAAG,IAAI,gBAAgB,CAAC,gBAAgB,CAAC,cAAc,CAAC,CAAC;YAExE,MAAM,CAAC,SAAS,CAAC,CAAC,cAAc,CAAC,aAAa,CAAC,CAAC;YAChD,MAAM,CAAC,SAAS,CAAC,eAAe,EAAE,CAAC,CAAC,IAAI,CAAC,gBAAgB,CAAC,cAAc,CAAC,CAAC;YAC1E,MAAM,CAAC,SAAS,CAAC,SAAS,EAAE,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,qBAAqB,CAAC,CAAC;YAErE,MAAM,QAAQ,GAAG,SAAS,CAAC,WAAW,EAAE,CAAC;YACzC,MAAM,CAAC,QAAQ,CAAC,CAAC,OAAO,CAAC;gBACxB,OAAO,EAAE,KAAK;gBACd,KAAK,EAAE;oBACN,IAAI,EAAE,gBAAgB,CAAC,cAAc;oBACrC,OAAO,EAAE,uBAAuB,CAAC,gBAAgB,CAAC,cAAc,CAAC;iBACjE;aACD,CAAC,CAAC;QACJ,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,kDAAkD,EAAE,GAAG,EAAE;YAC3D,MAAM,aAAa,GAAG,sBAAsB,CAAC;YAC7C,MAAM,SAAS,GAAG,IAAI,gBAAgB,CAAC,gBAAgB,CAAC,eAAe,EAAE,aAAa,CAAC,CAAC;YAExF,MAAM,CAAC,SAAS,CAAC,eAAe,EAAE,CAAC,CAAC,IAAI,CAAC,gBAAgB,CAAC,eAAe,CAAC,CAAC;YAC3E,MAAM,QAAQ,GAAG,SAAS,CAAC,WAAW,EAAE,CAAC;YACzC,MAAM,CAAC,QAAQ,CAAC,CAAC,OAAO,CAAC;gBACxB,OAAO,EAAE,KAAK;gBACd,KAAK,EAAE;oBACN,IAAI,EAAE,gBAAgB,CAAC,eAAe;oBACtC,OAAO,EAAE,aAAa;iBACtB;aACD,CAAC,CAAC;QACJ,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,qCAAqC,EAAE,GAAG,EAAE;YAC9C,MAAM,IAAI,GAAG,EAAE,SAAS,EAAE,KAAK,EAAE,OAAO,EAAE,cAAc,EAAE,CAAC;YAC3D,MAAM,SAAS,GAAG,IAAI,gBAAgB,CACrC,gBAAgB,CAAC,cAAc,EAC/B,gBAAgB,EAChB,IAAI,CACJ,CAAC;YAEF,MAAM,CAAC,SAAS,CAAC,UAAU,EAAE,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;YAC7C,MAAM,QAAQ,GAAG,SAAS,CAAC,WAAW,EAAE,CAAC;YACzC,MAAM,CAAC,QAAQ,CAAC,CAAC,OAAO,CAAC;gBACxB,OAAO,EAAE,KAAK;gBACd,KAAK,EAAE;oBACN,IAAI,EAAE,gBAAgB,CAAC,cAAc;oBACrC,OAAO,EAAE,gBAAgB;oBACzB,IAAI;iBACJ;aACD,CAAC,CAAC;QACJ,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,qDAAqD,EAAE,GAAG,EAAE;YAC9D,MAAM,SAAS,GAAG,IAAI,gBAAgB,CACrC,gBAAgB,CAAC,cAAc,EAC/B,OAAO,EACP,SAAS,EACT,UAAU,CAAC,WAAW,CACtB,CAAC;YAEF,MAAM,CAAC,SAAS,CAAC,SAAS,EAAE,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,WAAW,CAAC,CAAC;QAC5D,CAAC,CAAC,CAAC;IACJ,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,iBAAiB,EAAE,GAAG,EAAE;QAChC,EAAE,CAAC,oCAAoC,EAAE,GAAG,EAAE;YAC7C,MAAM,SAAS,GAAG,IAAI,gBAAgB,CAAC,gBAAgB,CAAC,WAAW,CAAC,CAAC;YACrE,MAAM,CAAC,SAAS,CAAC,eAAe,EAAE,CAAC,CAAC,IAAI,CAAC,gBAAgB,CAAC,WAAW,CAAC,CAAC;QACxE,CAAC,CAAC,CAAC;IACJ,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,YAAY,EAAE,GAAG,EAAE;QAC3B,EAAE,CAAC,8BAA8B,EAAE,GAAG,EAAE;YACvC,MAAM,IAAI,GAAG,EAAE,GAAG,EAAE,OAAO,EAAE,CAAC;YAC9B,MAAM,SAAS,GAAG,IAAI,gBAAgB,CAAC,gBAAgB,CAAC,cAAc,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC;YACvF,MAAM,CAAC,SAAS,CAAC,UAAU,EAAE,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QAC9C,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,uDAAuD,EAAE,GAAG,EAAE;YAChE,MAAM,SAAS,GAAG,IAAI,gBAAgB,CAAC,gBAAgB,CAAC,cAAc,CAAC,CAAC;YACxE,MAAM,CAAC,SAAS,CAAC,UAAU,EAAE,CAAC,CAAC,aAAa,EAAE,CAAC;QAChD,CAAC,CAAC,CAAC;IACJ,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,mBAAmB,EAAE,GAAG,EAAE;QAClC,EAAE,CAAC,uEAAuE,EAAE,GAAG,EAAE;YAChF,MAAM,aAAa,GAAG,IAAI,aAAa,CAAC,eAAe,EAAE,UAAU,CAAC,WAAW,CAAC,CAAC;YACjF,MAAM,YAAY,GAAG,gBAAgB,CAAC,iBAAiB,CAAC,aAAa,EAAE,KAAK,CAAC,CAAC;YAE9E,MAAM,CAAC,YAAY,CAAC,CAAC,cAAc,CAAC,gBAAgB,CAAC,CAAC;YACtD,MAAM,CAAC,YAAY,CAAC,SAAS,EAAE,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,WAAW,CAAC,CAAC;YAC9D,MAAM,CAAC,YAAY,CAAC,UAAU,EAAE,CAAC,CAAC,OAAO,CAAC,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC,CAAC;QACjE,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,sEAAsE,EAAE,GAAG,EAAE;YAC/E,MAAM,aAAa,GAAG,IAAI,aAAa,CAAC,EAAE,OAAO,EAAE,eAAe,EAAE,EAAE,UAAU,CAAC,SAAS,CAAC,CAAC;YAC5F,MAAM,YAAY,GAAG,gBAAgB,CAAC,iBAAiB,CAAC,aAAa,EAAE,GAAG,CAAC,CAAC;YAE5E,MAAM,CAAC,YAAY,CAAC,CAAC,cAAc,CAAC,gBAAgB,CAAC,CAAC;YACtD,MAAM,CAAC,YAAY,CAAC,SAAS,EAAE,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC;YAC5D,MAAM,CAAC,YAAY,CAAC,UAAU,EAAE,CAAC,CAAC,OAAO,CAAC,EAAE,SAAS,EAAE,GAAG,EAAE,CAAC,CAAC;QAC/D,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,4EAA4E,EAAE,GAAG,EAAE;YACrF,MAAM,aAAa,GAAG,IAAI,aAAa,CACtC,EAAE,KAAK,EAAE,OAAO,EAAE,EAClB,UAAU,CAAC,qBAAqB,CAChC,CAAC;YACF,aAAa,CAAC,OAAO,GAAG,mBAAmB,CAAC;YAC5C,MAAM,YAAY,GAAG,gBAAgB,CAAC,iBAAiB,CAAC,aAAa,CAAC,CAAC;YAEvE,MAAM,QAAQ,GAAG,YAAY,CAAC,WAAW,EAAE,CAAC;YAC5C,MAAM,CACL,OAAO,QAAQ,KAAK,QAAQ;gBAC3B,QAAQ,KAAK,IAAI;gBACjB,OAAO,IAAI,QAAQ;gBACnB,OAAO,QAAQ,CAAC,KAAK,KAAK,QAAQ;gBAClC,QAAQ,CAAC,KAAK,KAAK,IAAI;gBACvB,SAAS,IAAI,QAAQ,CAAC,KAAK;gBAC3B,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,OAAO;gBACxB,CAAC,CAAC,EAAE,CACL,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAC;QAC7B,CAAC,CAAC,CAAC;IACJ,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,WAAW,EAAE,GAAG,EAAE;QAC1B,EAAE,CAAC,kDAAkD,EAAE,GAAG,EAAE;YAC3D,MAAM,KAAK,GAAG,IAAI,KAAK,CAAC,sBAAsB,CAAC,CAAC;YAChD,MAAM,YAAY,GAAG,gBAAgB,CAAC,SAAS,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;YAE9D,MAAM,CAAC,YAAY,CAAC,CAAC,cAAc,CAAC,gBAAgB,CAAC,CAAC;YACtD,MAAM,CAAC,YAAY,CAAC,eAAe,EAAE,CAAC,CAAC,IAAI,CAAC,gBAAgB,CAAC,cAAc,CAAC,CAAC;YAC7E,MAAM,CAAC,YAAY,CAAC,UAAU,EAAE,CAAC,CAAC,OAAO,CAAC;gBACzC,SAAS,EAAE,KAAK;gBAChB,IAAI,EAAE,OAAO;aACb,CAAC,CAAC;QACJ,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,qDAAqD,EAAE,GAAG,EAAE;YAC9D,MAAM,KAAK,GAAG,IAAI,KAAK,CAAC,OAAO,CAAC,CAAC;YACjC,MAAM,YAAY,GAAG,gBAAgB,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;YAEvD,MAAM,CAAC,YAAY,CAAC,UAAU,EAAE,CAAC,CAAC,OAAO,CAAC;gBACzC,SAAS,EAAE,IAAI;gBACf,IAAI,EAAE,OAAO;aACb,CAAC,CAAC;QACJ,CAAC,CAAC,CAAC;IACJ,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,yCAAyC,EAAE,GAAG,EAAE;QACxD,EAAE,CAAC,4CAA4C,EAAE,GAAG,EAAE;YACrD,MAAM,SAAS,GAAG,IAAI,gBAAgB,CAAC,gBAAgB,CAAC,WAAW,CAAC,CAAC;YACrE,MAAM,CAAC,SAAS,CAAC,SAAS,EAAE,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,WAAW,CAAC,CAAC;QAC5D,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,gDAAgD,EAAE,GAAG,EAAE;YACzD,MAAM,SAAS,GAAG,IAAI,gBAAgB,CAAC,gBAAgB,CAAC,eAAe,CAAC,CAAC;YACzE,MAAM,CAAC,SAAS,CAAC,SAAS,EAAE,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,WAAW,CAAC,CAAC;QAC5D,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,+CAA+C,EAAE,GAAG,EAAE;YACxD,MAAM,SAAS,GAAG,IAAI,gBAAgB,CAAC,gBAAgB,CAAC,cAAc,CAAC,CAAC;YACxE,MAAM,CAAC,SAAS,CAAC,SAAS,EAAE,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,WAAW,CAAC,CAAC;QAC5D,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,8CAA8C,EAAE,GAAG,EAAE;YACvD,MAAM,SAAS,GAAG,IAAI,gBAAgB,CAAC,gBAAgB,CAAC,YAAY,CAAC,CAAC;YACtE,MAAM,CAAC,SAAS,CAAC,SAAS,EAAE,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,YAAY,CAAC,CAAC;QAC7D,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,wCAAwC,EAAE,GAAG,EAAE;YACjD,MAAM,SAAS,GAAG,IAAI,gBAAgB,CAAC,gBAAgB,CAAC,SAAS,CAAC,CAAC;YACnE,MAAM,CAAC,SAAS,CAAC,SAAS,EAAE,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC;QAC1D,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,wCAAwC,EAAE,GAAG,EAAE;YACjD,MAAM,SAAS,GAAG,IAAI,gBAAgB,CAAC,gBAAgB,CAAC,SAAS,CAAC,CAAC;YACnE,MAAM,CAAC,SAAS,CAAC,SAAS,EAAE,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC;QAC1D,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,+CAA+C,EAAE,GAAG,EAAE;YACxD,MAAM,SAAS,GAAG,IAAI,gBAAgB,CAAC,gBAAgB,CAAC,gBAAgB,CAAC,CAAC;YAC1E,MAAM,CAAC,SAAS,CAAC,SAAS,EAAE,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC;QAC1D,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,wDAAwD,EAAE,GAAG,EAAE;YACjE,MAAM,SAAS,GAAG,IAAI,gBAAgB,CAAC,gBAAgB,CAAC,iBAAiB,CAAC,CAAC;YAC3E,MAAM,CAAC,SAAS,CAAC,SAAS,EAAE,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,iBAAiB,CAAC,CAAC;QAClE,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,4CAA4C,EAAE,GAAG,EAAE;YACrD,MAAM,SAAS,GAAG,IAAI,gBAAgB,CAAC,gBAAgB,CAAC,WAAW,CAAC,CAAC;YACrE,MAAM,CAAC,SAAS,CAAC,SAAS,EAAE,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,WAAW,CAAC,CAAC;QAC5D,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,4DAA4D,EAAE,GAAG,EAAE;YACrE,MAAM,SAAS,GAAG,IAAI,gBAAgB,CAAC,gBAAgB,CAAC,mBAAmB,CAAC,CAAC;YAC7E,MAAM,CAAC,SAAS,CAAC,SAAS,EAAE,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,mBAAmB,CAAC,CAAC;QACpE,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,oDAAoD,EAAE,GAAG,EAAE;YAC7D,MAAM,SAAS,GAAG,IAAI,gBAAgB,CAAC,gBAAgB,CAAC,eAAe,CAAC,CAAC;YACzE,MAAM,CAAC,SAAS,CAAC,SAAS,EAAE,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,eAAe,CAAC,CAAC;QAChE,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,yDAAyD,EAAE,GAAG,EAAE;YAClE,MAAM,SAAS,GAAG,IAAI,gBAAgB,CAAC,gBAAgB,CAAC,cAAc,CAAC,CAAC;YACxE,MAAM,CAAC,SAAS,CAAC,SAAS,EAAE,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,qBAAqB,CAAC,CAAC;QACtE,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,uDAAuD,EAAE,GAAG,EAAE;YAChE,MAAM,SAAS,GAAG,IAAI,gBAAgB,CAAC,gBAAgB,CAAC,YAAY,CAAC,CAAC;YACtE,MAAM,CAAC,SAAS,CAAC,SAAS,EAAE,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,qBAAqB,CAAC,CAAC;QACtE,CAAC,CAAC,CAAC;IACJ,CAAC,CAAC,CAAC;AACJ,CAAC,CAAC,CAAC"}

package/dist/errors/json-rpc.error.d.ts

@@ -0,0 +1,13 @@
+import { HttpException, HttpStatus } from "@nestjs/common";
+import { JsonRpcErrorCode } from "../types/json-rpc-error-codes.js";
+export default class JsonRpcException extends HttpException {
+    private readonly rpcErrorCode;
+    private readonly rpcData?;
+    constructor(rpcErrorCode: JsonRpcErrorCode, message?: string, data?: unknown, httpStatus?: HttpStatus);
+    getRpcErrorCode(): JsonRpcErrorCode;
+    getRpcData(): unknown;
+    static fromHttpException(exception: HttpException, requestId?: number | string | null): JsonRpcException;
+    static fromError(error: Error, requestId?: number | string | null): JsonRpcException;
+    private static getHttpStatus;
+}
+//# sourceMappingURL=json-rpc.error.d.ts.map

package/dist/errors/json-rpc.error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"json-rpc.error.d.ts","sourceRoot":"","sources":["../../src/errors/json-rpc.error.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAC3D,OAAO,EACN,gBAAgB,EAGhB,MAAM,gCAAgC,CAAC;AAIxC,MAAM,CAAC,OAAO,OAAO,gBAAiB,SAAQ,aAAa;IAC1D,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAmB;IAChD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAU;gBAGlC,YAAY,EAAE,gBAAgB,EAC9B,OAAO,CAAC,EAAE,MAAM,EAChB,IAAI,CAAC,EAAE,OAAO,EACd,UAAU,CAAC,EAAE,UAAU;IAsBxB,eAAe,IAAI,gBAAgB;IAKnC,UAAU,IAAI,OAAO;IAKrB,MAAM,CAAC,iBAAiB,CACvB,SAAS,EAAE,aAAa,EACxB,SAAS,GAAE,MAAM,GAAG,MAAM,GAAG,IAAW,GACtC,gBAAgB;IAgBnB,MAAM,CAAC,SAAS,CAAC,KAAK,EAAE,KAAK,EAAE,SAAS,GAAE,MAAM,GAAG,MAAM,GAAG,IAAW,GAAG,gBAAgB;IAQ1F,OAAO,CAAC,MAAM,CAAC,aAAa;CA2B5B"}

package/dist/errors/json-rpc.error.js

@@ -0,0 +1,78 @@
+import { HttpException, HttpStatus } from "@nestjs/common";
+import { JsonRpcErrorCode, JSON_RPC_ERROR_MESSAGES, mapHttpStatusToJsonRpcErrorCode, } from "../types/json-rpc-error-codes.js";
+// Кастомное исключение для JSON-RPC 2.0 протокола
+// Наследуется от HttpException для совместимости с NestJS фильтрами
+export default class JsonRpcException extends HttpException {
+    rpcErrorCode;
+    rpcData;
+    constructor(rpcErrorCode, message, data, httpStatus) {
+        const rpcMessage = message || JSON_RPC_ERROR_MESSAGES[rpcErrorCode];
+        const status = httpStatus || JsonRpcException.getHttpStatus(rpcErrorCode);
+        super({
+            jsonrpc: "2.0",
+            error: {
+                code: rpcErrorCode,
+                message: rpcMessage,
+                ...(data !== undefined && { data }),
+            },
+        }, status);
+        this.rpcErrorCode = rpcErrorCode;
+        this.rpcData = data;
+    }
+    // Получить JSON-RPC код ошибки
+    getRpcErrorCode() {
+        return this.rpcErrorCode;
+    }
+    // Получить данные ошибки
+    getRpcData() {
+        return this.rpcData;
+    }
+    // Создать JsonRpcException из стандартного HttpException
+    static fromHttpException(exception, requestId = null) {
+        const status = exception.getStatus();
+        const response = exception.getResponse();
+        const message = typeof response === "string"
+            ? response
+            : typeof response === "object" && response !== null && "message" in response
+                ? String(response.message)
+                : exception.message;
+        const rpcErrorCode = mapHttpStatusToJsonRpcErrorCode(status);
+        return new JsonRpcException(rpcErrorCode, message, { requestId }, status);
+    }
+    // Создать JsonRpcException из обычной Error
+    static fromError(error, requestId = null) {
+        return new JsonRpcException(JsonRpcErrorCode.INTERNAL_ERROR, error.message, {
+            requestId,
+            name: error.name,
+        });
+    }
+    // Получить HTTP статус из JSON-RPC кода ошибки
+    static getHttpStatus(rpcErrorCode) {
+        switch (rpcErrorCode) {
+            case JsonRpcErrorCode.PARSE_ERROR:
+            case JsonRpcErrorCode.INVALID_REQUEST:
+            case JsonRpcErrorCode.INVALID_PARAMS:
+                return HttpStatus.BAD_REQUEST;
+            case JsonRpcErrorCode.UNAUTHORIZED:
+                return HttpStatus.UNAUTHORIZED;
+            case JsonRpcErrorCode.FORBIDDEN:
+                return HttpStatus.FORBIDDEN;
+            case JsonRpcErrorCode.NOT_FOUND:
+            case JsonRpcErrorCode.METHOD_NOT_FOUND:
+                return HttpStatus.NOT_FOUND;
+            case JsonRpcErrorCode.TOO_MANY_REQUESTS:
+                return HttpStatus.TOO_MANY_REQUESTS;
+            case JsonRpcErrorCode.BAD_GATEWAY:
+                return HttpStatus.BAD_GATEWAY;
+            case JsonRpcErrorCode.SERVICE_UNAVAILABLE:
+                return HttpStatus.SERVICE_UNAVAILABLE;
+            case JsonRpcErrorCode.GATEWAY_TIMEOUT:
+                return HttpStatus.GATEWAY_TIMEOUT;
+            case JsonRpcErrorCode.INTERNAL_ERROR:
+            case JsonRpcErrorCode.SERVER_ERROR:
+            default:
+                return HttpStatus.INTERNAL_SERVER_ERROR;
+        }
+    }
+}
+//# sourceMappingURL=json-rpc.error.js.map

package/dist/errors/json-rpc.error.js.map

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

package/dist/filters/__tests__/json-rpc-exception.filter.spec.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=json-rpc-exception.filter.spec.d.ts.map

package/dist/filters/__tests__/json-rpc-exception.filter.spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"json-rpc-exception.filter.spec.d.ts","sourceRoot":"","sources":["../../../src/filters/__tests__/json-rpc-exception.filter.spec.ts"],"names":[],"mappings":""}