@itphx/synth-backend 0.10.0 → 0.11.3

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 (62) 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 +124 -0
  4. package/dist/app/deps.js +751 -0
  5. package/dist/app/listen.d.ts +34 -0
  6. package/dist/app/listen.js +309 -0
  7. package/dist/app/mount-routes.d.ts +31 -0
  8. package/dist/app/mount-routes.js +696 -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 +30 -17
  12. package/dist/app.js +164 -1337
  13. package/dist/auth/guards.d.ts +2 -1
  14. package/dist/auth/guards.js +10 -2
  15. package/dist/auth/middleware.d.ts +9 -14
  16. package/dist/auth/middleware.js +38 -6
  17. package/dist/auth/oidc.d.ts +22 -0
  18. package/dist/auth/oidc.js +68 -9
  19. package/dist/auth/service-scope.d.ts +8 -4
  20. package/dist/auth/service-scope.js +9 -5
  21. package/dist/events/hub.d.ts +2 -2
  22. package/dist/events/hub.js +3 -38
  23. package/dist/lib/app-config.d.ts +2 -0
  24. package/dist/lib/app-config.js +3 -2
  25. package/dist/lib/cors.d.ts +23 -0
  26. package/dist/lib/cors.js +24 -0
  27. package/dist/lib/defaults-store.d.ts +2 -25
  28. package/dist/lib/defaults-store.js +5 -87
  29. package/dist/lib/i18n.js +58 -6
  30. package/dist/main.js +23 -7
  31. package/dist/middleware/rate-limiter.d.ts +4 -1
  32. package/dist/middleware/rate-limiter.js +4 -2
  33. package/dist/routes/agents.d.ts +2 -2
  34. package/dist/routes/audit.d.ts +1 -1
  35. package/dist/routes/audit.js +2 -2
  36. package/dist/routes/auth.d.ts +2 -2
  37. package/dist/routes/auth.js +28 -4
  38. package/dist/routes/context.d.ts +2 -2
  39. package/dist/routes/gateway-patterns.d.ts +3 -3
  40. package/dist/routes/gateway-patterns.js +1 -1
  41. package/dist/routes/llm.d.ts +8 -2
  42. package/dist/routes/llm.js +9 -5
  43. package/dist/routes/mcp-registry.d.ts +6 -6
  44. package/dist/routes/mcp-registry.js +10 -10
  45. package/dist/routes/mcp.d.ts +1 -1
  46. package/dist/routes/mcp.js +1 -1
  47. package/dist/routes/messages.d.ts +5 -4
  48. package/dist/routes/messages.js +30 -3
  49. package/dist/routes/models.d.ts +7 -2
  50. package/dist/routes/models.js +3 -1
  51. package/dist/routes/projects.d.ts +7 -7
  52. package/dist/routes/projects.js +7 -7
  53. package/dist/routes/providers.d.ts +15 -3
  54. package/dist/routes/providers.js +34 -21
  55. package/dist/routes/queue.d.ts +5 -4
  56. package/dist/routes/queue.js +30 -3
  57. package/dist/routes/sessions.d.ts +14 -4
  58. package/dist/routes/sessions.js +234 -34
  59. package/dist/routes/users.js +1 -1
  60. package/dist/test-helpers/close-server.d.ts +33 -0
  61. package/dist/test-helpers/close-server.js +50 -0
  62. package/package.json +3 -3
@@ -3,7 +3,8 @@
3
3
  * - запрос с service-key → требуется хотя бы один из `scopes`
4
4
  * (`403 SCOPE_REQUIRED` иначе);
5
5
  * - интерактивные креды (cookie/debug/OIDC/API-key/локальный ключ) → требуем
6
- * роль ADMIN (`403 FORBIDDEN` иначе) — прежнее поведение этих роутов.
6
+ * роль ADMIN: нет аутентификации → `401 UNAUTHORIZED`, аутентифицирован без
7
+ * роли → `403 FORBIDDEN` (семантика HTTP; раньше оба случая склеивались в 403).
7
8
  *
8
9
  * Требует уже отработавшего `attachUser`/`requireAuth` (пользователь/ключ в
9
10
  * контексте). Используется на мутациях реестра MCP (`/servers*`), записи
