@itphx/synth-backend 0.10.0 → 0.10.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (43) hide show
  1. package/dist/app/bootstrap.d.ts +11 -0
  2. package/dist/app/bootstrap.js +19 -0
  3. package/dist/app/deps.d.ts +106 -0
  4. package/dist/app/deps.js +617 -0
  5. package/dist/app/listen.d.ts +29 -0
  6. package/dist/app/listen.js +298 -0
  7. package/dist/app/mount-routes.d.ts +18 -0
  8. package/dist/app/mount-routes.js +466 -0
  9. package/dist/app/sse-events.d.ts +15 -0
  10. package/dist/app/sse-events.js +83 -0
  11. package/dist/app.d.ts +15 -11
  12. package/dist/app.js +71 -1337
  13. package/dist/auth/guards.js +1 -1
  14. package/dist/auth/middleware.d.ts +7 -2
  15. package/dist/auth/middleware.js +18 -4
  16. package/dist/auth/oidc.d.ts +15 -0
  17. package/dist/auth/oidc.js +41 -3
  18. package/dist/auth/service-scope.d.ts +1 -1
  19. package/dist/auth/service-scope.js +1 -1
  20. package/dist/events/hub.d.ts +2 -2
  21. package/dist/lib/cors.d.ts +23 -0
  22. package/dist/lib/cors.js +24 -0
  23. package/dist/lib/i18n.js +10 -6
  24. package/dist/main.js +4 -4
  25. package/dist/middleware/rate-limiter.d.ts +4 -1
  26. package/dist/middleware/rate-limiter.js +4 -2
  27. package/dist/routes/audit.d.ts +1 -1
  28. package/dist/routes/audit.js +2 -2
  29. package/dist/routes/auth.js +28 -4
  30. package/dist/routes/gateway-patterns.d.ts +1 -1
  31. package/dist/routes/gateway-patterns.js +1 -1
  32. package/dist/routes/llm.js +5 -4
  33. package/dist/routes/mcp-registry.d.ts +3 -3
  34. package/dist/routes/mcp-registry.js +8 -8
  35. package/dist/routes/mcp.d.ts +1 -1
  36. package/dist/routes/mcp.js +1 -1
  37. package/dist/routes/projects.d.ts +4 -4
  38. package/dist/routes/projects.js +7 -7
  39. package/dist/routes/providers.js +1 -0
  40. package/dist/routes/sessions.d.ts +1 -1
  41. package/dist/routes/sessions.js +89 -13
  42. package/dist/routes/users.js +1 -1
  43. package/package.json +3 -3
@@ -3,7 +3,7 @@ import { getServiceCredential } from '@itphx/synth-core';
3
3
  import { hasServiceScope } from '@itphx/synth-shared';
4
4
  import { t } from '../lib/i18n.js';
5
5
  /**
6
- * AD-052/O1: комбинированные guard'ы «ADMIN **или** scope» для эндпоинтов,
6
+ * ADR-052/O1: комбинированные guard'ы «ADMIN **или** scope» для эндпоинтов,
7
7
  * которые должны быть доступны и человеку-ADMIN, и installer-service-key'ю.
8
8
  *
9
9
  * `requireScope` (core) — no-op для интерактивных кред, поэтому одиночного
@@ -2,7 +2,12 @@ import type { AuthConfig, User } from '@itphx/synth-shared';
2
2
  import type { ServiceKeyCredential } from '@itphx/synth-core';
3
3
  import { setCookie, deleteCookie } from 'hono/cookie';
4
4
  /**
5
- * AD-052 (этап I): резолвер service-key (`synth_svc_…`) → синтетический
5
+ * Флаг `Secure` cookie сессии: по умолчанию `true`; локальная http-разработка
6
+ * отключает его явным `SYNTH_COOKIE_INSECURE=true` (небезопасно вне localhost).
7
+ */
8
+ export declare function isSessionCookieSecure(env?: NodeJS.ProcessEnv): boolean;
9
+ /**
10
+ * ADR-052 (этап I): резолвер service-key (`synth_svc_…`) → синтетический
6
11
  * пользователь (RBAC) + контекст (`scopes`/`allowedProjects`/лимит).
7
12
  * `null` — секрет неизвестен/отозван/истёк либо резолвер не настроен.
8
13
  */
@@ -10,7 +15,7 @@ export type ServiceKeyResolver = (rawSecret: string) => Promise<{
10
15
  user: User;
11
16
  credential: ServiceKeyCredential;
12
17
  } | null>;
13
- /** Конфиг backend-auth: `AuthConfig` + service-key (AD-052). */
18
+ /** Конфиг backend-auth: `AuthConfig` + service-key (ADR-052). */
14
19
  export interface AuthMiddlewareConfig extends AuthConfig {
15
20
  resolveServiceKey?: ServiceKeyResolver;
16
21
  }
@@ -4,6 +4,13 @@ import { getCookie, setCookie, deleteCookie } from 'hono/cookie';
4
4
  import { t } from '../lib/i18n.js';
