docs: update packages readme (#503)

* docs: update packages readme

* translations: for package expresskit

---------

Co-authored-by: Update packages readme action <>
Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>

Author: github-actions[bot]

src/content/local-docs/libs/expresskit/README-de.md

@@ -77,7 +77,7 @@ export default config;
 
 | Option              | Typ                 | Standard                              | Beschreibung                                                                                     |
 | ------------------- | ------------------- | ------------------------------------- | ------------------------------------------------------------------------------------------------ |
-| `appCsrfSecret`     | `string \| string[]` | -                                     | **Erforderlich.** Geheimer Schlüssel (oder Schlüssel) für die HMAC-Token-Generierung. Mehrere Schlüssel ermöglichen die Schlüsselrotation. |
+| `appCsrfSecret`     | `string \| string[]` | -                                     | **Erforderlich.** Geheimer Schlüssel/Schlüssel für die HMAC-Token-Generierung. Mehrere Schlüssel ermöglichen die Schlüsselrotation. |
 | `appCsrfLifetime`   | `number`            | `2592000` (30 Tage)                   | Token-Lebensdauer in Sekunden. Setzen Sie auf `0` für kein Ablaufdatum.                                        |
 | `appCsrfHeaderName` | `string`            | `'x-csrf-token'`                      | Name des HTTP-Headers für die Token-Validierung.                                                          |
 | `appCsrfMethods`    | `string[]`          | `['POST', 'PUT', 'DELETE', 'PATCH']` | HTTP-Methoden, die eine CSRF-Validierung erfordern.                                                      |
@@ -128,4 +128,33 @@ const app = new ExpressKit(nodekit, {
     },
   },
 });
-```
+```
+
+## Caching-Steuerung
+
+Standardmäßig setzt ExpressKit `no-cache`-Header auf alle Antworten. Sie können dieses Verhalten global oder pro Route steuern.
+
+### Globale Konfiguration
+
+```typescript
+const config: Partial<AppConfig> = {
+  expressEnableCaching: true, // Caching standardmäßig erlauben
+};
+```
+
+### Routenspezifische Konfiguration
+
+```typescript
+const app = new ExpressKit(nodekit, {
+  'GET /api/cached': {
+    enableCaching: true, // Caching für diese Route erlauben
+    handler: (req, res) => res.json({data: 'cacheable'}),
+  },
+  'GET /api/fresh': {
+    enableCaching: false, // no-cache erzwingen
+    handler: (req, res) => res.json({data: 'always fresh'}),
+  },
+});
+```
+
+`enableCaching` auf Routenebene überschreibt die globale Einstellung. Der Caching-Status ist in `req.routeInfo.enableCaching` verfügbar.

src/content/local-docs/libs/expresskit/README-es.md

@@ -58,7 +58,7 @@ export default config;
 
 ExpressKit proporciona protección integrada contra Cross-Site Request Forgery (CSRF) para asegurar tus aplicaciones contra solicitudes maliciosas de origen cruzado. El middleware CSRF genera y valida automáticamente tokens para solicitudes HTTP que cambian el estado.
 
-### Configuración Básica
+### Configuración básica
 
 Para habilitar la protección CSRF, configura la clave secreta en tu configuración:
 
@@ -73,12 +73,12 @@ const config: Partial<AppConfig> = {
 export default config;
 ```
 
-### Opciones de Configuración
+### Opciones de configuración
 
 | Opción              | Tipo                 | Predeterminado                       | Descripción                                                                                     |
 | ------------------- | -------------------- | ------------------------------------ | ----------------------------------------------------------------------------------------------- |
 | `appCsrfSecret`     | `string \| string[]` | -                                    | **Requerido.** Clave(s) secreta(s) para la generación de tokens HMAC. Múltiples secretos permiten la rotación de claves. |
-| `appCsrfLifetime`   | `number`             | `2592000` (30 días)                  | Vida útil del token en segundos. Establecer a `0` para que no expire.                                        |
+| `appCsrfLifetime`   | `number`             | `2592000` (30 días)                  | Duración del token en segundos. Establecer a `0` para que no expire.                                        |
 | `appCsrfHeaderName` | `string`             | `'x-csrf-token'`                     | Nombre de la cabecera HTTP para la validación del token.                                                          |
 | `appCsrfMethods`    | `string[]`           | `['POST', 'PUT', 'DELETE', 'PATCH']` | Métodos HTTP que requieren validación CSRF.                                                      |
 
@@ -95,7 +95,7 @@ const nodekit = new NodeKit({
     appCsrfSecret: 'tu-clave-secreta',
     appAuthPolicy: AuthPolicy.required,
 
-    // Asegúrate de que tu middleware establezca el ID de usuario en el originalContext, de lo contrario, la generación del token CSRF fallará
+    // Asegúrate de que tu middleware establezca el ID de usuario en originalContext, de lo contrario, la generación del token CSRF fallará
     appAuthHandler: tuManejadorDeAutenticacion,
   },
 });
@@ -113,7 +113,7 @@ const app = new ExpressKit(nodekit, {
 });
 ```
 
-### Configuración por Ruta
+### Configuración por ruta
 
 Puedes deshabilitar la protección CSRF para rutas específicas:
 
@@ -127,4 +127,33 @@ const app = new ExpressKit(nodekit, {
     },
   },
 });
