Merge pull request #68 from teacoder-team/dev

Dev

Author: TeaCoder52

packages/nestjs-yookassa/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "nestjs-yookassa",
-	"version": "2.0.4",
+	"version": "2.1.0",
 	"description": "A NestJS library for integrating with YooKassa API",
 	"keywords": [
 		"nest",

packages/nestjs-yookassa/src/common/interfaces/yookassa-options.interface.ts

@@ -14,6 +14,53 @@ export type YookassaModuleOptions = {
 	 * Ключ API для аутентификации в YooKassa.
 	 */
 	apiKey: string
+
+	/**
+	 * Настройки HTTP-прокси для отправки запросов.
+	 *
+	 * Используется в случаях, когда запросы к YooKassa должны идти
+	 * через российский IP — например, если сервер находится за границей.
+	 *
+	 * Пример простого подключения:
+	 * {
+	 *   host: '192.168.1.10',
+	 *   port: 8888,
+	 *   protocol: 'http'
+	 * }
+	 */
+	proxy?: {
+		/**
+		 * Хост или IPv4-адрес прокси-сервера.
+		 * Например: "91.218.114.206"
+		 */
+		host: string
+
+		/**
+		 * Порт, на котором работает прокси.
+		 * Для tinyproxy обычно 8888.
+		 */
+		port: number
+
+		/**
+		 * Протокол для подключения к прокси.
+		 * Почти всегда "http", т.к. tinyproxy не использует HTTPS.
+		 */
+		protocol?: 'http' | 'https'
+
+		/**
+		 * Данные для авторизации на прокси (необязательно).
+		 *
+		 * Используется ТОЛЬКО если прокси защищён логином и паролем.
+		 * В tinyproxy по умолчанию не нужно.
+		 *
+		 * Пример:
+		 * auth: { username: "user", password: "pass" }
+		 */
+		auth?: {
+			username: string
+			password: string
+		}
+	}
 }
 
 /**

packages/nestjs-yookassa/src/core/http/yookassa.http-client.ts

@@ -25,7 +25,20 @@ export class YookassaHttpClient {
 			username: this.config.shopId,
 			password: this.config.apiKey
 		}
+
 		client.defaults.headers.common['Content-Type'] = 'application/json'
+
+		if (this.config.proxy) {
+			client.defaults.proxy = {
+				host: this.config.proxy.host,
+				port: this.config.proxy.port,
+				protocol: this.config.proxy.protocol ?? 'http',
+				auth: this.config.proxy.auth
+			}
+			console.log(
+				`[YooKassa] Proxy enabled → ${this.config.proxy.host}:${this.config.proxy.port}`
+			)
+		}
 	}
 
 	public async request<T = any>(options: AxiosRequestConfig): Promise<T> {
@@ -35,8 +48,7 @@ export class YookassaHttpClient {
 				'Idempotence-Key': randomUUID()
 			}
 
-			const $res = this.httpService.request(options)
-			const res = await firstValueFrom($res)
+			const res = await firstValueFrom(this.httpService.request(options))
 
 			return res.data
 		} catch (error: any) {