5
5
  import { createLazyOidcClient } from './oidc.js';
6
6
  const SESSION_COOKIE = 'user_session';
7
+ /**
8
+ * Флаг `Secure` cookie сессии: по умолчанию `true`; локальная http-разработка
9
+ * отключает его явным `SYNTH_COOKIE_INSECURE=true` (небезопасно вне localhost).
10
+ */
11
+ export function isSessionCookieSecure(env = process.env) {
12
+ return env.SYNTH_COOKIE_INSECURE !== 'true';
13
+ }
7
14
  // In-memory хранилище сессий (для debug mode)
8
15
  const sessions = new Map();
9
16
  // Очистка истёкших сессий каждые 5 минут
@@ -25,8 +32,15 @@ function extractBearerToken(h) {
25
32
  export function createAuthMiddleware(config) {
26
33
  // Ленивый OIDC-клиент (мемоизация, безопасно при отсутствии oidc — null)
27
34
  const getOidcClient = createLazyOidcClient(config.oidc);
35
+ // Cookie сессии — `Secure` по умолчанию; отключается только явным opt-out
36
+ // для локальной http-разработки (`SYNTH_COOKIE_INSECURE=true`).
37
+ const cookieSecure = isSessionCookieSecure();
38
+ if (!cookieSecure) {
39
+ console.warn('[auth] SYNTH_COOKIE_INSECURE=true — cookie сессии устанавливается без флага Secure '
40
+ + '(допустимо только для локальной http-разработки)');
41
+ }
28
42
  /**
29
- * AD-052: машинная аутентификация по service-key. Распознаётся по префиксу
43
+ * ADR-052: машинная аутентификация по service-key. Распознаётся по префиксу
30
44
  * секрета `synth_svc_`; резолвер асинхронный (стор + touch `lastUsedAt`),
31
45
  * поэтому ветка живёт в middleware, а не в синхронном `getCurrentUser`.
32
46
  */
@@ -40,7 +54,7 @@ export function createAuthMiddleware(config) {
40
54
  };
41
55
  // Определить пользователя из запроса
42
56
  const getCurrentUser = async (c) => {
43
- // 0. AD-052: service-key — синтетический пользователь ключа.
57
+ // 0. ADR-052: service-key — синтетический пользователь ключа.
44
58
  const serviceAuth = await resolveServiceKey(c);
45
59
  if (serviceAuth)
46
60
  return serviceAuth.user;
@@ -120,7 +134,7 @@ export function createAuthMiddleware(config) {
120
134
  };
121
135
  // Middleware: прикрепить пользователя к контексту (без ошибки)
122
136
  const attachUser = createMiddleware(async (c, next) => {
123
- // AD-052: service-key несёт и пользователя, и контекст (scopes/проекция).
137
+ // ADR-052: service-key несёт и пользователя, и контекст (scopes/проекция).
124
138
  const serviceAuth = await resolveServiceKey(c);
125
139
  if (serviceAuth) {
126
140
  c.set('user', serviceAuth.user);
@@ -204,7 +218,7 @@ export function createAuthMiddleware(config) {
204
218
  setCookie(c, SESSION_COOKIE, sessionId, {
205
219
  path: '/',
206
220
  httpOnly: true,
207
- secure: process.env.NODE_ENV === 'production',
221
+ secure: cookieSecure,
208
222
  sameSite: 'Lax',
209
223
  maxAge: config.sessionMaxAgeMinutes * 60,
210
224
  });
@@ -8,6 +8,14 @@ export interface OidcConfig {
8
8
  clientId: string;
9
9
  clientSecret: string;
10
10
  redirectUri: string;
11
+ /**
12
+ * Дополнительные допустимые `aud` (в дополнение к дефолтам: для id_token —
13
+ * `clientId`, для access_token — `clientId`/`account`). В Keycloak
14
+ * `id_token.aud` = clientId, а `access_token.aud` обычно `account` (строкой
15
+ * или массивом); доп. значения — только для нестандартных конфигураций.
16
+ * Issuer проверяется всегда.
17
+ */
18
+ audience?: string[];
11
19
  }
12
20
  /** Подмножество документа discovery OpenID Connect. */
13
21
  export interface OidcDiscovery {
@@ -47,6 +55,7 @@ export declare class OidcClient {
47
55
  exchangePassword(username: string, password: string): Promise<OidcTokenResult>;
48
56
  /**
49
57
  * Проверка JWT (id_token или access_token) через JWKS провайдера.
58
+ * Проверяются подпись, `iss` (issuer) и `aud`.
50
59
  * Возвращает User-подобный объект: id, username, email, roles.
51
60
  */
52
61
  verifyToken(token: string): Promise<OidcUser>;
@@ -55,6 +64,12 @@ export declare class OidcClient {
55
64
  * Роли: из id_token, если пусто — из access_token (client roles учитываются).
56
65
  */
57
66
  verifyTokens(idToken: string, accessToken: string): Promise<OidcUser>;
67
+ /** Допустимые `aud` id_token: clientId (+ дополнительные из конфига). */
68
+ private _idTokenAudience;
69
+ /** Допустимые `aud` access_token: clientId ИЛИ `account` (+ дополнительные). */
70
+ private _accessTokenAudience;
71
+ /** Допустимые `aud` для bearer-токена неизвестного типа — объединение. */
72
+ private _anyTokenAudience;
58
73
  }
59
74
  /** User-подобный объект, извлечённый из OIDC-токена. */
60
75
  export interface OidcUser {
package/dist/auth/oidc.js CHANGED
@@ -1,4 +1,6 @@
1
1
  import { jwtVerify, createRemoteJWKSet } from 'jose';
2
+ /** Audience access_token по умолчанию (Keycloak): клиент либо `account`. */
3
+ const DEFAULT_ACCESS_TOKEN_AUDIENCE = 'account';
2
4
  /** Известные роли Synth (в realm роли записаны в нижнем регистре). */
3
5
  const KNOWN_ROLES = ['ADMIN', 'USER', 'LEAD', 'AUDITOR'];
4
6
  /**
@@ -100,12 +102,19 @@ export class OidcClient {
100
102
  }
101
103
  /**
102
104
  * Проверка JWT (id_token или access_token) через JWKS провайдера.
105
+ * Проверяются подпись, `iss` (issuer) и `aud`.
103
106
  * Возвращает User-подобный объект: id, username, email, roles.
104
107
  */
105
108
  async verifyToken(token) {
106
109
  const discovery = await this.getDiscovery();
107
110
  const jwks = createRemoteJWKSet(new URL(discovery.jwks_uri));
108
- const { payload } = await jwtVerify(token, jwks);
111
+ // Тип bearer-токена заранее неизвестен (id_token или access_token), поэтому
112
+ // принимаем audience обоих классов: clientId (id_token) и clientId/`account`
113
+ // (access_token Keycloak). Issuer проверяется всегда.
114
+ const { payload } = await jwtVerify(token, jwks, {
115
+ issuer: this.config.issuer,
116
+ audience: this._anyTokenAudience(),
117
+ });
109
118
  return extractUser(payload, this.config.clientId);
110
119
  }
111
120
  /**
@@ -115,10 +124,39 @@ export class OidcClient {
115
124
  async verifyTokens(idToken, accessToken) {
116
125
  const discovery = await this.getDiscovery();
117
126
  const jwks = createRemoteJWKSet(new URL(discovery.jwks_uri));
118
- const { payload: idPayload } = await jwtVerify(idToken, jwks);
119
- const { payload: accessPayload } = await jwtVerify(accessToken, jwks);
127
+ const { payload: idPayload } = await jwtVerify(idToken, jwks, {
128
+ issuer: this.config.issuer,
129
+ // id_token.aud = clientId (+ доп. из конфига).
130
+ audience: this._idTokenAudience(),
131
+ });
132
+ const { payload: accessPayload } = await jwtVerify(accessToken, jwks, {
133
+ issuer: this.config.issuer,
134
+ // Keycloak кладёт в access_token.aud `account`, а клиента — в `azp`;
135
+ // принимаем clientId ИЛИ `account` (+ доп. из конфига), чтобы не ломать
136
+ // валидные токены. `azp` намеренно не форсим (иначе токены realm-клиентов,
137
+ // напр. `synth-cli`, отвергались бы) — issuer и подпись проверяются всегда.
138
+ audience: this._accessTokenAudience(),
139
+ });
120
140
  return extractUserFromTokens(idPayload, accessPayload, this.config.clientId);
121
141
  }
142
+ /** Допустимые `aud` id_token: clientId (+ дополнительные из конфига). */
143
+ _idTokenAudience() {
144
+ return [...new Set([this.config.clientId, ...(this.config.audience ?? [])])].filter(Boolean);
145
+ }
146
+ /** Допустимые `aud` access_token: clientId ИЛИ `account` (+ дополнительные). */
147
+ _accessTokenAudience() {
148
+ return [
149
+ ...new Set([
150
+ this.config.clientId,
151
+ DEFAULT_ACCESS_TOKEN_AUDIENCE,
152
+ ...(this.config.audience ?? []),
153
+ ]),
154
+ ].filter(Boolean);
155
+ }
156
+ /** Допустимые `aud` для bearer-токена неизвестного типа — объединение. */
157
+ _anyTokenAudience() {
158
+ return [...new Set([...this._idTokenAudience(), ...this._accessTokenAudience()])];
159
+ }
122
160
  }
123
161
  /**
124
162
  * Извлечь известные роли из payload токена Keycloak:
@@ -1,6 +1,6 @@
1
1
  import type { ProjectGuard, ScopeGuardFactory } from '@itphx/synth-core';
2
2
  /**
3
- * AD-052 (этап I): backend-обёртки scope-гейтов service-key.
3
+ * ADR-052 (этап I): backend-обёртки scope-гейтов service-key.
4
4
  *
5
5
  * Enforcement (`hasServiceScope`/`isProjectAllowed`) остаётся в core —
6
6
  * здесь только локализация отказов (`SCOPE_REQUIRED`/`PROJECT_FORBIDDEN`)
@@ -2,7 +2,7 @@ import { createMiddleware } from 'hono/factory';
2
2
  import { requireScope, checkProjectAccess } from '@itphx/synth-core';
3
3
  import { t } from '../lib/i18n.js';
4
4
  /**
5
- * AD-052 (этап I): backend-обёртки scope-гейтов service-key.
5
+ * ADR-052 (этап I): backend-обёртки scope-гейтов service-key.
6
6
  *
7
7
  * Enforcement (`hasServiceScope`/`isProjectAllowed`) остаётся в core —
8
8
  * здесь только локализация отказов (`SCOPE_REQUIRED`/`PROJECT_FORBIDDEN`)
@@ -7,8 +7,8 @@ export interface EventClient {
7
7
  /**
8
8
  * Watch-all: клиент получает события ВСЕХ сессий через глобальный поток
9
9
  * `eventBus.subscribeAll`, а не только сессии владельца `userId`.
10
- * Используется машинными watcher'ами (service-key, AD-052 этап IV) и ролями
11
- * сквозного обзора ADMIN/LEAD (AD-089) — паритет со standalone-core SSE.
10
+ * Используется машинными watcher'ами (service-key, ADR-052 этап IV) и ролями
11
+ * сквозного обзора ADMIN/LEAD (ADR-089) — паритет со standalone-core SSE.
12
12
  */
13
13
  allSessions?: boolean;
14
14
  send(event: BusEvent): void;
@@ -0,0 +1,23 @@
1
+ /**
2
+ * CORS origin-политика backend (fail-closed).
3
+ *
4
+ * Приоритет:
5
+ * 1. явный `SYNTH_CORS_ORIGIN` (env) — используется всегда (как раньше);
6
+ * 2. явный dev-режим `SYNTH_CORS_ALLOW_ALL=true` — отражаем запрошенный origin;
7
+ * 3. точное совпадение с белым списком `server.allowedOrigins` — эхо;
8
+ * 4. иначе — `undefined`: заголовки CORS не выставляются.
9
+ *
10
+ * Пустой белый список больше НЕ означает «разрешить всё»: без явного флага
11
+ * произвольный origin не отражается (иначе `credentials: true` + эхо = CSRF-риск).
12
+ * Для локальной разработки открытый CORS включается явно (env-флаг).
13
+ */
14
+ export interface CorsOriginOptions {
15
+ /** Белый список `server.allowedOrigins` из конфига. */
16
+ allowedOrigins: string[];
17
+ /** Явный origin из env `SYNTH_CORS_ORIGIN` (приоритетнее белого списка). */
18
+ envOrigin?: string;
19
+ /** Явный dev-режим `SYNTH_CORS_ALLOW_ALL=true` — отражать любой origin. */
20
+ allowAll?: boolean;
21
+ }
22
+ /** Разрешить ли `origin` для CORS; `undefined` — заголовки не выставляются. */
23
+ export declare function resolveCorsOrigin(origin: string | undefined, { allowedOrigins, envOrigin, allowAll }: CorsOriginOptions): string | undefined;
@@ -0,0 +1,24 @@
1
+ /**
2
+ * CORS origin-политика backend (fail-closed).
3
+ *
4
+ * Приоритет:
5
+ * 1. явный `SYNTH_CORS_ORIGIN` (env) — используется всегда (как раньше);
6
+ * 2. явный dev-режим `SYNTH_CORS_ALLOW_ALL=true` — отражаем запрошенный origin;
7
+ * 3. точное совпадение с белым списком `server.allowedOrigins` — эхо;
8
+ * 4. иначе — `undefined`: заголовки CORS не выставляются.
9
+ *
10
+ * Пустой белый список больше НЕ означает «разрешить всё»: без явного флага
11
+ * произвольный origin не отражается (иначе `credentials: true` + эхо = CSRF-риск).
12
+ * Для локальной разработки открытый CORS включается явно (env-флаг).
13
+ */
14
+ /** Разрешить ли `origin` для CORS; `undefined` — заголовки не выставляются. */
15
+ export function resolveCorsOrigin(origin, { allowedOrigins, envOrigin, allowAll = false }) {
16
+ if (envOrigin)
17
+ return envOrigin;
18
+ if (allowAll)
19
+ return origin || undefined;
20
+ // Same-origin/нативные клиенты (нет Origin) в CORS-заголовках не нуждаются.
21
+ if (!origin)
22
+ return undefined;
23
+ return allowedOrigins.includes(origin) ? origin : undefined;
24
+ }
package/dist/lib/i18n.js CHANGED
@@ -26,7 +26,8 @@ const en = {
26
26
  'errors.validation.groupsRequired': 'groups is required',
27
27
  'errors.validation.expectedFilesArray': 'expected { files: string[] }',
28
28
  'errors.validation.claimCodeRequired': 'Confirmation code is required',
29
- // AD-089: приём внешних событий
29
+ 'errors.validation.invalidUsername': 'Invalid username',
30
+ // ADR-089: приём внешних событий
30
31
  'errors.validation.invalidEvent': 'Invalid event payload',
31
32
  'errors.validation.invalidBinding': 'Invalid binding payload',
32
33
  'errors.notFound.binding': 'Binding not found',
@@ -36,14 +37,14 @@ const en = {
36
37
  'errors.validation.invalidEventKey': 'Invalid event API key',
37
38
  'errors.validation.invalidEventKeyUpdate': 'Invalid event API key update',
38
39
  'errors.notFound.eventKey': 'Event API key not found',
39
- // AD-052 (этап I): service-key
40
+ // ADR-052 (этап I): service-key
40
41
  'errors.validation.invalidServiceKey': 'Invalid service key payload',
41
42
  'errors.notFound.serviceKey': 'Service key not found',
42
43
  'errors.conflict.serviceKeyLabel': 'Service key label is already used',
43
44
  'errors.forbidden.scopeRequired': 'Insufficient permissions: required scope is missing',
44
45
  'errors.forbidden.projectForbidden': 'Project is not available for this service key',
45
46
  'errors.rateLimited.serviceKey': 'Service key rate limit exceeded',
46
- // AD-052 (этап II): исходящие webhooks
47
+ // ADR-052 (этап II): исходящие webhooks
47
48
  'errors.validation.invalidWebhook': 'Invalid webhook subscription payload',
48
49
  'errors.notFound.webhook': 'Webhook subscription not found',
49
50
  'errors.conflict.webhookLabel': 'Webhook label is already used',
@@ -62,6 +63,7 @@ const en = {
62
63
  'errors.faviconFetchError': 'Error fetching favicon',
63
64
  'errors.generic': 'Error',
64
65
  'errors.rateLimited.eventKey': 'Event API key rate limit exceeded',
66
+ 'errors.rateLimited.identityClaim': 'Too many identity confirmation attempts, try again later',
65
67
  'errors.unavailable.eventsDisabled': 'External event ingestion is disabled',
66
68
  // Auth
67
69
  'auth.unauthorized': 'Authentication required',
@@ -108,7 +110,8 @@ const ru = {
108
110
  'errors.validation.groupsRequired': 'groups обязательны',
109
111
  'errors.validation.expectedFilesArray': 'expected { files: string[] }',
110
112
  'errors.validation.claimCodeRequired': 'Укажите код подтверждения',
111
- // AD-089: приём внешних событий
113
+ 'errors.validation.invalidUsername': 'Некорректное имя пользователя',
114
+ // ADR-089: приём внешних событий
112
115
  'errors.validation.invalidEvent': 'Некорректное тело события',
113
116
  'errors.validation.invalidBinding': 'Некорректное тело биндинга',
114
117
  'errors.notFound.binding': 'Биндинг не найден',
@@ -118,14 +121,14 @@ const ru = {
118
121
  'errors.validation.invalidEventKey': 'Неверный API-ключ события',
119
122
  'errors.validation.invalidEventKeyUpdate': 'Некорректное тело обновления API-ключа события',
120
123
  'errors.notFound.eventKey': 'API-ключ события не найден',
121
- // AD-052 (этап I): service-key
124
+ // ADR-052 (этап I): service-key
122
125
  'errors.validation.invalidServiceKey': 'Некорректное тело service-key',
123
126
  'errors.notFound.serviceKey': 'Service-key не найден',
124
127
  'errors.conflict.serviceKeyLabel': 'Метка service-key уже используется',
125
128
  'errors.forbidden.scopeRequired': 'Недостаточно прав: отсутствует требуемый scope',
126
129
  'errors.forbidden.projectForbidden': 'Проект недоступен для этого service-key',
127
130
  'errors.rateLimited.serviceKey': 'Превышен лимит запросов по service-key',
128
- // AD-052 (этап II): исходящие webhooks
131
+ // ADR-052 (этап II): исходящие webhooks
129
132
  'errors.validation.invalidWebhook': 'Некорректное тело webhook-подписки',
130
133
  'errors.notFound.webhook': 'Webhook-подписка не найдена',
131
134
  'errors.conflict.webhookLabel': 'Метка webhook уже используется',
@@ -144,6 +147,7 @@ const ru = {
144
147
  'errors.faviconFetchError': 'Ошибка получения favicon',
145
148
  'errors.generic': 'Ошибка',
146
149
  'errors.rateLimited.eventKey': 'Превышен лимит запросов по API-ключу события',
150
+ 'errors.rateLimited.identityClaim': 'Слишком много попыток подтверждения идентичности, повторите позже',
147
151
  'errors.unavailable.eventsDisabled': 'Приём внешних событий отключён',
148
152
  // Auth
149
153
  'auth.unauthorized': 'Требуется аутентификация',
package/dist/main.js CHANGED
@@ -26,13 +26,13 @@ async function gracefulShutdown(signal) {
26
26
  console.log('[Shutdown] WebSocket-сервер остановлен');
27
27
  queueManager.stopAll();
28
28
  console.log('[Shutdown] Очередь остановлена');
29
- // AD-089: остановить авто-архивацию ephemeral-сессий.
29
+ // ADR-089: остановить авто-архивацию ephemeral-сессий.
30
30
  stopEphemeralSweeper();
31
- // AD-089: остановить retention-очистку журнала событий.
31
+ // ADR-089: остановить retention-очистку журнала событий.
32
32
  stopEventJournalPruner();
33
- // AD-051 (срез): остановить планировщик расписаний.
33
+ // ADR-051 (срез): остановить планировщик расписаний.
34
34
  stopScheduler();
35
- // AD-052 (этап II): остановить движок исходящих webhooks и retention-очистку.
35
+ // ADR-052 (этап II): остановить движок исходящих webhooks и retention-очистку.
36
36
  stopWebhookService();
37
37
  stopWebhookDeliveryPruner();
38
38
  const drainTimeout = 10_000;
@@ -1,8 +1,11 @@
1
+ import type { Context } from 'hono';
1
2
  /**
2
3
  * In-memory rate limiter.
3
4
  * Ключ — Authorization header (уникален для каждого пользователя/ключа).
5
+ * `message` — опциональный резолвер локализованного текста (i18n); по умолчанию —
6
+ * общий русский текст (обратная совместимость).
4
7
  */
5
- export declare function createRateLimiter(maxRequests?: number, windowMs?: number): import("hono").MiddlewareHandler<any, string, {}, Response | (Response & import("hono").TypedResponse<{
8
+ export declare function createRateLimiter(maxRequests?: number, windowMs?: number, message?: (c: Context) => string): import("hono").MiddlewareHandler<any, string, {}, Response | (Response & import("hono").TypedResponse<{
6
9
  error: {
7
10
  code: string;
8
11
  message: string;
@@ -2,8 +2,10 @@ import { createMiddleware } from 'hono/factory';
2
2
  /**
3
3
  * In-memory rate limiter.
4
4
  * Ключ — Authorization header (уникален для каждого пользователя/ключа).
5
+ * `message` — опциональный резолвер локализованного текста (i18n); по умолчанию —
6
+ * общий русский текст (обратная совместимость).
5
7
  */
6
- export function createRateLimiter(maxRequests = 20, windowMs = 60_000) {
8
+ export function createRateLimiter(maxRequests = 20, windowMs = 60_000, message) {
7
9
  const hits = new Map();
8
10
  setInterval(() => {
9
11
  const now = Date.now();
@@ -24,7 +26,7 @@ export function createRateLimiter(maxRequests = 20, windowMs = 60_000) {
24
26
  }
25
27
  entry.count += 1;
26
28
  if (entry.count > maxRequests) {
27
- return c.json({ error: { code: 'RATE_LIMITED', message: 'Превышен лимит запросов' } }, 429);
29
+ return c.json({ error: { code: 'RATE_LIMITED', message: message ? message(c) : 'Превышен лимит запросов' } }, 429);
28
30
  }
29
31
  await next();
30
32
  });
@@ -10,7 +10,7 @@ export interface AuditRoutesDeps {
10
10
  logger: AuditLogger;
11
11
  }
12
12
  /**
13
- * GET /api/v2/audit — просмотр аудита LLM Gateway (AD-036).
13
+ * GET /api/v2/audit — просмотр аудита LLM Gateway (ADR-036).
14
14
  * RBAC: только ADMIN/AUDITOR.
15
15
  * Фильтры: userId, sessionId, since/until (ISO), limit (дефолт 100, макс 500).
16
16
  */
@@ -9,7 +9,7 @@ function toInt(value, fallback) {
9
9
  return Number.isFinite(n) ? n : fallback;
10
10
  }
11
11
  /**
12
- * GET /api/v2/audit — просмотр аудита LLM Gateway (AD-036).
12
+ * GET /api/v2/audit — просмотр аудита LLM Gateway (ADR-036).
13
13
  * RBAC: только ADMIN/AUDITOR.
14
14
  * Фильтры: userId, sessionId, since/until (ISO), limit (дефолт 100, макс 500).
15
15
  */
@@ -28,7 +28,7 @@ export function createAuditRoutes(kit, deps) {
28
28
  return c.json({ entries, total });
29
29
  });
30
30
  /**
31
- * POST /api/v2/audit/revealed — логирование раскрытия плейсхолдера (AD-036).
31
+ * POST /api/v2/audit/revealed — логирование раскрытия плейсхолдера (ADR-036).
32
32
  * RBAC: любой авторизованный (клик по бейджу SecretPlaceholder делает
33
33
  * пользователь сессии), userId фиксируется из токена.
34
34
  * Тело: { sessionId, placeholder } (placeholder вида ⟦SYNTH_SECRET_N⟧).
@@ -5,7 +5,7 @@ import { getCookie, setCookie, deleteCookie } from 'hono/cookie';
5
5
  import { t } from '../lib/i18n.js';
6
6
  import { getDefaultLang, setDefaultLang } from '../lib/i18n-config.js';
7
7
  import { readFile, writeFile, unlink } from 'node:fs/promises';
8
- import { join } from 'node:path';
8
+ import { join, resolve, sep } from 'node:path';
9
9
  const OIDC_STATE_COOKIE = 'oidc_state';
10
10
  // Встроенные умолчания оформления (совпадают с тем, что использует UI
11
11
  // по умолчанию: packages/ui/src/lib/defaults.ts + uiScale.ts).
@@ -18,6 +18,24 @@ const BUILT_IN_DEFAULTS = {
18
18
  export function createAuthRoutes(kit, config, profiles, dataDir, defaultsStore) {
19
19
  const app = new Hono();
20
20
  const avatarsDir = dataDir ? join(dataDir, 'auth', 'avatars') : null;
21
+ // Корень каталога аватаров (абсолютный) — для containment-проверки.
22
+ const avatarsRoot = avatarsDir ? resolve(avatarsDir) : null;
23
+ /**
24
+ * Безопасный абсолютный путь к файлу аватара по `username`.
25
+ * Отклоняет пустое имя, разделители пути (`/`, `\`) и `.`/`..` (traversal),
26
+ * а также результат вне каталога аватаров (defense-in-depth). `null` — отказ.
27
+ */
28
+ const resolveAvatarPath = (username) => {
29
+ if (!avatarsRoot)
30
+ return null;
31
+ const name = username.trim();
32
+ if (!name || name === '.' || name === '..')
33
+ return null;
34
+ if (/[/\\\0]/.test(name))
35
+ return null;
36
+ const full = resolve(avatarsRoot, `${name}.png`);
37
+ return full.startsWith(avatarsRoot + sep) ? full : null;
38
+ };
21
39
  // Сохранённые умолчания перекрывают встроенные; uiScaleMobile/uiScaleDesktop: null — умолчание не задано.
22
40
  const resolveDefaults = async () => {
23
41
  const stored = defaultsStore ? await defaultsStore.loadDefaults() : {};
@@ -387,7 +405,10 @@ export function createAuthRoutes(kit, config, profiles, dataDir, defaultsStore)
387
405
  return c.json({ error: { code: 'UNAUTHORIZED' } }, 401);
388
406
  if (!avatarsDir)
389
407
  return c.body(null, 404);
390
- const avatarPath = join(avatarsDir, `${user.username}.png`);
408
+ const avatarPath = resolveAvatarPath(user.username);
409
+ if (!avatarPath) {
410
+ return c.json({ error: { code: 'VALIDATION_ERROR', message: t('errors.validation.invalidUsername', undefined, c) } }, 400);
411
+ }
391
412
  try {
392
413
  const data = await readFile(avatarPath);
393
414
  return new Response(data, {
@@ -405,11 +426,15 @@ export function createAuthRoutes(kit, config, profiles, dataDir, defaultsStore)
405
426
  return c.json({ error: { code: 'UNAUTHORIZED' } }, 401);
406
427
  if (!avatarsDir)
407
428
  return c.json({ error: { code: 'INTERNAL_ERROR' } }, 500);
429
+ const avatarPath = resolveAvatarPath(user.username);
430
+ if (!avatarPath) {
431
+ return c.json({ error: { code: 'VALIDATION_ERROR', message: t('errors.validation.invalidUsername', undefined, c) } }, 400);
432
+ }
408
433
  try {
409
434
  const buffer = await c.req.arrayBuffer();
410
435
  if (buffer.byteLength === 0) {
411
436
  // Удаление аватара
412
- await unlink(join(avatarsDir, `${user.username}.png`)).catch(() => { });
437
+ await unlink(avatarPath).catch(() => { });
413
438
  if (profiles) {
414
439
  const profile = await profiles.getOrCreateProfile({ username: user.username, roles: user.roles });
415
440
  const prefs = { ...(profile.preferences || {}), avatar: '' };
@@ -418,7 +443,6 @@ export function createAuthRoutes(kit, config, profiles, dataDir, defaultsStore)
418
443
  }
419
444
  return c.json({ status: 'ok' });
420
445
  }
421
- const avatarPath = join(avatarsDir, `${user.username}.png`);
422
446
  await writeFile(avatarPath, Buffer.from(buffer));
423
447
  if (profiles) {
424
448
  const profile = await profiles.getOrCreateProfile({ username: user.username, roles: user.roles });
@@ -2,7 +2,7 @@ import { Hono } from 'hono';
2
2
  import type { AuthKit } from '../auth/middleware.js';
3
3
  import type { SecretPatternStore } from '@itphx/synth-core';
4
4
  /**
5
- * LLM Gateway (AD-036) — управление regex-паттернами детекции секретов.
5
+ * LLM Gateway (ADR-036) — управление regex-паттернами детекции секретов.
6
6
  * Схема «системный + override»: пользовательский список полностью заменяет дефолтный,
7
7
  * DELETE сбрасывает к встроенным паттернам. Только ADMIN.
8
8
  */
@@ -16,7 +16,7 @@ function isValidPattern(p) {
16
16
  }
17
17
  }
18
18
  /**
19
- * LLM Gateway (AD-036) — управление regex-паттернами детекции секретов.
19
+ * LLM Gateway (ADR-036) — управление regex-паттернами детекции секретов.
20
20
  * Схема «системный + override»: пользовательский список полностью заменяет дефолтный,
21
21
  * DELETE сбрасывает к встроенным паттернам. Только ADMIN.
22
22
  */
@@ -5,7 +5,7 @@ import { ContextLengthExceededError, deobfuscateSecrets, GatewayProvider, Provid
5
5
  /**
6
6
  * LLM Proxy endpoint (гибридный режим, Часть 5).
7
7
  * OpenAI-совместимый POST /api/v2/llm/chat/completions, через который локальный
8
- * core гоняет LLM-запросы централизованно — с применением LLM Gateway (AD-036):
8
+ * core гоняет LLM-запросы централизованно — с применением LLM Gateway (ADR-036):
9
9
  * обфускация/блокировка секретов, rate limit, аудит, полный payload-лог.
10
10
  */
11
11
  /**
@@ -30,7 +30,7 @@ const chatCompletionsSchema = z.object({
30
30
  max_tokens: z.number().int().positive().optional(),
31
31
  top_p: z.number().optional(),
32
32
  stream: z.boolean().optional(),
33
- // AD-070: remote-зеркала (RemoteProvider) просят usage в стриме. Внутренний
33
+ // ADR-070: remote-зеркала (RemoteProvider) просят usage в стриме. Внутренний
34
34
  // OpenAIProvider всегда шлёт stream_options.include_usage, но поле принимаем
35
35
  // явно, чтобы Zod его не срезал (контракт запроса).
36
36
  stream_options: z.object({ include_usage: z.boolean().optional() }).optional(),
@@ -100,7 +100,7 @@ function toLlmMessages(raw) {
100
100
  }
101
101
  export function createLlmRoutes(kit, deps) {
102
102
  const app = new Hono();
103
- // AD-052: `llm:chat` — scope service-key; обычные креды scope не ограничивают.
103
+ // ADR-052: `llm:chat` — scope service-key; обычные креды scope не ограничивают.
104
104
  const middlewares = [scopeGuard('llm:chat'), ...(deps.rateLimiter ? [deps.rateLimiter] : [])];
105
105
  // POST /api/v2/llm/chat/completions — OpenAI-совместимый LLM Proxy
106
106
  app.post('/chat/completions', kit.requireAuth, ...middlewares, async (c) => {
@@ -166,6 +166,7 @@ export function createLlmRoutes(kit, deps) {
166
166
  model: modelConfig.name,
167
167
  timeout: providerConfig.timeout ?? 120,
168
168
  maxTokens: body.max_tokens,
169
+ numCtx: providerConfig.numCtx,
169
170
  }, body.temperature, body.top_p);
170
171
  }
171
172
  catch (e) {
@@ -176,7 +177,7 @@ export function createLlmRoutes(kit, deps) {
176
177
  },
177
178
  }, 502);
178
179
  }
179
- // 3. AD-036: оборачиваем провайдер в GatewayProvider.
180
+ // 3. ADR-036: оборачиваем провайдер в GatewayProvider.
180
181
  // У локального core нет карты обфускации, поэтому для прокси держим
181
182
  // transient-карту на время запроса: getMap/saveMap читают/пишут её, а после
182
183
  // ответа деобфусцируем контент по той же карте (иначе клиент увидел бы
@@ -3,12 +3,12 @@ import type { AuthKit } from '../auth/middleware.js';
3
3
  import type { SessionManager, McpManager, McpRegistryStore } from '@itphx/synth-core';
4
4
  import type { McpNetworkPolicy } from '@itphx/synth-shared';
5
5
  export interface McpRoutesOptions {
6
- /** AD-071 §2.5: единый реестр MCP-серверов (источник истины для `/servers` и `/registry`). */
6
+ /** ADR-071 §2.5: единый реестр MCP-серверов (источник истины для `/servers` и `/registry`). */
7
7
  registry: McpRegistryStore;
8
- /** AD-071 §2.3.1: политика сетевого доступа HTTP-серверов. */
8
+ /** ADR-071 §2.3.1: политика сетевого доступа HTTP-серверов. */
9
9
  networkPolicy?: McpNetworkPolicy;
10
10
  /**
11
- * AD-071 §2.3.1: динамический источник политики (runtime-настройка из админки).
11
+ * ADR-071 §2.3.1: динамический источник политики (runtime-настройка из админки).
12
12
  * Приоритетнее статической `networkPolicy`; читается на каждый запрос.
13
13
  */
14
14
  getNetworkPolicy?: () => McpNetworkPolicy | undefined;