@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
@@ -0,0 +1,15 @@
1
+ import type { Hono } from 'hono';
2
+ import type { ScopeGuardFactory } from '@itphx/synth-core';
3
+ import type { AuthKit } from '../auth/middleware.js';
4
+ import type { EventHub } from '../events/hub.js';
5
+ export interface EventsSseDeps {
6
+ auth: AuthKit;
7
+ eventHub: EventHub;
8
+ /** ADR-052: `events:watch` — scope-гейт service-key (для интерактивных кред — no-op). */
9
+ scopeGuard: ScopeGuardFactory;
10
+ }
11
+ /**
12
+ * Зарегистрировать SSE-хаб (`GET /api/v2/events`): подписка на события сессий
13
+ * пользователя (watch-all — для service-key и ADMIN/LEAD, ADR-052 этап IV).
14
+ */
15
+ export declare function registerEventsSse(app: Hono, deps: EventsSseDeps): void;
@@ -0,0 +1,83 @@
1
+ import { getServiceCredential } from '@itphx/synth-core';
2
+ /**
3
+ * Зарегистрировать SSE-хаб (`GET /api/v2/events`): подписка на события сессий
4
+ * пользователя (watch-all — для service-key и ADMIN/LEAD, ADR-052 этап IV).
5
+ */
6
+ export function registerEventsSse(app, deps) {
7
+ const { auth, eventHub, scopeGuard } = deps;
8
+ // Глобальный SSE-хаб для всех сессий пользователя.
9
+ // ADR-052: `events:watch` — scope service-key для подписки на поток событий.
10
+ app.get('/api/v2/events', auth.requireAuth, scopeGuard('events:watch'), async (c) => {
11
+ const user = (await auth.getCurrentUser(c));
12
+ const signal = c.req.raw.signal;
13
+ // ADR-052 (этап IV) / ADR-089: машинный watcher (service-key со scope
14
+ // `events:watch`) и роли сквозного обзора ADMIN/LEAD получают события ВСЕХ
15
+ // сессий (паритет со standalone-core `subscribeAll`), обычный пользователь —
16
+ // только своих. Без этого синтетический `service:<keyId>` шлюза не владеет
17
+ // сессиями → подписок 0 → ответы агента не доходят до Telegram.
18
+ const allSessions = Boolean(getServiceCredential(c)) || auth.hasRole(c, 'ADMIN', 'LEAD');
19
+ return new Response(new ReadableStream({
20
+ async start(controller) {
21
+ const encoder = new TextEncoder();
22
+ const sseClient = {
23
+ userId: user.id,
24
+ username: user.username,
25
+ allSessions,
26
+ send(event) {
27
+ try {
28
+ const line = `data: ${JSON.stringify(event)}\n\n`;
29
+ controller.enqueue(encoder.encode(line));
30
+ }
31
+ catch {
32
+ // client disconnected
33
+ }
34
+ },
35
+ };
36
+ try {
37
+ console.log(`[SSE /api/v2/events] Connected: user=${user.username} allSessions=${allSessions}`);
38
+ await eventHub.registerClient(sseClient);
39
+ // Keepalive: раз в 30 секунд отправляем комментарий для предотвращения разрыва
40
+ const keepalive = setInterval(() => {
41
+ try {
42
+ controller.enqueue(encoder.encode(':keepalive\n\n'));
43
+ }
44
+ catch {
45
+ clearInterval(keepalive);
46
+ }
47
+ }, 30_000);
48
+ // Keep connection alive until abort or disconnect
49
+ try {
50
+ await new Promise((resolve) => {
51
+ if (signal.aborted) {
52
+ resolve();
53
+ return;
54
+ }
55
+ signal.addEventListener('abort', () => resolve(), { once: true });
56
+ });
57
+ }
58
+ finally {
59
+ clearInterval(keepalive);
60
+ }
61
+ }
62
+ catch (err) {
63
+ console.error('[SSE /api/v2/events] Error:', err);
64
+ }
65
+ finally {
66
+ eventHub.unregisterClient(sseClient);
67
+ try {
68
+ controller.close();
69
+ }
70
+ catch { /* already closed */ }
71
+ }
72
+ },
73
+ }), {
74
+ status: 200,
75
+ headers: {
76
+ 'Content-Type': 'text/event-stream',
77
+ 'Cache-Control': 'no-cache',
78
+ 'Connection': 'keep-alive',
79
+ 'X-Accel-Buffering': 'no',
80
+ },
81
+ });
82
+ });
83
+ }
package/dist/app.d.ts CHANGED
@@ -1,11 +1,11 @@
1
1
  import { createServer } from 'node:http';
2
2
  import { WebSocketServer } from 'ws';
3
3
  import { Hono } from 'hono';
