@itphx/synth-backend 0.10.1 → 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 (46) hide show
  1. package/dist/app/bootstrap.d.ts +2 -2
  2. package/dist/app/deps.d.ts +50 -32
  3. package/dist/app/deps.js +233 -99
  4. package/dist/app/listen.d.ts +7 -2
  5. package/dist/app/listen.js +12 -1
  6. package/dist/app/mount-routes.d.ts +16 -3
  7. package/dist/app/mount-routes.js +258 -28
  8. package/dist/app.d.ts +16 -7
  9. package/dist/app.js +104 -11
  10. package/dist/auth/guards.d.ts +2 -1
  11. package/dist/auth/guards.js +9 -1
  12. package/dist/auth/middleware.d.ts +2 -12
  13. package/dist/auth/middleware.js +20 -2
  14. package/dist/auth/oidc.d.ts +7 -0
  15. package/dist/auth/oidc.js +27 -6
  16. package/dist/auth/service-scope.d.ts +7 -3
  17. package/dist/auth/service-scope.js +8 -4
  18. package/dist/events/hub.js +3 -38
  19. package/dist/lib/app-config.d.ts +2 -0
  20. package/dist/lib/app-config.js +3 -2
  21. package/dist/lib/defaults-store.d.ts +2 -25
  22. package/dist/lib/defaults-store.js +5 -87
  23. package/dist/lib/i18n.js +48 -0
  24. package/dist/main.js +19 -3
  25. package/dist/routes/agents.d.ts +2 -2
  26. package/dist/routes/auth.d.ts +2 -2
  27. package/dist/routes/context.d.ts +2 -2
  28. package/dist/routes/gateway-patterns.d.ts +2 -2
  29. package/dist/routes/llm.d.ts +8 -2
  30. package/dist/routes/llm.js +4 -1
  31. package/dist/routes/mcp-registry.d.ts +3 -3
  32. package/dist/routes/mcp-registry.js +2 -2
  33. package/dist/routes/messages.d.ts +5 -4
  34. package/dist/routes/messages.js +30 -3
  35. package/dist/routes/models.d.ts +7 -2
  36. package/dist/routes/models.js +3 -1
  37. package/dist/routes/projects.d.ts +3 -3
  38. package/dist/routes/providers.d.ts +15 -3
  39. package/dist/routes/providers.js +33 -21
  40. package/dist/routes/queue.d.ts +5 -4
  41. package/dist/routes/queue.js +30 -3
  42. package/dist/routes/sessions.d.ts +13 -3
  43. package/dist/routes/sessions.js +197 -73
  44. package/dist/test-helpers/close-server.d.ts +33 -0
  45. package/dist/test-helpers/close-server.js +50 -0
  46. package/package.json +3 -3
package/dist/app.js CHANGED
@@ -17,14 +17,14 @@ import { Hono } from 'hono';
17
17
  import { cors } from 'hono/cors';
18
18
  import { logger } from 'hono/logger';
19
19
  import { createMiddleware } from 'hono/factory';
20
- import { nowISO, SYNTH_VERSION } from '@itphx/synth-shared';
21
- import { ServiceApiKeyStore, applyBootstrapServiceKeys, KeyRateLimiter, getServiceCredential, } from '@itphx/synth-core';
20
+ import { applyBootstrapServiceKeys, createHealthRoutes, createHttpMetricsMiddleware, createMetricsRoutes, KeyRateLimiter, getServiceCredential, MetricsRegistry, registerProcessMetrics, resolveMetricsEnabled, resolveMetricsToken, setSynthReady, } from '@itphx/synth-core';
21
+ import { createStorageDegradedGuard, createStorageStatusRoutes } from '@itphx/synth-core/server/storage-degraded.js';
22
22
  import { loadBackendConfig } from './lib/app-config.js';
23
23
  import { resolveCorsOrigin } from './lib/cors.js';
24
24
  import { createAuthMiddleware } from './auth/middleware.js';
25
25
  import { createAuthRoutes } from './routes/auth.js';
26
26
  import { t } from './lib/i18n.js';
27
- import { createBackendDeps } from './app/deps.js';
27
+ import { createBackendDeps, createBackendStorage } from './app/deps.js';
28
28
  import { mountBackendRoutes } from './app/mount-routes.js';