@@ -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 для интерактивных кред, поэтому одиночного
@@ -15,6 +15,10 @@ import { t } from '../lib/i18n.js';
15
15
  function scopeDenied(c) {
16
16
  return c.json({ error: { code: 'SCOPE_REQUIRED', message: t('errors.forbidden.scopeRequired', undefined, c) } }, 403);
17
17
  }
18
+ /** `true`, если пользователь аутентифицирован (в контексте есть `user`). */
19
+ function isAuthenticated(c) {
20
+ return !!c.get('user');
21
+ }
18
22
  /** `true`, если в контексте ADMIN (роли synthetic service-пользователя или человека). */
19
23
  function isAdmin(c) {
20
24
  const user = c.get('user');
@@ -25,7 +29,8 @@ function isAdmin(c) {
25
29
  * - запрос с service-key → требуется хотя бы один из `scopes`
26
30
  * (`403 SCOPE_REQUIRED` иначе);
27
31
  * - интерактивные креды (cookie/debug/OIDC/API-key/локальный ключ) → требуем
28
- * роль ADMIN (`403 FORBIDDEN` иначе) — прежнее поведение этих роутов.
32
+ * роль ADMIN: нет аутентификации → `401 UNAUTHORIZED`, аутентифицирован без
33
+ * роли → `403 FORBIDDEN` (семантика HTTP; раньше оба случая склеивались в 403).
29
34
  *
30
35
  * Требует уже отработавшего `attachUser`/`requireAuth` (пользователь/ключ в
31
36
  * контексте). Используется на мутациях реестра MCP (`/servers*`), записи
@@ -41,6 +46,9 @@ export function requireAdminOrScope(...scopes) {
41
46
  await next();
42
47
  return;
43
48
  }
49
+ if (!isAuthenticated(c)) {
50
+ return c.json({ error: { code: 'UNAUTHORIZED', message: t('auth.unauthorized', undefined, c) } }, 401);
51
+ }
44
52
  if (!isAdmin(c)) {
45
53
  return c.json({ error: { code: 'FORBIDDEN', message: t('auth.forbidden', undefined, c) } }, 403);
46
54
  }
@@ -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
  }
@@ -27,18 +32,8 @@ export declare function createAuthMiddleware(config: AuthMiddlewareConfig): {
27
32
  message: string;
28
33
  };
29
34
  }, 401, "json">)>;
30
- requireAdmin: import("hono").MiddlewareHandler<any, string, {}, Response | (Response & import("hono").TypedResponse<{
31
- error: {
32
- code: string;
33
- message: string;
34
- };
35
- }, 403, "json">)>;
36
- requirePermission: (...roles: string[]) => import("hono").MiddlewareHandler<any, string, {}, Response | (Response & import("hono").TypedResponse<{
37
- error: {
38
- code: string;
39
- message: string;
40
- };
41
- }, 403, "json">)>;
35
+ requireAdmin: import("hono").MiddlewareHandler<any, string, {}, Response>;
36
+ requirePermission: (...roles: string[]) => import("hono").MiddlewareHandler<any, string, {}, Response>;
42
37
  isAdmin: (c: {
43
38
  get(key: "user"): unknown;
44
39
  }) => boolean;
@@ -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);
@@ -154,10 +168,25 @@ export function createAuthMiddleware(config) {
154
168
  c.set('user', user);
155
169
  await next();
156
170
  });
171
+ /**
172
+ * Семантика HTTP для ролевых guard'ов (`requireAdmin`/`requirePermission`):
173
+ * нет аутентификации → `401 UNAUTHORIZED`; аутентифицирован, но роли не хватает
174
+ * → `403 FORBIDDEN`. Возвращает готовый 401-ответ, если пользователя в контексте
175
+ * нет (иначе `null`). Раньше оба случая склеивались в 403, и анонимный запрос к
176
+ * ADMIN-роуту получал 403 вместо 401.
177
+ */
178
+ const ensureAuthenticated = (c) => {
179
+ if (c.get('user'))
180
+ return null;
181
+ return c.json({ error: { code: 'UNAUTHORIZED', message: t('auth.unauthorized', undefined, c) } }, 401);
182
+ };
157
183
  // Middleware: требовать роль ADMIN