-```
+```
+
+## Control de caché
+
+Por defecto, ExpressKit establece cabeceras `no-cache` en todas las respuestas. Puedes controlar este comportamiento globalmente o por ruta.
+
+### Configuración global
+
+```typescript
+const config: Partial<AppConfig> = {
+  expressEnableCaching: true, // Permite la caché por defecto
+};
+```
+
+### Configuración por ruta
+
+```typescript
+const app = new ExpressKit(nodekit, {
+  'GET /api/cached': {
+    enableCaching: true, // Permite la caché para esta ruta
+    handler: (req, res) => res.json({data: 'cacheable'}),
+  },
+  'GET /api/fresh': {
+    enableCaching: false, // Fuerza no-cache
+    handler: (req, res) => res.json({data: 'siempre fresco'}),
+  },
+});
+```
+
+El `enableCaching` a nivel de ruta anula la configuración global. El estado de la caché está disponible en `req.routeInfo.enableCaching`.

src/content/local-docs/libs/expresskit/README-fr.md

@@ -78,7 +78,7 @@ export default config;
 | Option              | Type                 | Défaut                              | Description                                                                                     |
 | ------------------- | -------------------- | ------------------------------------ | ----------------------------------------------------------------------------------------------- |
 | `appCsrfSecret`     | `string \| string[]` | -                                    | **Requis.** Clé(s) secrète(s) pour la génération de jetons HMAC. Plusieurs secrets permettent la rotation des clés. |
-| `appCsrfLifetime`   | `number`             | `2592000` (30 jours)                  | Durée de vie du jeton en secondes. Définir à `0` pour aucune expiration.                                        |
+| `appCsrfLifetime`   | `number`             | `2592000` (30 jours)                  | Durée de vie du jeton en secondes. Définissez à `0` pour aucune expiration.                                        |
 | `appCsrfHeaderName` | `string`             | `'x-csrf-token'`                     | Nom de l'en-tête HTTP pour la validation du jeton.                                                          |
 | `appCsrfMethods`    | `string[]`           | `['POST', 'PUT', 'DELETE', 'PATCH']` | Méthodes HTTP nécessitant une validation CSRF.                                                      |
 
@@ -127,4 +127,33 @@ const app = new ExpressKit(nodekit, {
     },
   },
 });
-```
+```
+
+## Contrôle de la mise en cache
+
+Par défaut, ExpressKit définit des en-têtes `no-cache` sur toutes les réponses. Vous pouvez contrôler ce comportement globalement ou par route.
+
+### Configuration globale
+
+```typescript
+const config: Partial<AppConfig> = {
+  expressEnableCaching: true, // Autorise la mise en cache par défaut
+};
+```
+
+### Configuration par route
+
+```typescript
+const app = new ExpressKit(nodekit, {
+  'GET /api/cached': {
+    enableCaching: true, // Autorise la mise en cache pour cette route
+    handler: (req, res) => res.json({data: 'cacheable'}),
+  },
+  'GET /api/fresh': {
+    enableCaching: false, // Force le no-cache
+    handler: (req, res) => res.json({data: 'toujours frais'}),
+  },
+});
+```
+
+Le paramètre `enableCaching` au niveau de la route remplace le réglage global. L'état de la mise en cache est disponible dans `req.routeInfo.enableCaching`.

src/content/local-docs/libs/expresskit/README-ko.md

@@ -1,6 +1,6 @@
 # ExpressKit
 