29
29
  import { createBackendListen } from './app/listen.js';
30
30
  /**
@@ -56,10 +56,48 @@ export async function createBackendApp(opts = {}) {
56
56
  const backendConfig = await loadBackendConfig({ configPath: opts.configPath });
57
57
  const app = new Hono();
58
58
  app.use(logger());
59
+ // PROP-032 (W2.4): единый контекст хранения — собирается до `auth`, реестр
60
+ // service-key (`storage.serviceKeys`) нужен резолверу `synth_svc_…`; тот же
61
+ // инстанс переиспользует `createBackendDeps` (в т.ч. `mcpRegistry`, который
62
+ // деп сидирует instance-серверами).
63
+ // ADR-094: контекст хранения нужен до включения метрик — runtime-настройка
64
+ // `metrics.enabled` (`settings.json`/PG) применяется при старте.
65
+ const storage = await createBackendStorage(backendConfig);
66
+ // ADR-094: метрики — реестр до middleware; при `metrics.enabled=false`
67
+ // ничего не собираем, `/metrics` отдаёт 404 (middleware не ставим).
68
+ // Приоритет: env `SYNTH_METRICS_ENABLED` > runtime (`settings.json`) >
69
+ // config.yaml `metrics.enabled` > default false.
70
+ const runtimeMetrics = await storage.settings.getMetrics();
71
+ const metricsEnabled = resolveMetricsEnabled({
72
+ configEnabled: backendConfig.synth.metrics.enabled,
73
+ runtimeEnabled: runtimeMetrics.enabled,
74
+ env: process.env,
75
+ }).enabled;
76
+ const metrics = new MetricsRegistry();
77
+ const stopProcessMetrics = metricsEnabled ? registerProcessMetrics(metrics) : null;
78
+ if (metricsEnabled)
79
+ app.use('*', createHttpMetricsMiddleware(metrics));
59
80
  // CORS настраивается после загрузки конфига
60
- // Health (без auth)
61
- app.get('/health', (c) => c.json({ status: 'healthy', version: SYNTH_VERSION, time: nowISO() }));
62
- app.get('/api/v2/health', (c) => c.json({ status: 'healthy', version: SYNTH_VERSION, time: nowISO() }));
81
+ // Health (без auth). PROP-032 (W5): при деградации хранилища status='degraded'
82
+ // + блок storage (аддитивно к {status, version, time}). `degradedInfo`
83
+ // заполняется после сборки контекста хранения ниже (до первого запроса).
84
+ // ADR-094: `/ready` — readiness (200 и при деградации, 503 — только не готов).
85
+ const degradedInfo = storage.degraded ?? null;
86
+ let initialized = false;
87
+ app.route('/', createHealthRoutes({
88
+ getStorageDegraded: () => degradedInfo ?? null,
89
+ getReadiness: () => ({
90
+ ready: initialized,
91
+ storage: degradedInfo ? 'degraded' : 'ok',
92
+ }),
93
+ }));
94
+ // ADR-094: `/metrics` — до auth (скрейп по сети pod'а, опциональный bearer).
95
+ // Токен читается на каждый запрос — правка из UI применяется без рестарта.
96
+ app.route('/', createMetricsRoutes({
97
+ registry: metrics,
98
+ enabled: metricsEnabled,
99
+ getToken: metricsEnabled ? () => resolveMetricsToken(backendConfig.dataDir) : undefined,
100
+ }));
63
101
  // Динамический CORS origin (fail-closed): явный ORIGIN через env `SYNTH_CORS_ORIGIN`;
64
102
  // иначе явный dev-флаг `SYNTH_CORS_ALLOW_ALL=true` (отражать любой origin);
65
103
  // иначе — точное совпадение с белым списком `server.allowedOrigins`.
@@ -75,9 +113,11 @@ export async function createBackendApp(opts = {}) {
75
113
  }),
76
114
  credentials: true,
77
115
  }));
78
- // ADR-052 (этап I): реестр service-key создаётся до auth — резолвер
79
- // `synth_svc_…` нужен аутентификации (паритет с core `server/app.ts`).
80
- const serviceApiKeyStore = new ServiceApiKeyStore({ dataDir: backendConfig.dataDir });
116
+ // PROP-032 (W5): состояние деградации — для health/guard/диагностики
117
+ // (уже проставлено при сборке контекста выше).
118
+ // ADR-052 (этап I): реестр service-key — резолвер ключа `synth_svc_…`
119
+ // нужен аутентификации (паритет с core `server/app.ts`).
120
+ const serviceApiKeyStore = storage.serviceKeys;
81
121
  // ADR-052/O1: идемпотентный bootstrap installer-ключей из env/Secret
82
122
  // (best-effort — ошибка конфигурации не роняет старт, пишется в лог).
83
123
  await applyBootstrapServiceKeys(serviceApiKeyStore, backendConfig.synth.security.bootstrapServiceKeys ?? []);
@@ -120,11 +160,42 @@ export async function createBackendApp(opts = {}) {
120
160
  await next();
121
161
  }));
122
162
  // Зависимости (stores/managers/оркестратор/событийное ядро/шедулер/webhooks).
123
- const deps = await createBackendDeps(backendConfig);
163
+ // Тот же контекст хранения, что собран до `auth`. ADR-094: реестр передаётся
164
+ // только при `metrics.enabled` — иначе доменные коллекторы не подключаются.
165
+ const deps = await createBackendDeps(backendConfig, storage, metricsEnabled ? metrics : undefined);
124
166
  // Auth routes (после profilesStore)
125
167
  app.route('/auth', createAuthRoutes(auth, backendConfig.auth, deps.profilesStore, deps.dataDir, deps.defaultsStore));
168
+ // PROP-032 (W5): деградированное хранилище — managed: доступ только роли
169
+ // ADMIN (остальным 503 STORAGE_DEGRADED), мутации — 503 STORAGE_DEGRADED_READONLY
170
+ // (кроме ремонтных операций maintenance). Guard — после auth-роутов (логин/health
171
+ // не блокируются) и до admin-роутов.
172
+ app.use('/api/*', createStorageDegradedGuard({
173
+ getDegraded: () => degradedInfo,
174
+ isAdmin: (c) => {
175
+ const user = c.get('user');
176
+ return Array.isArray(user?.roles) && user.roles.includes('ADMIN');
177
+ },
178
+ mutationAllowlist: ['/api/v2/maintenance'],
179
+ }));
180
+ // PROP-032 (W5): диагностика деградации (проверка соединения + «нужен рестарт»).
181
+ app.route('/', createStorageStatusRoutes({ getDegraded: () => degradedInfo }));
126
182
  // Роуты API v2 (порядок монтирования — как раньше, см. mount-routes.ts).
127
- mountBackendRoutes(app, auth, { config: backendConfig, deps, serviceApiKeyStore });
183
+ mountBackendRoutes(app, auth, {
184
+ config: backendConfig,
185
+ deps,
186
+ // ADR-094: админ-раздел «Наблюдаемость» — running-флаг, реестр,
187
+ // readiness, backend хранения и uptime.
188
+ metrics: {
189
+ runningEnabled: metricsEnabled,
190
+ getRegistry: () => metrics,
191
+ getReadiness: () => ({
192
+ ready: initialized,
193
+ storage: degradedInfo ? 'degraded' : 'ok',
194
+ }),
195
+ storageBackend: storage.kind,
196
+ getUptimeSec: () => Math.floor(process.uptime()),
197
+ },
198
+ });
128
199
  // 404
129
200
  app.notFound((c) => {
130
201
  return c.json({
@@ -146,7 +217,13 @@ export async function createBackendApp(opts = {}) {
146
217
  processMessage: deps.processMessage,
147
218
  orchestrator: deps.orchestrator,
148
219
  defaultPort: backendConfig.port,
220
+ // ADR-094: активные WS-соединения — в streams_active (если метрики включены).
221
+ metrics: metricsEnabled ? metrics : undefined,
149
222
  });
223
+ // Композиция завершена — readiness переключается в ready (ADR-094).
224
+ initialized = true;
225
+ if (metricsEnabled)
226
+ setSynthReady(metrics, 1);
150
227
  return {
151
228
  app,
152
229
  dataDir: deps.dataDir,
@@ -160,6 +237,20 @@ export async function createBackendApp(opts = {}) {
160
237
  orchestrator: deps.orchestrator,
161
238
  queueManager: deps.queueManager,
162
239
  settingsStore: deps.settingsStore,
240
+ // ADR-094: реестр метрик и остановка процессных **и** доменных коллекторов
241
+ // (таймеры сессий/хранилища, подписка шины, decision/journal).
242
+ metrics,
243
+ stopMetrics: () => {
244
+ stopProcessMetrics?.stop();
245
+ for (const stop of deps.stopMetricsCollectors) {
246
+ try {
247
+ stop();
248
+ }
249
+ catch {
250
+ // Остановка метрик не должна ломать shutdown.
251
+ }
252
+ }
253
+ },
163
254
  // ADR-089: ядро событий (понадобится на этапах 5–6).
164
255
  eventRouter: deps.eventRouter,
165
256
  requestSessionService: deps.requestSessionService,
@@ -172,11 +263,13 @@ export async function createBackendApp(opts = {}) {
172
263
  stopScheduler: () => deps.schedulerService.stop(),
173
264
  stopEphemeralSweeper: deps.stopEphemeralSweeper,
174
265
  stopEventJournalPruner: deps.stopEventJournalPruner,
266
+ stopAnalyticsRollupPruner: deps.stopAnalyticsRollupPruner,
175
267
  // ADR-052 (этап II): реестр подписок и движок webhooks + остановка на shutdown.
176
268
  webhookStore: deps.webhookStore,
177
269
  webhookService: deps.webhookService,
178
270
  stopWebhookService: () => deps.webhookService.stop(),
179
271
  stopWebhookDeliveryPruner: () => deps.stopWebhookDeliveryPruner(),
272
+ stopEgressLogPruner: () => deps.stopEgressLogPruner(),
180
273
  listen,
181
274
  };
182
275
  }
@@ -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*`), записи
@@ -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
  }
@@ -32,18 +32,8 @@ export declare function createAuthMiddleware(config: AuthMiddlewareConfig): {
32
32
  message: string;
33
33
  };
34
34
  }, 401, "json">)>;
35
- requireAdmin: import("hono").MiddlewareHandler<any, string, {}, Response | (Response & import("hono").TypedResponse<{
36
- error: {
37
- code: string;
38
- message: string;
39
- };
40
- }, 403, "json">)>;
41
- requirePermission: (...roles: string[]) => import("hono").MiddlewareHandler<any, string, {}, Response | (Response & import("hono").TypedResponse<{
42
- error: {
43
- code: string;
44
- message: string;
45
- };
46
- }, 403, "json">)>;
35
+ requireAdmin: import("hono").MiddlewareHandler<any, string, {}, Response>;
36
+ requirePermission: (...roles: string[]) => import("hono").MiddlewareHandler<any, string, {}, Response>;
47
37
  isAdmin: (c: {
48
38
  get(key: "user"): unknown;
49
39
  }) => boolean;
@@ -168,10 +168,25 @@ export function createAuthMiddleware(config) {
168
168
  c.set('user', user);
169
169
  await next();
170
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
+ };
171
183
  // Middleware: требовать роль ADMIN
172
184
  const requireAdmin = createMiddleware(async (c, next) => {
185
+ const unauthenticated = ensureAuthenticated(c);
186
+ if (unauthenticated)
187
+ return unauthenticated;
173
188
  const user = c.get('user');
174
- if (!user || !user.roles.includes('ADMIN')) {
189
+ if (!user.roles.includes('ADMIN')) {
175
190
  return c.json({ error: { code: 'FORBIDDEN', message: t('auth.forbidden', undefined, c) } }, 403);
176
191
  }
177
192
  await next();
@@ -193,8 +208,11 @@ export function createAuthMiddleware(config) {
193
208
  const isAdmin = (c) => hasRole(c, 'ADMIN');
194
209
  // Middleware: требовать одну из указанных ролей (например, ADMIN/AUDITOR)
195
210
  const requirePermission = (...roles) => createMiddleware(async (c, next) => {
211
+ const unauthenticated = ensureAuthenticated(c);
212
+ if (unauthenticated)
213
+ return unauthenticated;
196
214
  const user = c.get('user');
197
- if (!user || !roles.some((r) => user.roles.includes(r))) {
215
+ if (!roles.some((r) => user.roles.includes(r))) {
198
216
  return c.json({ error: { code: 'FORBIDDEN', message: t('auth.forbidden', undefined, c) } }, 403);
199
217
  }
200
218
  await next();
@@ -64,6 +64,13 @@ export declare class OidcClient {
64
64
  * Роли: из id_token, если пусто — из access_token (client roles учитываются).
65
65
  */
