@itphx/synth-shared 0.13.4 → 0.13.8

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 (50) hide show
  1. package/dist/config/defaults.js +28 -1
  2. package/dist/config/env-overrides.d.ts +23 -4
  3. package/dist/config/env-overrides.js +74 -4
  4. package/dist/config/index.d.ts +1 -0
  5. package/dist/config/index.js +1 -0
  6. package/dist/config/loader.d.ts +8 -0
  7. package/dist/config/loader.js +6 -1
  8. package/dist/config/redact.d.ts +22 -0
  9. package/dist/config/redact.js +53 -0
  10. package/dist/config/tls.d.ts +7 -4
  11. package/dist/config/tls.js +10 -23
  12. package/dist/config/types.d.ts +102 -4
  13. package/dist/config/types.js +73 -0
  14. package/dist/i18n/index.d.ts +1 -1
  15. package/dist/i18n/index.js +129 -0
  16. package/dist/index.d.ts +3 -3
  17. package/dist/index.js +3 -3
  18. package/dist/model-metadata.d.ts +10 -0
  19. package/dist/model-metadata.js +10 -0
  20. package/dist/schemas/index.d.ts +288 -11
  21. package/dist/schemas/index.js +228 -2
  22. package/dist/types/bus-events.d.ts +2 -2
  23. package/dist/types/egress.d.ts +2 -2
  24. package/dist/types/egress.js +2 -2
  25. package/dist/types/git.d.ts +83 -0
  26. package/dist/types/git.js +101 -1
  27. package/dist/types/host-pattern.d.ts +41 -0
  28. package/dist/types/host-pattern.js +143 -0
  29. package/dist/types/index.d.ts +2 -0
  30. package/dist/types/index.js +7 -1
  31. package/dist/types/maintenance.d.ts +1 -1
  32. package/dist/types/mcp.d.ts +90 -0
  33. package/dist/types/mcp.js +11 -0
  34. package/dist/types/message-stream.d.ts +41 -0
  35. package/dist/types/permission.d.ts +13 -3
  36. package/dist/types/project.d.ts +30 -0
  37. package/dist/types/project.js +16 -0
  38. package/dist/types/prompt.d.ts +4 -2
  39. package/dist/types/service-keys.d.ts +6 -3
  40. package/dist/types/service-keys.js +6 -1
  41. package/dist/types/session.d.ts +8 -0
  42. package/dist/types/skills.d.ts +6 -0
  43. package/dist/types/tools.d.ts +36 -0
  44. package/dist/types/tools.js +48 -0
  45. package/dist/types/user.d.ts +7 -0
  46. package/dist/types/worktree.d.ts +1 -1
  47. package/dist/utils/index.js +1 -1
  48. package/dist/version.d.ts +1 -1
  49. package/dist/version.js +1 -1
  50. package/package.json +3 -2
@@ -1,4 +1,4 @@
1
- import { DEFAULT_MCP_PRIVATE_CIDRS, DEFAULT_EGRESS_TOOLS_POLICY, DEFAULT_EGRESS_WEBHOOKS_POLICY, DEFAULT_EGRESS_LOG, } from '../types/index.js';
1
+ import { DEFAULT_MCP_PRIVATE_CIDRS, DEFAULT_EGRESS_TOOLS_POLICY, DEFAULT_EGRESS_WEBHOOKS_POLICY, DEFAULT_EGRESS_LOG, GlobalRole, } from '../types/index.js';
2
2
  import { DEFAULT_MAX_UPLOAD_BYTES, DEFAULT_MAX_READ_BYTES, DEFAULT_MAX_PREVIEW_BYTES } from '../types/index.js';
3
3
  import { DEFAULT_PROMPT_BLOCK_MAX_CHARS, DEFAULT_LLM_FILTER_TIMEOUT_MS } from '../types/index.js';
4
4
  import { DEFAULT_EXECUTION_TIMEOUT_MS } from './types.js';