4
- import { SessionManager, EventBus, QueueProcessorManager, ChatOrchestrator, RuntimeSettingsStore, EventBindingStore, EventJournalStore, EventRouter, RequestSessionService, EventIngress, ScheduleStore, SchedulerService, WebhookStore, WebhookService } from '@itphx/synth-core';
4
+ import { MetricsRegistry } from '@itphx/synth-core';
5
+ import type { EventBus, SessionManager, QueueProcessorManager, ChatOrchestrator, ProjectRepository, SettingsRepository, EventRouter, RequestSessionService, EventBindingRepository, EventJournalRepository, EventIngress, ScheduleRepository, SchedulerService, WebhookRepository, WebhookService } from '@itphx/synth-core';
5
6
  import type { BackendConfig } from './lib/app-config.js';
6
7
  import type { AuthKit } from './auth/middleware.js';
7
- import { ProjectStore } from '@itphx/synth-core';
8
- import { EventHub } from './events/hub.js';
8
+ import type { EventHub } from './events/hub.js';
9
9
  export interface CreateBackendAppOptions {
10
10
  /** Путь к config.yaml (по умолчанию — каскадный поиск, как в main.ts). */
11
11
  configPath?: string;
@@ -29,32 +29,40 @@ export interface BackendAppHandle {
29
29
  eventBus: EventBus;
30
30
  eventHub: EventHub;
31
31
  sessionManager: SessionManager;
32
- projectStore: ProjectStore;
32
+ projectStore: ProjectRepository;
33
33
  orchestrator: ChatOrchestrator;
34
34
  queueManager: QueueProcessorManager;
35
- settingsStore: RuntimeSettingsStore;
35
+ settingsStore: SettingsRepository;
36
+ /** ADR-094: реестр метрик (HTTP/процесс и доменные коллекторы). */
37
+ metrics: MetricsRegistry;
38
+ /** ADR-094: остановка процессных метрик и фоновых доменных коллекторов на shutdown. */
39
+ stopMetrics: () => void;
36
40
  eventRouter: EventRouter;
37
41
  requestSessionService: RequestSessionService;
38
- eventBindingStore: EventBindingStore;
39
- eventJournal: EventJournalStore;
40
- /** AD-089: ingress-точка приёма внешних событий. */
42
+ eventBindingStore: EventBindingRepository;
43
+ eventJournal: EventJournalRepository;
44
+ /** ADR-089: ingress-точка приёма внешних событий. */
41
45
  ingress: EventIngress;
42
- scheduleStore: ScheduleStore;
46
+ scheduleStore: ScheduleRepository;
43
47
  scheduler: SchedulerService;
44
- /** AD-051 (срез): остановка планировщика (на graceful shutdown). */
48
+ /** ADR-051 (срез): остановка планировщика (на graceful shutdown). */
45
49
  stopScheduler: () => void;
46
- /** AD-089: остановка sweeper'а авто-архивации ephemeral-сессий. */
50
+ /** ADR-089: остановка sweeper'а авто-архивации ephemeral-сессий. */
47
51
  stopEphemeralSweeper: () => void;
48
- /** AD-089: остановка периодической retention-очистки журнала событий. */
52
+ /** ADR-089: остановка периодической retention-очистки журнала событий. */
49
53
  stopEventJournalPruner: () => void;
50
- /** AD-052 (этап II): реестр подписок webhooks (для тестов/диагностики). */
51
- webhookStore: WebhookStore;
52
- /** AD-052 (этап II): движок исходящих webhooks. */
54
+ /** PROP-102: остановка retention-очистки суточных роллапов аналитики. */
55
+ stopAnalyticsRollupPruner: () => void;
56
+ /** ADR-052 (этап II): реестр подписок webhooks (для тестов/диагностики). */
57
+ webhookStore: WebhookRepository;
58
+ /** ADR-052 (этап II): движок исходящих webhooks. */
53
59
  webhookService: WebhookService;
54
- /** AD-052 (этап II): остановка движка webhooks (на graceful shutdown). */
60
+ /** ADR-052 (этап II): остановка движка webhooks (на graceful shutdown). */
55
61
  stopWebhookService: () => void;
56
- /** AD-052 (этап II): остановка retention-очистки журнала доставок. */
62
+ /** ADR-052 (этап II): остановка retention-очистки журнала доставок. */
57
63
  stopWebhookDeliveryPruner: () => void;
64
+ /** Egress: остановка retention-очистки журнала внешних запросов. */
65
+ stopEgressLogPruner: () => void;
58
66
  /**
59
67
  * Поднять HTTP-сервер (+ WebSocket /ws/events) на указанном порту.
60
68
  * Порт 0 → эфемерный; возвращает фактический порт.
@@ -65,4 +73,9 @@ export interface BackendAppHandle {
65
73
  port: number;
66
74
  }>;
67
75
  }
76
+ /**
77
+ * Backend-приложение Synth (managed): `createBackendApp` без прослушивания порта.
78
+ * Фасад-композиция: зависимости — `app/deps.ts`, порядок монтирования роутов —
79
+ * `app/mount-routes.ts`, SSE-хаб — `app/sse-events.ts`, HTTP/WS — `app/listen.ts`.
80
+ */
68
81
  export declare function createBackendApp(opts?: CreateBackendAppOptions): Promise<BackendAppHandle>;