158
184
  const requireAdmin = createMiddleware(async (c, next) => {
185
+ const unauthenticated = ensureAuthenticated(c);
186
+ if (unauthenticated)
187
+ return unauthenticated;
159
188
  const user = c.get('user');
160
- if (!user || !user.roles.includes('ADMIN')) {
189
+ if (!user.roles.includes('ADMIN')) {
161
190
  return c.json({ error: { code: 'FORBIDDEN', message: t('auth.forbidden', undefined, c) } }, 403);
162
191
  }
163
192
  await next();
@@ -179,8 +208,11 @@ export function createAuthMiddleware(config) {
179
208
  const isAdmin = (c) => hasRole(c, 'ADMIN');
180
209
  // Middleware: требовать одну из указанных ролей (например, ADMIN/AUDITOR)
181
210
  const requirePermission = (...roles) => createMiddleware(async (c, next) => {
211
+ const unauthenticated = ensureAuthenticated(c);
212
+ if (unauthenticated)
213
+ return unauthenticated;
182
214
  const user = c.get('user');
183
- if (!user || !roles.some((r) => user.roles.includes(r))) {
215
+ if (!roles.some((r) => user.roles.includes(r))) {
184
216
  return c.json({ error: { code: 'FORBIDDEN', message: t('auth.forbidden', undefined, c) } }, 403);
185
217
  }
186
218
  await next();
@@ -204,7 +236,7 @@ export function createAuthMiddleware(config) {
204
236
  setCookie(c, SESSION_COOKIE, sessionId, {
205
237
  path: '/',
206
238
  httpOnly: true,
207
- secure: process.env.NODE_ENV === 'production',
239
+ secure: cookieSecure,
208
240
  sameSite: 'Lax',
209
241
  maxAge: config.sessionMaxAgeMinutes * 60,
210
242
  });
@@ -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,19 @@ export declare class OidcClient {
55
64
  * Роли: из id_token, если пусто — из access_token (client roles учитываются).
56
65
  */
57
66
  verifyTokens(idToken: string, accessToken: string): Promise<OidcUser>;
67
+ /**
68
+ * ADR-099: JWKS-набор с **явным** транспортом доверия TLS/CA (`egressFetch`),
69
+ * а не через глобальный dispatcher процесса — точка не зависит от глобального
70
+ * состояния (`applyGlobalTlsTrust` остаётся основным каналом для прочих fetch).
71
+ * jose 6 отдаёт кастомный транспорт через символ `customFetch`.
72
+ */
73
+ private _remoteJwks;
74
+ /** Допустимые `aud` id_token: clientId (+ дополнительные из конфига). */
75
+ private _idTokenAudience;
76
+ /** Допустимые `aud` access_token: clientId ИЛИ `account` (+ дополнительные). */
77
+ private _accessTokenAudience;
78
+ /** Допустимые `aud` для bearer-токена неизвестного типа — объединение. */
79
+ private _anyTokenAudience;
58
80
  }
59
81
  /** User-подобный объект, извлечённый из OIDC-токена. */
60
82
  export interface OidcUser {
package/dist/auth/oidc.js CHANGED
@@ -1,4 +1,8 @@
1
- import { jwtVerify, createRemoteJWKSet } from 'jose';
1
+ import { jwtVerify, createRemoteJWKSet, customFetch } from 'jose';
2
+ // ADR-099: дискавери/токен-эндпоинты/JWKS OIDC — через единый транспорт доверия TLS/CA.
3
+ import { egressFetch } from '@itphx/synth-core';
4
+ /** Audience access_token по умолчанию (Keycloak): клиент либо `account`. */
5
+ const DEFAULT_ACCESS_TOKEN_AUDIENCE = 'account';
2
6
  /** Известные роли Synth (в realm роли записаны в нижнем регистре). */
3
7
  const KNOWN_ROLES = ['ADMIN', 'USER', 'LEAD', 'AUDITOR'];
4
8
  /**
@@ -18,7 +22,8 @@ export class OidcClient {
18
22
  if (this._discovery)
19
23
  return this._discovery;
20
24
  const url = `${this.config.issuer}/.well-known/openid-configuration`;
21
- const res = await fetch(url);
25
+ // ADR-099: дискавери — через единый транспорт доверия TLS/CA.
26
+ const res = await egressFetch(url);
22
27
  if (!res.ok) {
23
28
  throw new Error(`OIDC discovery failed: ${res.status} ${url}`);
24
29
  }
@@ -55,7 +60,8 @@ export class OidcClient {
55
60
  client_id: this.config.clientId,
56
61
  client_secret: this.config.clientSecret,
57
62
  });
58
- const res = await fetch(discovery.token_endpoint, {
63
+ // ADR-099: обмен кода на токены — через единый транспорт доверия TLS/CA.
64
+ const res = await egressFetch(discovery.token_endpoint, {
59
65
  method: 'POST',
60
66
  headers: { 'Content-Type': 'application/x-www-form-urlencoded' },
61
67
  body: body.toString(),
@@ -83,7 +89,8 @@ export class OidcClient {
83
89
  password,
84
90
  scope: 'openid',
85
91
  });
86
- const res = await fetch(discovery.token_endpoint, {
92
+ // ADR-099: ROPC-вход — через единый транспорт доверия TLS/CA.
93
+ const res = await egressFetch(discovery.token_endpoint, {
87
94
  method: 'POST',
88
95
  headers: { 'Content-Type': 'application/x-www-form-urlencoded' },
89
96
  body: body.toString(),
@@ -100,12 +107,19 @@ export class OidcClient {
100
107
  }
101
108
  /**
102
109
  * Проверка JWT (id_token или access_token) через JWKS провайдера.
110
+ * Проверяются подпись, `iss` (issuer) и `aud`.
103
111
  * Возвращает User-подобный объект: id, username, email, roles.
104
112
  */
105
113
  async verifyToken(token) {
106
114
  const discovery = await this.getDiscovery();
107
- const jwks = createRemoteJWKSet(new URL(discovery.jwks_uri));
108
- const { payload } = await jwtVerify(token, jwks);
115
+ const jwks = this._remoteJwks(discovery.jwks_uri);
116
+ // Тип bearer-токена заранее неизвестен (id_token или access_token), поэтому
117
+ // принимаем audience обоих классов: clientId (id_token) и clientId/`account`
118
+ // (access_token Keycloak). Issuer проверяется всегда.
119
+ const { payload } = await jwtVerify(token, jwks, {
120
+ issuer: this.config.issuer,
121
+ audience: this._anyTokenAudience(),
122
+ });
109
123
  return extractUser(payload, this.config.clientId);
110
124
  }
111
125
  /**
@@ -114,11 +128,56 @@ export class OidcClient {
114
128
  */
115
129
  async verifyTokens(idToken, accessToken) {
116
130
  const discovery = await this.getDiscovery();
117
- const jwks = createRemoteJWKSet(new URL(discovery.jwks_uri));
118
- const { payload: idPayload } = await jwtVerify(idToken, jwks);
119
- const { payload: accessPayload } = await jwtVerify(accessToken, jwks);
131
+ const jwks = this._remoteJwks(discovery.jwks_uri);
132
+ const { payload: idPayload } = await jwtVerify(idToken, jwks, {
133
+ issuer: this.config.issuer,
134
+ // id_token.aud = clientId (+ доп. из конфига).
135
+ audience: this._idTokenAudience(),
136
+ });
137
+ const { payload: accessPayload } = await jwtVerify(accessToken, jwks, {
138
+ issuer: this.config.issuer,
139
+ // Keycloak кладёт в access_token.aud `account`, а клиента — в `azp`;
140
+ // принимаем clientId ИЛИ `account` (+ доп. из конфига), чтобы не ломать
141
+ // валидные токены. `azp` намеренно не форсим (иначе токены realm-клиентов,
142
+ // напр. `synth-cli`, отвергались бы) — issuer и подпись проверяются всегда.
143
+ audience: this._accessTokenAudience(),
144
+ });
120
145
  return extractUserFromTokens(idPayload, accessPayload, this.config.clientId);
121
146
  }
147
+ /**
148
+ * ADR-099: JWKS-набор с **явным** транспортом доверия TLS/CA (`egressFetch`),
149
+ * а не через глобальный dispatcher процесса — точка не зависит от глобального
150
+ * состояния (`applyGlobalTlsTrust` остаётся основным каналом для прочих fetch).
151
+ * jose 6 отдаёт кастомный транспорт через символ `customFetch`.
152
+ */
153
+ _remoteJwks(jwksUri) {
154
+ return createRemoteJWKSet(new URL(jwksUri), {
155
+ [customFetch]: (url, options) => egressFetch(url, {
156
+ headers: options.headers,
157
+ method: options.method,
158
+ redirect: options.redirect,
159
+ signal: options.signal,
160
+ }),
161
+ });
162
+ }
163
+ /** Допустимые `aud` id_token: clientId (+ дополнительные из конфига). */
164
+ _idTokenAudience() {
165
+ return [...new Set([this.config.clientId, ...(this.config.audience ?? [])])].filter(Boolean);
166
+ }
167
+ /** Допустимые `aud` access_token: clientId ИЛИ `account` (+ дополнительные). */
168
+ _accessTokenAudience() {
169
+ return [
170
+ ...new Set([
171
+ this.config.clientId,
172
+ DEFAULT_ACCESS_TOKEN_AUDIENCE,
173
+ ...(this.config.audience ?? []),
174
+ ]),
175
+ ].filter(Boolean);
176
+ }
177
+ /** Допустимые `aud` для bearer-токена неизвестного типа — объединение. */
178
+ _anyTokenAudience() {
179
+ return [...new Set([...this._idTokenAudience(), ...this._accessTokenAudience()])];
180
+ }
122
181
  }
123
182
  /**
124
183
  * Извлечь известные роли из payload токена Keycloak:
@@ -1,6 +1,6 @@
1
- import type { ProjectGuard, ScopeGuardFactory } from '@itphx/synth-core';
1
+ import type { ServiceProjectProjectionGuard, 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`)
@@ -10,5 +10,9 @@ import type { ProjectGuard, ScopeGuardFactory } from '@itphx/synth-core';
10
10
  */
11
11
  /** Scope-гейт: делегирует проверку core-`requireScope`, переводит 403 на i18n. */
12
12
  export declare const scopeGuard: ScopeGuardFactory;
13
- /** Гейт проектной проекции: делегирует core-`checkProjectAccess`, переводит 403. */
14
- export declare const projectGuard: ProjectGuard;
13
+ /**
14
+ * Гейт **проектной проекции service-key**: делегирует core-
15
+ * `checkServiceProjectProjection`, переводит 403. Это не проверка прав
16
+ * пользователя (RBAC): для интерактивных кред — no-op.
17
+ */
18
+ export declare const serviceProjectProjection: ServiceProjectProjectionGuard;
@@ -1,8 +1,8 @@
1
1
  import { createMiddleware } from 'hono/factory';
2
- import { requireScope, checkProjectAccess } from '@itphx/synth-core';
2
+ import { requireScope, checkServiceProjectProjection } 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`)
@@ -26,9 +26,13 @@ export const scopeGuard = (...required) => {
26
26
  await next();
27
27
  });
28
28
  };
29
- /** Гейт проектной проекции: делегирует core-`checkProjectAccess`, переводит 403. */
30
- export const projectGuard = (c, projectId) => {
31
- const denied = checkProjectAccess(c, projectId);
29
+ /**
30
+ * Гейт **проектной проекции service-key**: делегирует core-
31
+ * `checkServiceProjectProjection`, переводит 403. Это не проверка прав
32
+ * пользователя (RBAC): для интерактивных кред — no-op.
33
+ */
34
+ export const serviceProjectProjection = (c, projectId) => {
35
+ const denied = checkServiceProjectProjection(c, projectId);
32
36
  if (!denied)
33
37
  return undefined;
34
38
  return c.json({
@@ -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;
@@ -1,42 +1,6 @@
1
+ import { extractChildSessionId } from '@itphx/synth-core';
1
2
  /** Служебный ключ глобальной подписки all-клиента в `clientSubs`. */
2
3
  const ALL_SESSIONS_KEY = '*';
3
- /** Безопасное чтение непустой строки из `unknown`. */
4
- function readString(value) {
5
- return typeof value === 'string' && value.length > 0 ? value : undefined;
6
- }
7
- /**
8
- * Извлечь id новой дочерней сессии из события, опубликованного в родительскую
9
- * сессию. Дочерние сессии саб-агентов создаются тулом `task` напрямую через
10
- * `SessionManager`, минуя роуты, поэтому клиент изначально на них не подписан.
11
- * Тул `task` публикует `session.created` (payload — serializeSession ребёнка) в
12
- * родителя ДО старта LLM-стрима ребёнка, так что автоподписка успевает.
13
- * `child.session.updated` несёт `session` (id внутри), `child.message.added` и
14
- * resume-события — `child_session_id`. Ключи каждого события читаются ровно в
15
- * одном месте (типизированные payload-интерфейсы выше).
16
- */
17
- function extractChildSessionId(event) {
18
- const data = event.data;
19
- if (!data)
20
- return undefined;
21
- switch (event.type) {
22
- case 'session.created': {
23
- const payload = data;
24
- return readString(payload.id);
25
- }
26
- case 'child.session.updated': {
27
- const payload = data;
28
- return readString(payload.session?.id) ?? readString(payload.child_session_id);
29
- }
30
- case 'child.message.added':
31
- case 'subagent.resume.started':
32
- case 'subagent.resume.finished': {
33
- const payload = data;
34
- return readString(payload.child_session_id);
35
- }
36
- default:
37
- return undefined;
38
- }
39
- }
40
4
  /**
41
5
  * EventHub — центральный диспетчер подписок на события сессий.
42
6
  * Управляет active-клиентами пользователя (WS и SSE),
@@ -64,7 +28,8 @@ export class EventHub {
64
28
  console.log(`[EventHub] Register client (all sessions): user=${client.username} clients=${arr.length}`);
65
29
  return;
66
30
  }
67
- const sessions = await this.sessionManager.listSessions({ userId: client.userId });
31
+ // Нужны только id сессий владельца — лёгкая выборка (без истории сообщений).
32
+ const sessions = await this.sessionManager.listSessions({ userId: client.userId }, { light: true });
68
33
  console.log(`[EventHub] Register client: user=${client.username} clients=${arr.length} sessions=${sessions.length}`);
69
34
  for (const s of sessions) {
70
35
  this._subscribeClientToSession(client, s.id);
@@ -4,6 +4,8 @@ export interface BackendConfig {
4
4
  synth: SynthConfig;
5
5
  dataDir: string;
6
6
  workspacesRoot: string;
7
+ /** Максимальный размер загрузки файла (`POST /api/v2/fs/upload`), байт (config/env). */
8
+ maxUploadBytes: number;
7
9
  port: number;
8
10
  auth: AuthConfig;
9
11
  }
@@ -1,4 +1,4 @@
1
- import { loadConfig, resolveDataDir, resolvePort, resolveWorkspacesRoot } from '@itphx/synth-shared';
1
+ import { loadConfig, resolveDataDir, resolvePort, resolveWorkspacesRoot, resolveMaxUploadBytes } from '@itphx/synth-shared';
2
2
  const envStr = (key, fallback = '') => process.env[key] || fallback;
3
3
  const envBool = (key, fallback = false) => process.env[key] ? process.env[key] === 'true' : fallback;
4
4
  const envInt = (key, fallback) => {
@@ -59,6 +59,7 @@ export async function loadBackendConfig(options) {
59
59
  const auth = buildAuthConfig(synth.auth);
60
60
  const dataDir = resolveDataDir(synth);
61
61
  const workspacesRoot = resolveWorkspacesRoot(synth);
62
+ const maxUploadBytes = resolveMaxUploadBytes(synth);
62
63
  const port = resolvePort(synth, 'SYNTH_PORT', synth.server.port);
63
- return { synth, dataDir, workspacesRoot, port, auth };
64
+ return { synth, dataDir, workspacesRoot, maxUploadBytes, port, auth };
64
65
  }
@@ -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
+ }
@@ -1,25 +1,2 @@
1
- export interface AppearanceDefaults {
2
- locale?: 'ru' | 'en';
3
- themeMode?: 'system' | 'light' | 'dark';
4
- theme?: string;
5
- uiScaleMobile?: number;
6
- uiScaleDesktop?: number;
7
- }
8
- export declare const UI_SCALE_MIN = 0.5;
9
- export declare const UI_SCALE_MAX = 1.2;
10
- /**
11
- * Умолчания оформления (locale/themeMode/theme/uiScaleMobile/uiScaleDesktop) для всех пользователей.
12
- *
13
- * Хранятся одним JSON-файлом `{dataDir}/defaults.json`. Запись атомарная:
14
- * временный файл `.tmp.{uuid}` → `rename()`. Значения переживают рестарт.
15
- */
16
- export declare class DefaultsStore {
17
- private _opts;
18
- private _lock;
19
- constructor(_opts: {
20
- dataDir: string;
21
- });
22
- private _filePath;
23
- loadDefaults(): Promise<AppearanceDefaults>;
24
- saveDefaults(patch: AppearanceDefaults): Promise<AppearanceDefaults>;
25
- }
1
+ export { DefaultsStore, UI_SCALE_MIN, UI_SCALE_MAX } from '@itphx/synth-core';
2
+ export type { AppearanceDefaults } from '@itphx/synth-core';