@@ -46,6 +46,9 @@ export const defaultConfig = {
46
46
  },
47
47
  auth: {
48
48
  debugMode: false,
49
+ // Единый API-ключ выдаёт только базовую роль; ADMIN — явной настройкой
50
+ // (`auth.apiKeyRoles` / `SYNTH_API_KEY_ROLES`).
51
+ apiKeyRoles: [GlobalRole.USER],
49
52
  sessionMaxAgeMinutes: 1440,
50
53
  },
51
54
  llm: {
@@ -241,6 +244,11 @@ export const defaultConfig = {
241
244
  localTimeoutMs: 120_000,
242
245
  networkTimeoutMs: 300_000,
243
246
  },
247
+ ssh: {
248
+ // PROP-124: режим работы инстанса с SSH-ключами. `tools` — fail-closed:
249
+ // без явного выбора ключ не попадает в окружение команд.
250
+ mode: 'tools',
251
+ },
244
252
  questions: {
245
253
  // Этап 1 roadmap 0.13 (блок 3): срок ожидания ответа пользователя на вопрос —
246
254
  // по умолчанию **без таймаута** (0): вопрос ждёт, пока ответят или отменят
@@ -276,6 +284,11 @@ export const defaultConfig = {
276
284
  // текущая — 0, родитель — 1, …). 0 — без ограничения.
277
285
  subagentDepth: 1,
278
286
  },
287
+ limits: {
288
+ // Лимит тяжёлых операций с сессиями (import/export/fork/merge) в минуту
289
+ // на креду. 0 — без ограничения.
290
+ sessionOpsPerMinute: 10,
291
+ },
279
292
  attachments: {
280
293
  // ADR-115: вложения сообщений. Мастер-выключатель, семейства MIME,
281
294
  // лимиты (байты на файл, число файлов в сообщении, суммарный объём на
@@ -327,6 +340,20 @@ export const defaultConfig = {
327
340
  // ADR-094: экспорт Prometheus-метрик выключен по умолчанию (`GET /metrics` → 404).
328
341
  enabled: false,
329
342
  },
343
+ updates: {
344
+ // ADR-133: автопроверка обновлений **выключена по умолчанию** — инстанс не
345
+ // ходит в реестры без явного согласия владельца (офлайн/закрытый контур не
346
+ // шумит запросами). Явная проверка (`synth update --check`, `?force=1`) от
347
+ // этого флага не зависит.
348
+ check: false,
349
+ // Канал выводится из установленной версии (`-beta.` ⇒ beta), иначе stable.
350
+ channel: 'auto',
351
+ // TTL успешной проверки; ошибка кэшируется на 1 ч.
352
+ intervalHours: 24,
353
+ // Стабильный канал — npmjs; бета — npm-реестр Gitea (чтение без токена).
354
+ stableRegistry: 'https://registry.npmjs.org',
355
+ betaRegistry: 'https://git.itphx.ru/api/packages/itphx/npm/',
356
+ },
330
357
  authority: {
331
358
  // ADR-106 Ф1: Authority-слой выключен по умолчанию — права не меняются.
332
359
  enabled: false,
@@ -1,3 +1,4 @@
1
+ import { GlobalRole } from '../types/user.js';
1
2
  export type EnvOverrideType = 'boolean' | 'number' | 'string';
2
3
  export interface EnvOverrideDefinition {
3
4
  /** Секция верхнего уровня конфига (`events`, `scheduler`, `webhooks`, `decision`). */
@@ -18,6 +19,21 @@ export interface EnvOverrideDefinition {
18
19
  export declare const ENV_OVERRIDES: readonly EnvOverrideDefinition[];
19
20
  /** camelCase → SNAKE_CASE (`autoBind` → `AUTO_BIND`, `ephemeralTtl` → `EPHEMERAL_TTL`). */
20
21
  export declare function toSnakeCase(value: string): string;
22
+ /**
23
+ * Роли пользователя единого API-ключа (`auth.apiKeyRoles`), csv: `ADMIN,USER`.
24
+ *
25
+ * Намеренно **fail-closed** (в отличие от прочих env-оверрайдов): неизвестная
26
+ * роль — ошибка конфигурации на загрузке, а не warn+игнор. Иначе опечатка в
27
+ * `SYNTH_API_KEY_ROLES` молча оставляла бы дефолт (`USER`) или, хуже, ключ без
28
+ * ожидаемых прав; для прав доступа это недопустимо.
29
+ */
30
+ export declare const API_KEY_ROLES_ENV = "SYNTH_API_KEY_ROLES";
31
+ /**
32
+ * Разобрать csv ролей API-ключа (`ADMIN,USER`; регистр и пробелы не важны).
33
+ * Пустой список и неизвестная роль → `Error` (fail-closed, понятный текст).
34
+ * Дубликаты схлопываются с сохранением порядка.
35
+ */
36
+ export declare function parseApiKeyRoles(raw: string): GlobalRole[];
21
37
  /**
22
38
  * Полное env-имя определения: `SYNTH_<SECTION>_<KEY>`. Точки в ключе означают
23
39
  * вложенность (`log.enabled` → `SYNTH_EGRESS_LOG_ENABLED`).
@@ -89,10 +105,13 @@ export declare const BOOTSTRAP_SERVICE_KEYS_ENV = "SYNTH_BOOTSTRAP_SERVICE_KEYS"
89
105
  export declare const OAUTH_PROVIDERS_ENV = "SYNTH_OAUTH_PROVIDERS";
90
106
  /**
91
107
  * Применяет объектные env-оверрайды, у которых нет плоского строкового
92
- * представления (сейчас — `security.bootstrapServiceKeys`). Значение парсится
93
- * как JSON и валидируется схемой; при ошибке парсинга/валидации — warn в console
94
- * и игнор (fail-soft: кривой installer-ключ не должен ронять старт инстанса —
95
- * ensure-логика приложения просто ничего не бутстрапит, оператор видит warn).
108
+ * представления (`auth.apiKeyRoles`, `attachments.modalities`, `oauth.providers`,
109
+ * `security.bootstrapServiceKeys`). Нескалярные значения парсятся здесь;
110
+ * `security.bootstrapServiceKeys` — JSON, валидируется схемой, при ошибке
111
+ * парсинга/валидации warn в console и игнор (fail-soft: кривой installer-ключ не
112
+ * должен ронять старт инстанса — ensure-логика приложения просто ничего не
113
+ * бутстрапит, оператор видит warn). Исключение — `auth.apiKeyRoles`: там
114
+ * неизвестная роль бросает `Error` (fail-closed, права доступа).
96
115
  *
97
116
  * Мутирует переданный объект (в `loadConfig` — свежий результат `deepMerge`) и
98
117
  * возвращает его; секция `security` клонируется, чтобы не мутировать `defaultConfig`.
@@ -11,6 +11,7 @@
11
11
  * Приоритет (ADR-023): CLI-флаги (`overrides`) > env (`SYNTH_*`) > config.yaml > defaults.
12
12
  */
13
13
  import { bootstrapServiceKeysSchema, oauthProvidersSchema } from './types.js';
14
+ import { GlobalRole } from '../types/user.js';
14
15
  /**
15
16
  * Реестр env-оверрайдов скалярных ключей вложенных секций (ADR-023).
16
17
  *
@@ -22,6 +23,10 @@ import { bootstrapServiceKeysSchema, oauthProvidersSchema } from './types.js';
22
23
  export const ENV_OVERRIDES = [
23
24
  // llm: лимит вывода по умолчанию (0 — авто-дефолт ядра).
24
25
  { section: 'llm', key: 'maxTokens', type: 'number' },
26
+ // llmGateway (ADR-036): мастер-выключатель шлюза. Дефолт зависит от профиля
27
+ // (backend/managed — включён, standalone — выключен); env перебивает и его,
28
+ // и config.yaml, но ниже runtime-тумблера из UI (`settings.json`).
29
+ { section: 'llmGateway', key: 'enabled', type: 'boolean' },
25
30
  // session.autoTitle: авто-именование сессии (мастер-флаг, отсрочка на
26
31
  // приветствии, число реплик, порог «сигнала задачи»).
27
32
  { section: 'session', key: 'autoTitle.enabled', type: 'boolean' },
@@ -77,6 +82,11 @@ export const ENV_OVERRIDES = [
77
82
  // git-тулы агента: локальные изменяющие операции и сетевые (0 — без таймаута).
78
83
  { section: 'git', key: 'localTimeoutMs', type: 'number' },
79
84
  { section: 'git', key: 'networkTimeoutMs', type: 'number' },
85
+ // ssh (PROP-124): режим работы инстанса с SSH-ключами (`tools`|`agent`).
86
+ // Переменная `SYNTH_SSH_MODE` читается НЕ здесь, а дедикарованным
87
+ // резолвером `resolveSshMode` (core) — как `SYNTH_EXECUTION_MODE`/
88
+ // `SYNTH_STORAGE_BACKEND`: один путь чтения на переменную, невалидное
89
+ // значение — ошибка конфигурации (fail-closed), а не warn + дефолт.
80
90
  // questions (этап 1 roadmap 0.13 — блок 3): таймаут ответа + retention.
81
91
  { section: 'questions', key: 'timeoutMs', type: 'number' },
82
92
  { section: 'questions', key: 'retentionDays', type: 'number' },
@@ -91,6 +101,8 @@ export const ENV_OVERRIDES = [
91
101
  { section: 'agents', key: 'subagentMaxInputTokens', type: 'number' },
92
102
  // agents: лимит глубины вложенности саб-агентов (0 — без ограничения).
93
103
  { section: 'agents', key: 'subagentDepth', type: 'number' },
104
+ // limits: лимит тяжёлых операций с сессиями в минуту (0 — без ограничения).
105
+ { section: 'limits', key: 'sessionOpsPerMinute', type: 'number' },
94
106
  // attachments (ADR-115): вложения сообщений. Семейства MIME
95
107
  // (`SYNTH_ATTACHMENTS_MODALITIES`, csv) — объектный ключ, обрабатывается
96
108
  // отдельно (`applyAttachmentsModalitiesEnvOverride`); список префиксов
@@ -109,6 +121,13 @@ export const ENV_OVERRIDES = [
109
121
  { section: 'attachments', key: 'maxActiveUploads', type: 'number' },
110
122
  // metrics (ADR-094): Helm ставит `SYNTH_METRICS_ENABLED` — имя должно совпадать.
111
123
  { section: 'metrics', key: 'enabled', type: 'boolean' },
124
+ // updates (ADR-133): каналы обновлений. `check` — автопроверка в фоне;
125
+ // `channel` — `auto`|`stable`|`beta`; интервал и реестры каналов.
126
+ { section: 'updates', key: 'check', type: 'boolean' },
127
+ { section: 'updates', key: 'channel', type: 'string' },
128
+ { section: 'updates', key: 'intervalHours', type: 'number' },
129
+ { section: 'updates', key: 'stableRegistry', type: 'string' },
130
+ { section: 'updates', key: 'betaRegistry', type: 'string' },
112
131
  // tools: общий предел вывода инструментов (строк/байт).
113
132
  { section: 'tools', key: 'outputMaxLines', type: 'number' },
114
133
  { section: 'tools', key: 'outputMaxBytes', type: 'number' },
@@ -140,6 +159,53 @@ export const ENV_OVERRIDES = [
140
159
  export function toSnakeCase(value) {
141
160
  return value.replace(/([a-z0-9])([A-Z])/g, '$1_$2').toUpperCase();
142
161
  }
162
+ /**
163
+ * Роли пользователя единого API-ключа (`auth.apiKeyRoles`), csv: `ADMIN,USER`.
164
+ *
165
+ * Намеренно **fail-closed** (в отличие от прочих env-оверрайдов): неизвестная
166
+ * роль — ошибка конфигурации на загрузке, а не warn+игнор. Иначе опечатка в
167
+ * `SYNTH_API_KEY_ROLES` молча оставляла бы дефолт (`USER`) или, хуже, ключ без
168
+ * ожидаемых прав; для прав доступа это недопустимо.
169
+ */
170
+ export const API_KEY_ROLES_ENV = 'SYNTH_API_KEY_ROLES';
171
+ const API_KEY_ROLE_VALUES = Object.values(GlobalRole);
172
+ /**
173
+ * Разобрать csv ролей API-ключа (`ADMIN,USER`; регистр и пробелы не важны).
174
+ * Пустой список и неизвестная роль → `Error` (fail-closed, понятный текст).
175
+ * Дубликаты схлопываются с сохранением порядка.
176
+ */
177
+ export function parseApiKeyRoles(raw) {
178
+ const tokens = raw
179
+ .split(',')
180
+ .map((part) => part.trim().toUpperCase())
181
+ .filter((part) => part !== '');
182
+ if (tokens.length === 0) {
183
+ throw new Error(`[config] ${API_KEY_ROLES_ENV}: пустой список ролей; допустимо: ${API_KEY_ROLE_VALUES.join(', ')}`);
184
+ }
185
+ const roles = [];
186
+ for (const token of tokens) {
187
+ if (!API_KEY_ROLE_VALUES.includes(token)) {
188
+ throw new Error(`[config] ${API_KEY_ROLES_ENV}: неизвестная роль "${token}"; ` +
189
+ `допустимо: ${API_KEY_ROLE_VALUES.join(', ')}`);
190
+ }
191
+ const role = token;
192
+ if (!roles.includes(role))
193
+ roles.push(role);
194
+ }
195
+ return roles;
196
+ }
197
+ function applyApiKeyRolesEnvOverride(config, env) {
198
+ const raw = env[API_KEY_ROLES_ENV];
199
+ if (raw === undefined || raw === '')
200
+ return;
201
+ const roles = parseApiKeyRoles(raw);
202
+ const current = config.auth;
203
+ const auth = current !== null && typeof current === 'object' && !Array.isArray(current)
204
+ ? { ...current }
205
+ : {};
206
+ auth.apiKeyRoles = roles;
207
+ config.auth = auth;
208
+ }
143
209
  /**
144
210
  * Полное env-имя определения: `SYNTH_<SECTION>_<KEY>`. Точки в ключе означают
145
211
  * вложенность (`log.enabled` → `SYNTH_EGRESS_LOG_ENABLED`).
@@ -343,15 +409,19 @@ export const BOOTSTRAP_SERVICE_KEYS_ENV = 'SYNTH_BOOTSTRAP_SERVICE_KEYS';
343
409
  export const OAUTH_PROVIDERS_ENV = 'SYNTH_OAUTH_PROVIDERS';
344
410
  /**
345
411
  * Применяет объектные env-оверрайды, у которых нет плоского строкового
346
- * представления (сейчас — `security.bootstrapServiceKeys`). Значение парсится
347
- * как JSON и валидируется схемой; при ошибке парсинга/валидации — warn в console
348
- * и игнор (fail-soft: кривой installer-ключ не должен ронять старт инстанса —
349
- * ensure-логика приложения просто ничего не бутстрапит, оператор видит warn).
412
+ * представления (`auth.apiKeyRoles`, `attachments.modalities`, `oauth.providers`,
413
+ * `security.bootstrapServiceKeys`). Нескалярные значения парсятся здесь;
414
+ * `security.bootstrapServiceKeys` — JSON, валидируется схемой, при ошибке
415
+ * парсинга/валидации warn в console и игнор (fail-soft: кривой installer-ключ не
416
+ * должен ронять старт инстанса — ensure-логика приложения просто ничего не
417
+ * бутстрапит, оператор видит warn). Исключение — `auth.apiKeyRoles`: там
418
+ * неизвестная роль бросает `Error` (fail-closed, права доступа).
350
419
  *
351
420
  * Мутирует переданный объект (в `loadConfig` — свежий результат `deepMerge`) и
352
421
  * возвращает его; секция `security` клонируется, чтобы не мутировать `defaultConfig`.
353
422
  */
354
423
  export function applyObjectEnvOverrides(config, env = process.env) {
424
+ applyApiKeyRolesEnvOverride(config, env);
355
425
  applyAttachmentsModalitiesEnvOverride(config, env);
356
426
  applyOAuthProvidersEnvOverride(config, env);
357
427
  const raw = env[BOOTSTRAP_SERVICE_KEYS_ENV];
@@ -4,6 +4,7 @@ export * from './loader.js';
4
4
  export * from './env-overrides.js';
5
5
  export * from './merge.js';
6
6
  export * from './resolve.js';
7
+ export * from './redact.js';
7
8
  export * from './execution.js';
8
9
  export * from './tls.js';
9
10
  export * from './tls-runtime.js';
@@ -4,6 +4,7 @@ export * from './loader.js';
4
4
  export * from './env-overrides.js';
5
5
  export * from './merge.js';
6
6
  export * from './resolve.js';
7
+ export * from './redact.js';
7
8
  export * from './execution.js';
8
9
  export * from './tls.js';
9
10
  export * from './tls-runtime.js';
@@ -6,5 +6,13 @@ export interface LoadConfigOptions {
6
6
  overrides?: Partial<SynthConfig>;
7
7
  /** ADR-023: источник env для оверрайдов; по умолчанию `process.env` (в тестах — свой env). */
8
8
  env?: NodeJS.ProcessEnv;
9
+ /**
10
+ * Дефолты профиля (например, backend/managed): глубокий мёрж **после**
11
+ * общего `defaultConfig` и **до** `config.yaml`/env/CLI. Позволяет профилю
12
+ * поднять дефолт (`llmGateway.enabled: true`), не перебивая явную
13
+ * конфигурацию (приоритет: CLI > env > config.yaml > профиль-дефолт >
14
+ * общий дефолт).
15
+ */
16
+ baseDefaults?: Record<string, unknown>;
9
17
  }
10
18
  export declare function loadConfig(options?: LoadConfigOptions): Promise<SynthConfig>;
@@ -74,7 +74,12 @@ export async function loadConfig(options = {}) {
74
74
  }
75
75
  }
76
76
  warnLegacyKeys(fileConfig, options.env ?? process.env);
77
- const merged = deepMerge(defaultConfig, fileConfig);
77
+ // Профильные дефолты (backend/managed) — выше общего `defaultConfig`, но ниже
78
+ // `config.yaml`/env/CLI: явная настройка всегда перебивает профиль.
79
+ const withBaseDefaults = options.baseDefaults
80
+ ? deepMerge(defaultConfig, options.baseDefaults)
81
+ : defaultConfig;
82
+ const merged = deepMerge(withBaseDefaults, fileConfig);
78
83
  // ADR-023: env-оверрайды скалярных ключей вложенных секций применяются одним
79
84
  // местом — поверх defaults + config.yaml и ниже CLI-overrides
80
85
  // (приоритет: CLI > env > config.yaml > defaults).
@@ -0,0 +1,22 @@
1
+ /**
2
+ * Редактирование секретов в дампе конфигурации (`synth config show`).
3
+ *
4
+ * `SynthConfig` может содержать значения секретов (`core.apiKey`,
5
+ * `security.secretKey`, `remote.auth.apiKey`, `auth.oidc.clientSecret`,
6
+ * `storage.postgres.password` и т.п.). Печатать такой дамп целиком нельзя:
7
+ * это утечка в журнал/терминал/CI. Хелпер возвращает **глубокую копию** с
8
+ * замаскированными непустыми значениями секретных ключей — исходный объект не
9
+ * мутируется.
10
+ *
11
+ * Маскируются только ключи с **точным** (case-insensitive) именем из списка;
12
+ * `timeout`, `tokenizer`, `apiKeyRoles` и другие похожие по подстроке ключи
13
+ * остаются как есть. Значение-маска — строка `'***'`.
14
+ */
15
+ import type { SynthConfig } from './types.js';
16
+ /**
17
+ * Вернуть копию конфигурации с замаскированными секретами.
18
+ *
19
+ * Копирование — `structuredClone` (конфиг состоит из JSON-совместимых данных);
20
+ * fallback на JSON-клон для сред без `structuredClone`.
21
+ */
22
+ export declare function redactConfigSecrets(config: SynthConfig): SynthConfig;
@@ -0,0 +1,53 @@
1
+ /** Имена ключей, значения которых считаются секретами (без учёта регистра). */
2
+ const SECRET_KEY_NAMES = new Set([
3
+ 'apiKey',
4
+ 'tokenSecret',
5
+ 'secretKey',
6
+ 'password',
7
+ 'token',
8
+ 'clientSecret',
9
+ 'privateKey',
10
+ 'passphrase',
11
+ 'secret',
12
+ 'signingKey',
13
+ 'webhookSecret',
14
+ ].map((key) => key.toLowerCase()));
15
+ /** Строка-маска для скрытого значения. */
16
+ const MASK = '***';
17
+ /** Непустое значение (пустая строка/пробелы, null и undefined — не секрет). */
18
+ function isNonEmpty(value) {
19
+ if (value === undefined || value === null)
20
+ return false;
21
+ if (typeof value === 'string')
22
+ return value.trim().length > 0;
23
+ return true;
24
+ }
25
+ /** Рекурсивно замаскировать секретные ключи в копии значения. */
26
+ function maskSecrets(value) {
27
+ if (Array.isArray(value))
28
+ return value.map(maskSecrets);
29
+ if (value && typeof value === 'object') {
30
+ const source = value;
31
+ const result = {};
32
+ for (const [key, child] of Object.entries(source)) {
33
+ result[key] =
34
+ SECRET_KEY_NAMES.has(key.toLowerCase()) && isNonEmpty(child)
35
+ ? MASK
36
+ : maskSecrets(child);
37
+ }
38
+ return result;
39
+ }
40
+ return value;
41
+ }
42
+ /**
43
+ * Вернуть копию конфигурации с замаскированными секретами.
44
+ *
45
+ * Копирование — `structuredClone` (конфиг состоит из JSON-совместимых данных);
46
+ * fallback на JSON-клон для сред без `structuredClone`.
47
+ */
48
+ export function redactConfigSecrets(config) {
49
+ const clone = typeof structuredClone === 'function'
50
+ ? structuredClone(config)
51
+ : JSON.parse(JSON.stringify(config));
52
+ return maskSecrets(clone);
53
+ }
@@ -1,4 +1,6 @@
1
1
  import type { SecurityTlsConfig } from './types.js';
2
+ import { matchTlsHostPattern, normalizeTlsHost } from '../types/host-pattern.js';
3
+ export { matchTlsHostPattern, normalizeTlsHost };
2
4
  /** Минимальный срез конфига, достаточный резолверу (совместим с `SynthConfig`). */
3
5
  export interface TlsConfigSource {
4
6
  security?: {
@@ -119,10 +121,11 @@ export declare function resolveTlsProfiles(config: TlsConfigSource | undefined,
119
121
  * маппингов, затем профиль по умолчанию, иначе `undefined` (без клиентского серта).
120
122
  */
121
123
  export declare function selectTlsClientProfile(profiles: Pick<ResolvedTlsProfiles, 'default' | 'mappings'>, host: string | undefined): TlsClientProfile | undefined;
122
- /** Матчинг одного паттерна (`host` | `*.suffix` | `*`); регистронезависимо. */
123
- export declare function matchTlsHostPattern(pattern: string, rawHost: string): boolean;
124
- /** Нормализует host (нижний регистр, без точки в конце и скобок IPv6). */
125
- export declare function normalizeTlsHost(rawHost: string | undefined): string | undefined;
124
+ /**
125
+ * ADR-099: семантика шаблона хоста — общая (см. `types/host-pattern.ts`):
126
+ * `normalizeTlsHost`/`matchTlsHostPattern` переиспользуются оттуда, второй
127
+ * матчер в подсистемах не заводится.
128
+ */
126
129
  /**
127
130
  * Эффективное доверие с прочитанным CA. Fail-closed: `caFile` задан, но файл
128
131
  * отсутствует/не читается/не PEM → внятная ошибка (никакого тихого фоллбэка на
@@ -11,6 +11,11 @@
11
11
  */
12
12
  import { readFileSync } from 'node:fs';
13
13
  import { isIP } from 'node:net';
14
+ // ADR-099: семантика шаблона хоста — общая для всех подсистем (TLS, egress,
15
+ // SSH-политика PROP-124). Реализация живёт в browser-safe модуле
16
+ // `types/host-pattern.ts` (его читает и UI) — второй матчер не заводим.
17
+ import { matchTlsHostPattern, normalizeTlsHost } from '../types/host-pattern.js';
18
+ export { matchTlsHostPattern, normalizeTlsHost };
14
19
  /** Env-имена секции `security.tls` (ADR-023). */
15
20
  export const TLS_ENV = {
16
21
  caFile: 'SYNTH_TLS_CA_FILE',
@@ -155,29 +160,11 @@ export function selectTlsClientProfile(profiles, host) {
155
160
  }
156
161
  return profiles.default;
157
162
  }
158
- /** Матчинг одного паттерна (`host` | `*.suffix` | `*`); регистронезависимо. */
159
- export function matchTlsHostPattern(pattern, rawHost) {
160
- const host = normalizeTlsHost(rawHost);
161
- if (host === undefined)
162
- return false;
163
- const value = pattern.trim().toLowerCase().replace(/\.$/, '');
164
- if (value === '*')
165
- return true;
166
- if (value.startsWith('*.')) {
167
- const suffix = value.slice(2);
168
- return suffix !== '' && host.endsWith(`.${suffix}`);
169
- }
170
- return host === value;
171
- }
172
- /** Нормализует host (нижний регистр, без точки в конце и скобок IPv6). */
173
- export function normalizeTlsHost(rawHost) {
174
- if (typeof rawHost !== 'string')
175
- return undefined;
176
- let host = rawHost.trim().toLowerCase().replace(/\.$/, '');
177
- if (host.startsWith('[') && host.endsWith(']'))
178
- host = host.slice(1, -1);
179
- return host === '' ? undefined : host;
180
- }
163
+ /**
164
+ * ADR-099: семантика шаблона хоста — общая (см. `types/host-pattern.ts`):
165
+ * `normalizeTlsHost`/`matchTlsHostPattern` переиспользуются оттуда, второй
166
+ * матчер в подсистемах не заводится.
167
+ */
181
168
  /**
182
169
  * Эффективное доверие с прочитанным CA. Fail-closed: `caFile` задан, но файл
183
170
  * отсутствует/не читается/не PEM → внятная ошибка (никакого тихого фоллбэка на