docs: general documentation improvements

Author: TeaCoder52

apps/www/eslint.config.mjs

@@ -0,0 +1,18 @@
+import nextCoreWebVitals from "eslint-config-next/core-web-vitals";
+import nextTypescript from "eslint-config-next/typescript";
+
+const eslintConfig = [
+  ...nextCoreWebVitals,
+  ...nextTypescript,
+  {
+    ignores: [
+      "node_modules/**",
+      ".next/**",
+      "out/**",
+      "build/**",
+      "next-env.d.ts",
+    ],
+  },
+];
+
+export default eslintConfig;

apps/www/package.json

@@ -31,10 +31,10 @@
 		"geist": "^1.3.1",
 		"lucide-react": "^0.460.0",
 		"mdx": "^0.3.1",
-		"next": "15.0.3",
+		"next": "16.0.8",
 		"next-themes": "^0.4.3",
-		"react": "19.0.0-rc-66855b96-20241106",
-		"react-dom": "19.0.0-rc-66855b96-20241106",
+		"react": "19.2.1",
+		"react-dom": "19.2.1",
 		"react-icons": "^5.3.0",
 		"rehype-katex": "^7.0.1",
 		"rehype-shiki": "^0.0.9",
@@ -47,15 +47,23 @@
 		"@tailwindcss/postcss": "^4.1.7",
 		"@trivago/prettier-plugin-sort-imports": "^4.3.0",
 		"@types/node": "^20",
-		"@types/react": "npm:types-react@19.0.0-rc.1",
-		"@types/react-dom": "npm:types-react-dom@19.0.0-rc.1",
+		"@types/react": "19.2.7",
+		"@types/react-dom": "19.2.3",
 		"prettier": "^3.5.3",
 		"prettier-plugin-tailwindcss": "^0.6.9",
 		"tailwindcss": "^4.1.7",
-		"typescript": "^5"
+		"typescript": "^5",
+		"eslint": "^9",
+		"eslint-config-next": "16.0.8"
 	},
 	"overrides": {
 		"@types/react": "npm:types-react@19.0.0-rc.1",
 		"@types/react-dom": "npm:types-react-dom@19.0.0-rc.1"
+	},
+	"pnpm": {
+		"overrides": {
+			"@types/react": "19.2.7",
+			"@types/react-dom": "19.2.3"
+		}
 	}
 }

apps/www/src/content/docs/getting-started/installation.mdx

@@ -130,4 +130,54 @@ export class AppModule {}
 
 В этом случае конфигурация будет храниться в отдельном файле, что улучшает структуру и позволяет легче управлять параметрами окружения.
 
+### Работа через прокси
+
+Некоторым приложениям требуется отправлять запросы к API YooKassa через прокси-сервер. Данные модуль поддерживает такой сценарий с помощью параметра `proxyUrl`.
+
+#### Когда нужен прокси?
+
+Используйте proxyUrl, если:
+
+сервер работает за корпоративным прокси;
+нужно логировать / инспектировать трафик;
+есть ограничения на исходящие запросы;
+требуется скрыть исходящий IP;
+
+Поддерживаются HTTP и HTTPS прокси:
+
+```
+http://127.0.0.1:8080
+https://proxy.example.com:443
+```
+
+#### Переменная окружения
+
+Добавьте значение в `.env`:
+
+```bash
+YOOKASSA_PROXY_URL=http://127.0.0.1:8080
+```
+
+#### Использование в синхронной конфигурации
+
+```typescript
+import { YookassaModule } from 'nestjs-yookassa'
+
+YookassaModule.forRoot({
+	shopId: process.env.YOOKASSA_SHOP_ID,
+	apiKey: process.env.YOOKASSA_SECRET_KEY,
+	proxyUrl: process.env.YOOKASSA_PROXY_URL // прокси активируется при наличии
+})
+```
+
+#### Использование в асинхронной конфигурации
+
+```typescript
+useFactory: config => ({
+	shopId: config.get('YOOKASSA_SHOP_ID'),
+	apiKey: config.get('YOOKASSA_SECRET_KEY'),
+	proxyUrl: config.get('YOOKASSA_PROXY_URL')
+})
+```
+
 </Steps>

apps/www/src/content/docs/invoices/create.mdx

@@ -53,7 +53,7 @@ export class InvoiceService {
       expires_at: '2025-08-30T10:00:00.000Z'
     }
 
-    const invoice = await this.yookassaService.createInvoice(invoiceData)
+    const invoice = await this.yookassaService.invoices.create(invoiceData)
 
     return invoice
   }

apps/www/src/content/docs/invoices/info.mdx

@@ -19,7 +19,7 @@ export class InvoiceService {
   async getInvoiceDetails() {
     const invoiceId = '123456'; // Уникальный идентификатор счёта
 
-    const invoice = await this.yookassaService.getInvoice(invoiceId);
+    const invoice = await this.yookassaService.invoices.getById(invoiceId);
 
     return invoice;
   }

apps/www/src/content/docs/payments/cancel.mdx

@@ -23,7 +23,7 @@ export class PaymentService {
 	async cancelPayment() {
 		const paymentId = '123456'
 
-		const canceledPayment = await this.yookassaService.cancelPayment(paymentId);
+		const canceledPayment = await this.yookassaService.payments.cancel(paymentId);
 
 		return canceledPayment
 	}

apps/www/src/content/docs/payments/confirm.mdx

@@ -23,7 +23,7 @@ export class PaymentService {
 	async capturePayment() {
 		const paymentId = '123456'
 
-		const capturedPayment = await this.yookassaService.capturePayment(paymentId);
+		const capturedPayment = await this.yookassaService.payments.capture(paymentId);
 
 		return capturedPayment
 	}

apps/www/src/content/docs/payments/create.mdx

@@ -65,7 +65,7 @@ export class PaymentService {
 			},
 		}
 
-		const newPayment = await this.yookassaService.createPayment(paymentData);
+		const newPayment = await this.yookassaService.payments.create(paymentData);
 
 		return newPayment;
   	}

apps/www/src/content/docs/payments/info.mdx

@@ -21,7 +21,7 @@ export class PaymentService {
 	async getPaymentDetails() {
 		const paymentId = '123456'; // Уникальный ID платежа
 
-		const payment = await this.yookassaService.getPaymentDetails(paymentId);
+		const payment = await this.yookassaService.payments.getById(paymentId);
 
 		return payment
 	}

apps/www/src/content/docs/payments/list.mdx

@@ -40,7 +40,7 @@ export class PaymentService {
 		const from = '2025-01-01'; // Начальная дата фильтра
 		const to = '2025-01-31'; // Конечная дата фильтра
 
-		const payments = await this.yookassaService.getPayments(limit, from, to);
+		const payments = await this.yookassaService.payments.getAll(limit, from, to);
 
 		return payments
  	}