-ExpressKit는 [express.js](https://expressjs.com/)를 위한 경량 래퍼로, [NodeKit](https://github.com/gravity-ui/nodekit)과 통합되며 요청 로깅, 추적 지원, 비동기 컨트롤러 및 미들웨어, 상세한 라우트 설명과 같은 유용한 기능을 제공합니다.
+ExpressKit는 [NodeKit](https://github.com/gravity-ui/nodekit)과 통합되는 경량 [express.js](https://expressjs.com/) 래퍼로, 요청 로깅, 추적 지원, 비동기 컨트롤러 및 미들웨어, 상세한 라우트 설명과 같은 유용한 기능을 제공합니다.
 
 설치:
 
@@ -60,7 +60,7 @@ ExpressKit는 애플리케이션을 악의적인 교차 출처 요청으로부
 
 ### 기본 설정
 
-CSRF 보호를 활성화하려면 설정에서 비밀 키를 구성하세요:
+CSRF 보호를 활성화하려면 설정에서 비밀 키를 구성하십시오.
 
 ```typescript
 import type {AppConfig} from '@gravity-ui/nodekit';
@@ -77,14 +77,14 @@ export default config;
 
 | 옵션              | 타입                 | 기본값                              | 설명                                                                                     |
 | ------------------- | -------------------- | ------------------------------------ | ----------------------------------------------------------------------------------------------- |
-| `appCsrfSecret`     | `string \| string[]` | -                                    | **필수.** HMAC 토큰 생성을 위한 비밀 키입니다. 여러 개의 비밀 키를 사용하여 키 로테이션이 가능합니다. |
-| `appCsrfLifetime`   | `number`             | `2592000` (30일)                  | 토큰의 유효 시간(초)입니다. 만료 없음으로 설정하려면 `0`으로 설정하세요.                                        |
+| `appCsrfSecret`     | `string \| string[]` | -                                    | **필수.** HMAC 토큰 생성을 위한 비밀 키. 여러 개의 비밀 키를 사용하여 키 로테이션이 가능합니다. |
+| `appCsrfLifetime`   | `number`             | `2592000` (30일)                  | 토큰 수명(초). 만료 없음으로 설정하려면 `0`으로 설정합니다.                                        |
 | `appCsrfHeaderName` | `string`             | `'x-csrf-token'`                     | 토큰 검증을 위한 HTTP 헤더 이름입니다.                                                          |
 | `appCsrfMethods`    | `string[]`           | `['POST', 'PUT', 'DELETE', 'PATCH']` | CSRF 검증이 필요한 HTTP 메서드입니다.                                                      |
 
 ### 사용법
 
-설정 후, 지정된 HTTP 메서드를 사용하는 모든 라우트에 CSRF 보호가 자동으로 적용됩니다:
+설정 후에는 지정된 HTTP 메서드를 사용하는 모든 라우트에 CSRF 보호가 자동으로 적용됩니다.
 
 ```typescript
 import {ExpressKit, AuthPolicy} from '@gravity-ui/expresskit';
@@ -95,7 +95,7 @@ const nodekit = new NodeKit({
     appCsrfSecret: 'your-secret-key',
     appAuthPolicy: AuthPolicy.required,
 
-    // 미들웨어가 originalContext에 사용자 ID를 설정하도록 하세요. 그렇지 않으면 CSRF 토큰 생성에 실패합니다.
+    // 미들웨어가 originalContext에 사용자 ID를 설정하는지 확인하십시오. 그렇지 않으면 CSRF 토큰 생성에 실패합니다.
     appAuthHandler: yourAuthHandler,
   },
 });
@@ -115,7 +115,7 @@ const app = new ExpressKit(nodekit, {
 
 ### 라우트별 설정
 
-특정 라우트에 대해 CSRF 보호를 비활성화할 수 있습니다:
+특정 라우트에 대해 CSRF 보호를 비활성화할 수 있습니다.
 
 ```typescript
 const app = new ExpressKit(nodekit, {
@@ -127,4 +127,33 @@ const app = new ExpressKit(nodekit, {
     },
   },
 });
-```
+```
+
+## 캐싱 제어
+
+기본적으로 ExpressKit는 모든 응답에 `no-cache` 헤더를 설정합니다. 이 동작은 전역적으로 또는 라우트별로 제어할 수 있습니다.
+
+### 전역 설정
+
+```typescript
+const config: Partial<AppConfig> = {
+  expressEnableCaching: true, // 기본적으로 캐싱 허용
+};
+```
+
+### 라우트별 설정
+
+```typescript
+const app = new ExpressKit(nodekit, {
+  'GET /api/cached': {
+    enableCaching: true, // 이 라우트에 대해 캐싱 허용
+    handler: (req, res) => res.json({data: 'cacheable'}),
+  },
+  'GET /api/fresh': {
+    enableCaching: false, // no-cache 강제 적용
+    handler: (req, res) => res.json({data: 'always fresh'}),
+  },
+});
+```
+
+라우트 레벨의 `enableCaching`은 전역 설정을 재정의합니다. 캐싱 상태는 `req.routeInfo.enableCaching`에서 사용할 수 있습니다.

src/content/local-docs/libs/expresskit/README-zh.md

@@ -60,7 +60,7 @@ ExpressKit 提供内置的跨站请求伪造 (CSRF) 防护功能，以保护您
 
 ### 基本配置
 
-要启用 CSRF 防护，请在您的配置中设置 secret key：
+要启用 CSRF 防护，请在您的配置中设置密钥：
 
 ```typescript
 import type {AppConfig} from '@gravity-ui/nodekit';
@@ -77,8 +77,8 @@ export default config;
 
 | 选项              | 类型                 | 默认值                              | 描述                                                                                     |
 | ------------------- | -------------------- | ------------------------------------ | ----------------------------------------------------------------------------------------------- |
-| `appCsrfSecret`     | `string \| string[]` | -                                    | **必需。** 用于 HMAC 令牌生成的 secret key。多个 secret 允许进行密钥轮换。 |
-| `appCsrfLifetime`   | `number`             | `2592000` (30 天)                  | 令牌的有效期（秒）。设置为 `0` 表示无过期时间。                                        |
+| `appCsrfSecret`     | `string \| string[]` | -                                    | **必需。** 用于 HMAC 令牌生成的密钥。多个密钥允许进行密钥轮换。 |
+| `appCsrfLifetime`   | `number`             | `2592000` (30 天)                  | 令牌有效期（秒）。设置为 `0` 表示无过期时间。                                        |
 | `appCsrfHeaderName` | `string`             | `'x-csrf-token'`                     | 用于令牌验证的 HTTP 标头名称。                                                          |
 | `appCsrfMethods`    | `string[]`           | `['POST', 'PUT', 'DELETE', 'PATCH']` | 需要 CSRF 验证的 HTTP 方法。                                                      |
 
@@ -127,4 +127,33 @@ const app = new ExpressKit(nodekit, {
     },
   },
 });
-```
+```
+
+## 缓存控制
+
+默认情况下，ExpressKit 会为所有响应设置 `no-cache` 标头。您可以全局或按路由控制此行为。
+
+### 全局配置
+
+```typescript
+const config: Partial<AppConfig> = {
+  expressEnableCaching: true, // 默认允许缓存
+};
+```
+
+### 按路由配置
+
+```typescript
+const app = new ExpressKit(nodekit, {
+  'GET /api/cached': {
+    enableCaching: true, // 为此路由允许缓存
+    handler: (req, res) => res.json({data: 'cacheable'}),
+  },
+  'GET /api/fresh': {
+    enableCaching: false, // 强制不缓存
+    handler: (req, res) => res.json({data: 'always fresh'}),
+  },
+});
+```
+
+路由级别的 `enableCaching` 会覆盖全局设置。缓存状态可在 `req.routeInfo.enableCaching` 中获取。

src/content/local-docs/libs/expresskit/README.md

@@ -128,3 +128,32 @@ const app = new ExpressKit(nodekit, {
   },
 });
 ```
+
+## Caching Control
+
+By default, ExpressKit sets `no-cache` headers on all responses. You can control this behavior globally or per-route.
+
+### Global configuration
+
+```typescript
+const config: Partial<AppConfig> = {
+  expressEnableCaching: true, // Allow caching by default
+};
+```
+
+### Per-route configuration
+
+```typescript
+const app = new ExpressKit(nodekit, {
+  'GET /api/cached': {
+    enableCaching: true, // Allow caching for this route
+    handler: (req, res) => res.json({data: 'cacheable'}),
+  },
+  'GET /api/fresh': {
+    enableCaching: false, // Force no-cache
+    handler: (req, res) => res.json({data: 'always fresh'}),
+  },
+});
+```
+
+Route-level `enableCaching` overrides the global setting. The caching state is available in `req.routeInfo.enableCaching`.