66
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;
67
74
  /** Допустимые `aud` id_token: clientId (+ дополнительные из конфига). */
68
75
  private _idTokenAudience;
69
76
  /** Допустимые `aud` access_token: clientId ИЛИ `account` (+ дополнительные). */
package/dist/auth/oidc.js CHANGED
@@ -1,4 +1,6 @@
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';
2
4
  /** Audience access_token по умолчанию (Keycloak): клиент либо `account`. */
3
5
  const DEFAULT_ACCESS_TOKEN_AUDIENCE = 'account';
4
6
  /** Известные роли Synth (в realm роли записаны в нижнем регистре). */
@@ -20,7 +22,8 @@ export class OidcClient {
20
22
  if (this._discovery)
21
23
  return this._discovery;
22
24
  const url = `${this.config.issuer}/.well-known/openid-configuration`;
23
- const res = await fetch(url);
25
+ // ADR-099: дискавери — через единый транспорт доверия TLS/CA.
26
+ const res = await egressFetch(url);
24
27
  if (!res.ok) {
25
28
  throw new Error(`OIDC discovery failed: ${res.status} ${url}`);
26
29
  }
@@ -57,7 +60,8 @@ export class OidcClient {
57
60
  client_id: this.config.clientId,
58
61
  client_secret: this.config.clientSecret,
59
62
  });
60
- const res = await fetch(discovery.token_endpoint, {
63
+ // ADR-099: обмен кода на токены — через единый транспорт доверия TLS/CA.
64
+ const res = await egressFetch(discovery.token_endpoint, {
61
65
  method: 'POST',
62
66
  headers: { 'Content-Type': 'application/x-www-form-urlencoded' },
63
67
  body: body.toString(),
@@ -85,7 +89,8 @@ export class OidcClient {
85
89
  password,
86
90
  scope: 'openid',
87
91
  });
88
- const res = await fetch(discovery.token_endpoint, {
92
+ // ADR-099: ROPC-вход — через единый транспорт доверия TLS/CA.
93
+ const res = await egressFetch(discovery.token_endpoint, {
89
94
  method: 'POST',
90
95
  headers: { 'Content-Type': 'application/x-www-form-urlencoded' },
91
96
  body: body.toString(),
@@ -107,7 +112,7 @@ export class OidcClient {
107
112
  */
108
113
  async verifyToken(token) {
109
114
  const discovery = await this.getDiscovery();
110
- const jwks = createRemoteJWKSet(new URL(discovery.jwks_uri));
115
+ const jwks = this._remoteJwks(discovery.jwks_uri);
111
116
  // Тип bearer-токена заранее неизвестен (id_token или access_token), поэтому
112
117
  // принимаем audience обоих классов: clientId (id_token) и clientId/`account`
113
118
  // (access_token Keycloak). Issuer проверяется всегда.
@@ -123,7 +128,7 @@ export class OidcClient {
123
128
  */
124
129
  async verifyTokens(idToken, accessToken) {
125
130
  const discovery = await this.getDiscovery();
126
- const jwks = createRemoteJWKSet(new URL(discovery.jwks_uri));
131
+ const jwks = this._remoteJwks(discovery.jwks_uri);
127
132
  const { payload: idPayload } = await jwtVerify(idToken, jwks, {
128
133
  issuer: this.config.issuer,
129
134
  // id_token.aud = clientId (+ доп. из конфига).
@@ -139,6 +144,22 @@ export class OidcClient {
139
144
  });
140
145
  return extractUserFromTokens(idPayload, accessPayload, this.config.clientId);
141
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
+ }
142
163
  /** Допустимые `aud` id_token: clientId (+ дополнительные из конфига). */
143
164
  _idTokenAudience() {
144
165
  return [...new Set([this.config.clientId, ...(this.config.audience ?? [])])].filter(Boolean);
@@ -1,4 +1,4 @@
1
- import type { ProjectGuard, ScopeGuardFactory } from '@itphx/synth-core';
1
+ import type { ServiceProjectProjectionGuard, ScopeGuardFactory } from '@itphx/synth-core';
2
2
  /**
3
3
  * ADR-052 (этап I): backend-обёртки scope-гейтов service-key.
4
4
  *
@@ -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,5 +1,5 @@
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
5
  * ADR-052 (этап I): backend-обёртки scope-гейтов service-key.
@@ -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({
@@ -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
  }
@@ -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';
@@ -1,87 +1,5 @@
1
- import { readFile, writeFile, rename, mkdir } from 'node:fs/promises';
2
- import { join, dirname } from 'node:path';
3
- import { atomicWrite, AsyncLock } from '@itphx/synth-shared';
4
- export const UI_SCALE_MIN = 0.5;
5
- export const UI_SCALE_MAX = 1.2;
6
- /**
7
- * Валидирует масштаб интерфейса: число в диапазоне 0.5..1.2.
8
- * Некорректное значение → undefined (поле отбрасывается).
9
- */
10
- function sanitizeScale(value) {
11
- if (typeof value === 'number' &&
12
- Number.isFinite(value) &&
13
- value >= UI_SCALE_MIN &&
14
- value <= UI_SCALE_MAX) {
15
- return value;
16
- }
17
- return undefined;
18
- }
19
- /**
20
- * Оставляет только валидные поля умолчаний оформления: locale ru/en,
21
- * themeMode system/light/dark, theme — непустая строка, uiScaleMobile и
22
- * uiScaleDesktop — каждое независимо число в диапазоне 0.5..1.2.
23
- * Некорректные поля отбрасываются (без исключений).
24
- */
25
- function sanitize(raw) {
26
- if (typeof raw !== 'object' || raw === null)
27
- return {};
28
- const src = raw;
29
- const out = {};
30
- if (src.locale === 'ru' || src.locale === 'en') {
31
- out.locale = src.locale;
32
- }
33
- if (src.themeMode === 'system' || src.themeMode === 'light' || src.themeMode === 'dark') {
34
- out.themeMode = src.themeMode;
35
- }
36
- if (typeof src.theme === 'string' && src.theme.trim() !== '') {
37
- out.theme = src.theme;
38
- }
39
- const mobile = sanitizeScale(src.uiScaleMobile);
40
- if (mobile !== undefined) {
41
- out.uiScaleMobile = mobile;
42
- }
43
- const desktop = sanitizeScale(src.uiScaleDesktop);
44
- if (desktop !== undefined) {
45
- out.uiScaleDesktop = desktop;
46
- }
47
- return out;
48
- }
49
- /**
50
- * Умолчания оформления (locale/themeMode/theme/uiScaleMobile/uiScaleDesktop) для всех пользователей.
51
- *
52
- * Хранятся одним JSON-файлом `{dataDir}/defaults.json`. Запись атомарная:
53
- * временный файл `.tmp.{uuid}` → `rename()`. Значения переживают рестарт.
54
- */
55
- export class DefaultsStore {
56
- _opts;
57
- _lock = new AsyncLock();
58
- constructor(_opts) {
59
- this._opts = _opts;
60
- }
61
- _filePath() {
62
- return join(this._opts.dataDir, 'defaults.json');
63
- }
64
- async loadDefaults() {
65
- try {
66
- const data = await readFile(this._filePath(), 'utf-8');
67
- return sanitize(JSON.parse(data));
68
- }
69
- catch {
70
- return {};
71
- }
72
- }
73
- async saveDefaults(patch) {
74
- await this._lock.acquire();
75
- try {
76
- const current = await this.loadDefaults();
77
- const next = { ...current, ...sanitize(patch) };
78
- const path = this._filePath();
79
- await mkdir(dirname(path), { recursive: true });
80
- await atomicWrite((p, d) => writeFile(p, d, 'utf-8'), (o, n) => rename(o, n), path, JSON.stringify(next, null, 2));
81
- return next;
82
- }
83
- finally {
84
- this._lock.release();
85
- }
86
- }
87
- }
1
+ // PROP-032 (W2.3): реализация перенесена в core (`storage/defaults-store.ts`) —
2
+ // это просто `{dataDir}/defaults.json` + атомарная запись, без backend-специфики.
3
+ // Здесь оставлен реэкспорт, чтобы существующие импорты (`../lib/defaults-store.js`)
4
+ // не менялись. См. `@itphx/synth-core`.
5
+ export { DefaultsStore, UI_SCALE_MIN, UI_SCALE_MAX } from '@itphx/synth-core';