@itphx/synth-shared 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.
- package/dist/config/defaults.js +60 -14
- package/dist/config/env-overrides.d.ts +7 -4
- package/dist/config/env-overrides.js +46 -13
- package/dist/config/index.d.ts +3 -0
- package/dist/config/index.js +3 -0
- package/dist/config/loader.d.ts +2 -2
- package/dist/config/loader.js +23 -4
- package/dist/config/proxy.d.ts +415 -0
- package/dist/config/proxy.js +1565 -0
- package/dist/config/resolve.d.ts +77 -10
- package/dist/config/resolve.js +203 -17
- package/dist/config/tls-runtime.d.ts +78 -0
- package/dist/config/tls-runtime.js +356 -0
- package/dist/config/tls.d.ts +215 -0
- package/dist/config/tls.js +394 -0
- package/dist/config/types.d.ts +1820 -334
- package/dist/config/types.js +320 -54
- package/dist/i18n/index.d.ts +1 -1
- package/dist/i18n/index.js +18 -10
- package/dist/index.d.ts +11 -2
- package/dist/index.js +11 -2
- package/dist/interfaces/index.d.ts +3 -3
- package/dist/protocols/index.d.ts +0 -1
- package/dist/schemas/index.d.ts +230 -105
- package/dist/schemas/index.js +121 -74
- package/dist/skills/frontmatter.js +1 -1
- package/dist/types/agent.d.ts +30 -0
- package/dist/types/agent.js +1 -0
- package/dist/types/analytics.d.ts +113 -0
- package/dist/types/analytics.js +61 -0
- package/dist/types/bus-events.d.ts +7 -0
- package/dist/types/bus-events.js +1 -0
- package/dist/types/commands.d.ts +10 -10
- package/dist/types/commands.js +2 -2
- package/dist/types/decision.d.ts +16 -16
- package/dist/types/decision.js +4 -4
- package/dist/types/egress.d.ts +114 -0
- package/dist/types/egress.js +68 -0
- package/dist/types/events.d.ts +22 -23
- package/dist/types/fs.d.ts +55 -0
- package/dist/types/fs.js +27 -0
- package/dist/types/git.d.ts +63 -0
- package/dist/types/git.js +1 -0
- package/dist/types/hooks.d.ts +24 -4
- package/dist/types/index.d.ts +15 -1165
- package/dist/types/index.js +44 -244
- package/dist/types/llm.d.ts +32 -0
- package/dist/types/llm.js +8 -0
- package/dist/types/maintenance.d.ts +39 -0
- package/dist/types/maintenance.js +11 -0
- package/dist/types/mcp.d.ts +169 -0
- package/dist/types/mcp.js +119 -0
- package/dist/types/message.d.ts +63 -0
- package/dist/types/message.js +12 -0
- package/dist/types/permission.d.ts +9 -7
- package/dist/types/permission.js +1 -1
- package/dist/types/project.d.ts +134 -0
- package/dist/types/project.js +67 -0
- package/dist/types/prompt.d.ts +237 -0
- package/dist/types/prompt.js +15 -0
- package/dist/types/provider.d.ts +84 -0
- package/dist/types/provider.js +35 -0
- package/dist/types/schedules.d.ts +8 -8
- package/dist/types/schedules.js +1 -1
- package/dist/types/service-keys.d.ts +10 -10
- package/dist/types/service-keys.js +3 -3
- package/dist/types/session.d.ts +268 -0
- package/dist/types/session.js +13 -0
- package/dist/types/skills.d.ts +11 -11
- package/dist/types/skills.js +6 -6
- package/dist/types/tools.d.ts +3 -3
- package/dist/types/user.d.ts +113 -0
- package/dist/types/user.js +31 -0
- package/dist/types/webhooks.d.ts +6 -6
- package/dist/types/webhooks.js +1 -1
- package/dist/utils/glob.d.ts +1 -1
- package/dist/utils/glob.js +1 -1
- package/dist/utils/index.d.ts +15 -0
- package/dist/utils/index.js +55 -2
- package/dist/utils/workspace.js +1 -1
- package/dist/version.d.ts +1 -1
- package/dist/version.js +1 -1
- package/package.json +1 -1
|
@@ -0,0 +1,415 @@
|
|
|
1
|
+
import type { ProxyConfig, ProxyMode } from './types.js';
|
|
2
|
+
/** Env-имена секции `proxy` (ADR-023). */
|
|
3
|
+
export declare const PROXY_ENV: {
|
|
4
|
+
readonly enabled: "SYNTH_PROXY_ENABLED";
|
|
5
|
+
readonly url: "SYNTH_PROXY_URL";
|
|
6
|
+
readonly httpProxy: "SYNTH_PROXY_HTTP_PROXY";
|
|
7
|
+
readonly httpsProxy: "SYNTH_PROXY_HTTPS_PROXY";
|
|
8
|
+
readonly allProxy: "SYNTH_PROXY_ALL_PROXY";
|
|
9
|
+
readonly noProxy: "SYNTH_PROXY_NO_PROXY";
|
|
10
|
+
readonly fallbackDirect: "SYNTH_PROXY_FALLBACK_DIRECT";
|
|
11
|
+
readonly connectTimeoutMs: "SYNTH_PROXY_CONNECT_TIMEOUT_MS";
|
|
12
|
+
};
|
|
13
|
+
/**
|
|
14
|
+
* Пароль Basic-аутентификации прокси: **только** env или файл
|
|
15
|
+
* `{dataDir}/secrets/proxy-password` (в config.yaml не хранится — инвариант 13).
|
|
16
|
+
*/
|
|
17
|
+
export declare const PROXY_PASSWORD_ENV = "SYNTH_PROXY_PASSWORD";
|
|
18
|
+
/** Env-имена секции `proxy.tls` (TLS/mTLS к прокси, ADR-023). */
|
|
19
|
+
export declare const PROXY_TLS_ENV: {
|
|
20
|
+
readonly caFile: "SYNTH_PROXY_TLS_CA_FILE";
|
|
21
|
+
readonly caPem: "SYNTH_PROXY_TLS_CA_PEM";
|
|
22
|
+
readonly certFile: "SYNTH_PROXY_TLS_CERT_FILE";
|
|
23
|
+
readonly keyFile: "SYNTH_PROXY_TLS_KEY_FILE";
|
|
24
|
+
readonly rejectUnauthorized: "SYNTH_PROXY_TLS_REJECT_UNAUTHORIZED";
|
|
25
|
+
};
|
|
26
|
+
/** Поля URL прокси (для per-field кредов). */
|
|
27
|
+
export declare const PROXY_URL_FIELDS: readonly ["url", "httpProxy", "httpsProxy", "allProxy"];
|
|
28
|
+
export type ProxyUrlField = (typeof PROXY_URL_FIELDS)[number];
|
|
29
|
+
/** Стандартные env-имена прокси (учитываются только при `fromEnv`). */
|
|
30
|
+
export declare const STANDARD_PROXY_ENV: {
|
|
31
|
+
readonly httpProxy: readonly ["HTTP_PROXY", "http_proxy"];
|
|
32
|
+
readonly httpsProxy: readonly ["HTTPS_PROXY", "https_proxy"];
|
|
33
|
+
readonly allProxy: readonly ["ALL_PROXY", "all_proxy"];
|
|
34
|
+
readonly noProxy: readonly ["NO_PROXY", "no_proxy"];
|
|
35
|
+
};
|
|
36
|
+
/** Ошибка конфигурации прокси (fail-closed, код для API/логов). */
|
|
37
|
+
export declare class ProxyConfigError extends Error {
|
|
38
|
+
readonly code = "EGRESS_PROXY_CONFIG_INVALID";
|
|
39
|
+
constructor(message: string);
|
|
40
|
+
}
|
|
41
|
+
/** Минимальный срез конфига, достаточный резолверу (совместим с `SynthConfig`). */
|
|
42
|
+
export interface ProxyConfigSource {
|
|
43
|
+
/** Частичная секция (совместима с `SynthConfig['proxy']`; литералы тестов — тоже). */
|
|
44
|
+
proxy?: Partial<ProxyConfig> | undefined;
|
|
45
|
+
}
|
|
46
|
+
/** Откуда взято эффективное значение (`runtime` — UI-override, `env` — `SYNTH_PROXY_*`). */
|
|
47
|
+
export type ProxyConfigOrigin = 'env' | 'runtime' | 'config';
|
|
48
|
+
/** Креды Basic-аутентификации прокси (в памяти; наружу не отдаются). */
|
|
49
|
+
export interface ProxyCredentials {
|
|
50
|
+
username: string;
|
|
51
|
+
password: string;
|
|
52
|
+
}
|
|
53
|
+
/** Креды по полям URL (userinfo URL либо `proxy.auth` + env/файл-пароль). */
|
|
54
|
+
export type ProxyCredentialSet = Partial<Record<ProxyUrlField, ProxyCredentials>>;
|
|
55
|
+
/** Эффективный TLS/mTLS к самому прокси (CA/серт/ключ уже прочитаны). */
|
|
56
|
+
export interface ResolvedProxyTls {
|
|
57
|
+
ca?: string;
|
|
58
|
+
cert?: string;
|
|
59
|
+
key?: string;
|
|
60
|
+
rejectUnauthorized: boolean;
|
|
61
|
+
}
|
|
62
|
+
/** Эффективный именованный профиль прокси (URL без userinfo, креды — отдельно). */
|
|
63
|
+
export interface ResolvedProxyProfile {
|
|
64
|
+
name: string;
|
|
65
|
+
label?: string;
|
|
66
|
+
/** URL без userinfo (для логов/статуса/ProxyAgent `uri`). */
|
|
67
|
+
url?: string;
|
|
68
|
+
httpProxy?: string;
|
|
69
|
+
httpsProxy?: string;
|
|
70
|
+
allProxy?: string;
|
|
71
|
+
/** Креды Basic по URL-полям (только если заданы; наружу не отдаются). */
|
|
72
|
+
credentials?: ProxyCredentialSet;
|
|
73
|
+
/** Redacted-сведения об аутентификации (username, без пароля). */
|
|
74
|
+
auth?: ProxyStatusAuth;
|
|
75
|
+
/** TLS/mTLS к прокси (`ProxyAgent.proxyTls`); цель — `security.tls`. */
|
|
76
|
+
tls?: ResolvedProxyTls;
|
|
77
|
+
/** Метаданные TLS-файлов для статуса/UI (пути, флаг `caPem`; без содержимого). */
|
|
78
|
+
tlsMeta?: ProxyStatusTlsMeta;
|
|
79
|
+
/** Источник: `env`/`runtime` — legacy-default; профили — config/runtime. */
|
|
80
|
+
source: ProxyConfigOrigin;
|
|
81
|
+
/** `true` — синтетический legacy-профиль `default` (top-level URL/auth/tls). */
|
|
82
|
+
legacy: boolean;
|
|
83
|
+
}
|
|
84
|
+
/** Действие правила маршрутизации прокси. */
|
|
85
|
+
export type ProxyRuleAction = 'proxy' | 'direct';
|
|
86
|
+
/** Правило маршрутизации прокси с нормализованными хостами. */
|
|
87
|
+
export interface ResolvedProxyRule {
|
|
88
|
+
/** `id` из конфига либо сгенерированный `rule-<n>`. */
|
|
89
|
+
id: string;
|
|
90
|
+
label?: string;
|
|
91
|
+
hosts: string[];
|
|
92
|
+
action: ProxyRuleAction;
|
|
93
|
+
/** Эффективный профиль (`rule.profile` либо `defaultProfile`). */
|
|
94
|
+
profile?: string;
|
|
95
|
+
}
|
|
96
|
+
/** Эффективная конфигурация прокси (после слияния env/runtime/config/defaults). */
|
|
97
|
+
export interface ResolvedProxyConfig {
|
|
98
|
+
enabled: boolean;
|
|
99
|
+
/** Источник эффективного прокси-URL: `env` | `runtime` | `config`; `none` — прокси выключен. */
|
|
100
|
+
source: 'env' | 'runtime' | 'config' | 'none';
|
|
101
|
+
/** Режим маршрутизации (`all` — default для всех, `selected` — только правила). */
|
|
102
|
+
mode: ProxyMode;
|
|
103
|
+
/** Профиль по умолчанию (для `mode: all` и правил без `profile`). */
|
|
104
|
+
defaultProfile?: string;
|
|
105
|
+
/** Именованные профили (в legacy-режиме — синтетический `default`). */
|
|
106
|
+
profiles: Record<string, ResolvedProxyProfile>;
|
|
107
|
+
/** Правила маршрутизации (порядок = приоритет). */
|
|
108
|
+
rules: ResolvedProxyRule[];
|
|
109
|
+
/** URL без userinfo (legacy-поля; в режиме профилей не заполняются). */
|
|
110
|
+
url?: string;
|
|
111
|
+
httpProxy?: string;
|
|
112
|
+
httpsProxy?: string;
|
|
113
|
+
allProxy?: string;
|
|
114
|
+
/** Креды Basic по полям (только если заданы). */
|
|
115
|
+
credentials?: ProxyCredentialSet;
|
|
116
|
+
/** Redacted-сведения об аутентификации (username, без пароля). */
|
|
117
|
+
auth?: ProxyStatusAuth;
|
|
118
|
+
/** TLS/mTLS к прокси (`ProxyAgent.proxyTls`); цель — `security.tls`. */
|
|
119
|
+
tls?: ResolvedProxyTls;
|
|
120
|
+
/** Метаданные TLS-файлов для статуса/UI (пути, флаг `caPem`; без содержимого). */
|
|
121
|
+
tlsMeta?: ProxyStatusTlsMeta;
|
|
122
|
+
noProxy: string[];
|
|
123
|
+
fromEnv: boolean;
|
|
124
|
+
/** Явный opt-in: при недоступном прокси идти напрямую (warn + via:'fallback'). */
|
|
125
|
+
fallbackDirect: boolean;
|
|
126
|
+
connectTimeoutMs: number;
|
|
127
|
+
}
|
|
128
|
+
/** Причина решения `resolveProxyRoute` (для логов/UI). */
|
|
129
|
+
export type ProxyRouteReason = 'disabled' | 'no-proxy' | 'rule' | 'default' | 'no-match' | 'no-default';
|
|
130
|
+
/** Решение маршрутизации для target-origin (единая точка для dispatcher/API-check). */
|
|
131
|
+
export interface ResolvedProxyRoute {
|
|
132
|
+
action: ProxyRuleAction;
|
|
133
|
+
reason: ProxyRouteReason;
|
|
134
|
+
/** Сработавшее правило (только `reason: 'rule'`). */
|
|
135
|
+
rule?: ResolvedProxyRule;
|
|
136
|
+
/** Эффективный профиль (только `action: 'proxy'`). */
|
|
137
|
+
profile?: string;
|
|
138
|
+
/** URL прокси без userinfo. */
|
|
139
|
+
proxyUrl?: string;
|
|
140
|
+
/** Креды Basic выбранного URL (только в памяти). */
|
|
141
|
+
credentials?: ProxyCredentials;
|
|
142
|
+
}
|
|
143
|
+
/** Безопасные сведения об аутентификации прокси для статуса/UI (без пароля). */
|
|
144
|
+
export interface ProxyStatusAuth {
|
|
145
|
+
type: 'basic';
|
|
146
|
+
username: string;
|
|
147
|
+
}
|
|
148
|
+
/** Метаданные TLS к прокси для статуса/UI (без PEM-содержимого). */
|
|
149
|
+
export interface ProxyStatusTlsMeta {
|
|
150
|
+
caFile?: string;
|
|
151
|
+
certFile?: string;
|
|
152
|
+
keyFile?: string;
|
|
153
|
+
/** `true` — CA задан через `caPem` (сам PEM наружу не отдаётся). */
|
|
154
|
+
hasCaPem: boolean;
|
|
155
|
+
}
|
|
156
|
+
/** Redacted-сведения о профиле прокси для статуса/UI (без паролей/PEM/userinfo). */
|
|
157
|
+
export interface ProxyStatusProfile {
|
|
158
|
+
name: string;
|
|
159
|
+
label?: string;
|
|
160
|
+
url?: string;
|
|
161
|
+
httpProxy?: string;
|
|
162
|
+
httpsProxy?: string;
|
|
163
|
+
allProxy?: string;
|
|
164
|
+
/** Только username (пароль не отдаётся). */
|
|
165
|
+
auth?: ProxyStatusAuth;
|
|
166
|
+
/** Пути TLS-файлов и флаг `caPem`; PEM/ключи не отдаются. */
|
|
167
|
+
tls?: ProxyStatusTlsMeta & {
|
|
168
|
+
rejectUnauthorized: boolean;
|
|
169
|
+
};
|
|
170
|
+
/** `true` — синтетический legacy-профиль `default`. */
|
|
171
|
+
legacy: boolean;
|
|
172
|
+
source: ProxyConfigOrigin;
|
|
173
|
+
}
|
|
174
|
+
/** Правило маршрутизации в статусе (без секретов). */
|
|
175
|
+
export interface ProxyStatusRule {
|
|
176
|
+
id: string;
|
|
177
|
+
label?: string;
|
|
178
|
+
hosts: string[];
|
|
179
|
+
action: ProxyRuleAction;
|
|
180
|
+
profile?: string;
|
|
181
|
+
}
|
|
182
|
+
/** Read-only статус прокси для `GET /api/v2/settings/proxy` (без секретов). */
|
|
183
|
+
export interface EgressProxyStatus {
|
|
184
|
+
enabled: boolean;
|
|
185
|
+
source: 'env' | 'runtime' | 'config' | 'none';
|
|
186
|
+
mode: ProxyMode;
|
|
187
|
+
defaultProfile?: string;
|
|
188
|
+
/** Профили (redacted: URL без userinfo, username, TLS-метаданные). */
|
|
189
|
+
profiles: Record<string, ProxyStatusProfile>;
|
|
190
|
+
/** Правила маршрутизации (порядок сохраняется). */
|
|
191
|
+
rules: ProxyStatusRule[];
|
|
192
|
+
url?: string;
|
|
193
|
+
httpProxy?: string;
|
|
194
|
+
httpsProxy?: string;
|
|
195
|
+
allProxy?: string;
|
|
196
|
+
noProxy: string[];
|
|
197
|
+
fromEnv: boolean;
|
|
198
|
+
fallbackDirect: boolean;
|
|
199
|
+
connectTimeoutMs: number;
|
|
200
|
+
/** Basic-аутентификация: только username (пароль не отдаётся). */
|
|
201
|
+
auth?: ProxyStatusAuth;
|
|
202
|
+
/** TLS к прокси: пути и флаг `caPem`; PEM/ключи не отдаются. */
|
|
203
|
+
tls?: ProxyStatusTlsMeta & {
|
|
204
|
+
rejectUnauthorized: boolean;
|
|
205
|
+
};
|
|
206
|
+
/** Настройка применяется при старте процесса. */
|
|
207
|
+
restartRequired: true;
|
|
208
|
+
}
|
|
209
|
+
/**
|
|
210
|
+
* Источник пароля Basic-аутентификации прокси (значение **никогда** не отдаётся).
|
|
211
|
+
* `env` — `SYNTH_PROXY_PASSWORD` (деплой, UI не может удалить); `file` —
|
|
212
|
+
* `{dataDir}/secrets/proxy-password` (управляется через API); `none` — не задан.
|
|
213
|
+
*/
|
|
214
|
+
export interface ProxyPasswordStatus {
|
|
215
|
+
source: 'env' | 'file' | 'none';
|
|
216
|
+
set: boolean;
|
|
217
|
+
/** `true` — пароль можно удалить через `DELETE /settings/proxy/password`. */
|
|
218
|
+
removable: boolean;
|
|
219
|
+
}
|
|
220
|
+
/** Схема аутентификации, запрошенная прокси (D2 — Basic/NTLM/Negotiate). */
|
|
221
|
+
export type ProxyAuthChallenge = 'Basic' | 'NTLM' | 'Negotiate' | 'none';
|
|
222
|
+
/** Результат `POST /api/v2/settings/proxy/check` (проверка только коннекта к прокси). */
|
|
223
|
+
export interface ProxyCheckResult {
|
|
224
|
+
reachable: boolean;
|
|
225
|
+
latencyMs: number;
|
|
226
|
+
error?: string;
|
|
227
|
+
authChallenge: ProxyAuthChallenge;
|
|
228
|
+
}
|
|
229
|
+
/** Разобранный и нормализованный URL прокси (userinfo — отдельно). */
|
|
230
|
+
export interface ParsedProxyUrl {
|
|
231
|
+
/** Нормализованный origin **без userinfo**: `http://host:port` / `socks5://…`. */
|
|
232
|
+
href: string;
|
|
233
|
+
/**
|
|
234
|
+
* `socks5:` / `socks5h:` — один транспорт (SOCKS5). `socks5h` — стандартное
|
|
235
|
+
* написание «DNS резолвит прокси»; `socks5` — совместимость с libcurl-стилем.
|
|
236
|
+
* В текущей реализации undici (`Socks5ProxyAgent`) hostname цели уходит в
|
|
237
|
+
* SOCKS-CONNECT для **обеих** схем, т.е. фактически резолвит прокси; отдельного
|
|
238
|
+
* локального DNS-резолва клиентом нет.
|
|
239
|
+
*/
|
|
240
|
+
protocol: 'http:' | 'https:' | 'socks5:' | 'socks5h:';
|
|
241
|
+
hostname: string;
|
|
242
|
+
port: number;
|
|
243
|
+
username?: string;
|
|
244
|
+
password?: string;
|
|
245
|
+
}
|
|
246
|
+
/** `true` — SOCKS5-прокси (D2b). */
|
|
247
|
+
export declare function isSocksProxyProtocol(protocol: string): boolean;
|
|
248
|
+
/** Пустая (не заданная) конфигурация — прокси выключен (поведение не меняется). */
|
|
249
|
+
export declare function emptyResolvedProxyConfig(): ResolvedProxyConfig;
|
|
250
|
+
/**
|
|
251
|
+
* Разбирает URL прокси: `http`, `https`, `socks5`, `socks5h` (D2b).
|
|
252
|
+
* Userinfo (`user:pass@host`) разрешён: креды извлекаются отдельно (для SOCKS5 —
|
|
253
|
+
* RFC 1929 user/pass), `href` всегда без userinfo (безопасен для логов/статуса).
|
|
254
|
+
* `password` без `username` — ошибка; отсутствие пароля при наличии username
|
|
255
|
+
* решает резолвер (env/файл).
|
|
256
|
+
*
|
|
257
|
+
* `socks5h://` — hostname цели резолвит прокси; `socks5://` — клиент (поведение
|
|
258
|
+
* зависит от клиента, undici передаёт hostname в SOCKS CONNECT).
|
|
259
|
+
*/
|
|
260
|
+
export declare function parseProxyUrl(raw: string): ParsedProxyUrl;
|
|
261
|
+
/**
|
|
262
|
+
* Безопасное представление URL прокси для логов/API: без userinfo, path/query/hash.
|
|
263
|
+
* Невалидный URL → пустая строка (не эхоим потенциальный секрет).
|
|
264
|
+
*/
|
|
265
|
+
export declare function redactProxyUrl(raw: string | undefined): string;
|
|
266
|
+
/**
|
|
267
|
+
* Матчер `noProxy` (без regex): `host`, `.suffix`, `*.suffix`, `host:port`,
|
|
268
|
+
* IPv4/IPv6-литерал, CIDR, `*` (всё напрямую).
|
|
269
|
+
*
|
|
270
|
+
* - `example.com` — точное совпадение;
|
|
271
|
+
* - `.example.com` — сам домен и поддомены;
|
|
272
|
+
* - `*.example.com` — только поддомены;
|
|
273
|
+
* - `example.com:8443` — точный host+port;
|
|
274
|
+
* - `10.0.0.0/8` — только IP-литералы хоста (DNS не выполняется);
|
|
275
|
+
* - `*` — прокси не используется ни для одного хоста.
|
|
276
|
+
*/
|
|
277
|
+
export declare class NoProxyMatcher {
|
|
278
|
+
private readonly _all;
|
|
279
|
+
private readonly _hosts;
|
|
280
|
+
private readonly _suffixes;
|
|
281
|
+
private readonly _wildcards;
|
|
282
|
+
private readonly _hostPorts;
|
|
283
|
+
private readonly _ips;
|
|
284
|
+
private readonly _cidrs;
|
|
285
|
+
private readonly _hasCidr;
|
|
286
|
+
constructor(entries: readonly string[] | undefined);
|
|
287
|
+
/** `true` — хост исключён из прокси (идём напрямую). */
|
|
288
|
+
matches(rawHost: string, port?: number | string): boolean;
|
|
289
|
+
}
|
|
290
|
+
/**
|
|
291
|
+
* Валидирует host-паттерны правил прокси (`proxy.rules[].hosts`).
|
|
292
|
+
* Возвращает нормализованные значения (trim/lower-case/без завершающей точки).
|
|
293
|
+
*
|
|
294
|
+
* Допустимо: exact (`api.example.com`), `.suffix` (apex+sub), `*.suffix` (sub),
|
|
295
|
+
* `host:port`, IPv4/IPv6-литерал (в т.ч. `[::1]:8080`), CIDR (только по IP-литералу
|
|
296
|
+
* цели — DNS не выполняется), `*`.
|
|
297
|
+
*
|
|
298
|
+
* **Fail-closed**: невалидный паттерн — `ProxyConfigError` (а не тихий игнор),
|
|
299
|
+
* иначе опечатка в правиле молча меняет маршрут (прокси ↔ direct).
|
|
300
|
+
*/
|
|
301
|
+
export declare function validateProxyHostPatterns(entries: readonly string[], context?: string): string[];
|
|
302
|
+
/** Env-имя пароля профиля: `default` — legacy `SYNTH_PROXY_PASSWORD`. */
|
|
303
|
+
export declare function proxyProfilePasswordEnv(name: string): string;
|
|
304
|
+
/**
|
|
305
|
+
* Путь файла пароля профиля: `default` — legacy `{dataDir}/secrets/proxy-password`,
|
|
306
|
+
* прочие — `{dataDir}/secrets/proxy/<profile>.password`.
|
|
307
|
+
*/
|
|
308
|
+
export declare function proxyProfilePasswordPath(dataDir: string, name: string): string;
|
|
309
|
+
/** Читает файл пароля по точному пути; ENOENT → `undefined` (пароля нет). */
|
|
310
|
+
export declare function readProxyPasswordFile(path: string): string | undefined;
|
|
311
|
+
/**
|
|
312
|
+
* Эффективный TLS/mTLS к **самому прокси** (`proxy.tls`, ADR-023).
|
|
313
|
+
* Схема — как `security.tls`: env `SYNTH_PROXY_TLS_*` > config.yaml > defaults;
|
|
314
|
+
* `caFile` ↔ `caPem` взаимоисключающие; `certFile`/`keyFile` — только вместе;
|
|
315
|
+
* нечитаемый/не-PEM файл → fail-closed.
|
|
316
|
+
*/
|
|
317
|
+
export declare function resolveProxyTls(config: ProxyConfigSource | undefined, env?: NodeJS.ProcessEnv): ResolvedProxyTls;
|
|
318
|
+
/**
|
|
319
|
+
* Метаданные TLS к прокси для статуса/UI: пути файлов и флаг `caPem`.
|
|
320
|
+
* Приоритет env `SYNTH_PROXY_TLS_*` > эффективный config/runtime. Содержимое
|
|
321
|
+
* PEM/ключа **не** возвращается.
|
|
322
|
+
*/
|
|
323
|
+
export declare function resolveProxyTlsMeta(config: ProxyConfigSource | undefined, env?: NodeJS.ProcessEnv): ProxyStatusTlsMeta;
|
|
324
|
+
/** Опции резолвера `proxy`: каталог данных и runtime-override из UI/`settings.json`. */
|
|
325
|
+
export interface ResolveProxyConfigOptions {
|
|
326
|
+
/** Каталог данных — файл `{dataDir}/secrets/proxy-password` (инвариант 13). */
|
|
327
|
+
dataDir?: string;
|
|
328
|
+
/**
|
|
329
|
+
* Runtime-override (`RuntimeSettings.proxy`, `{dataDir}/settings.json`/PG).
|
|
330
|
+
* Приоритет: `config.yaml` ← runtime ← явные `SYNTH_PROXY_*` (ADR-023).
|
|
331
|
+
*/
|
|
332
|
+
runtime?: Partial<ProxyConfig> | undefined;
|
|
333
|
+
}
|
|
334
|
+
/**
|
|
335
|
+
* Поле-уровневое слияние `config.yaml proxy` и runtime-override (UI).
|
|
336
|
+
* Runtime приоритетнее; пустая строка трактуется как «не задано» (как в config).
|
|
337
|
+
* Вложенные `auth`/`tls` мёржатся по полям.
|
|
338
|
+
*
|
|
339
|
+
* Источник конфигурации всегда один (иначе `resolveProxyConfig` бросает «два
|
|
340
|
+
* источника»): `profiles` и legacy top-level (`url`/`httpProxy`/`httpsProxy`/
|
|
341
|
+
* `allProxy`/`auth`/`tls`) не смешиваются между base и runtime.
|
|
342
|
+
* - runtime с **непустыми** `profiles` — режим профилей: `profiles` из runtime,
|
|
343
|
+
* legacy top-level base игнорируется (свои top-level runtime-объекта остаются —
|
|
344
|
+
* их отклонит валидация);
|
|
345
|
+
* - runtime без `profiles`, но с legacy top-level — переключение на legacy:
|
|
346
|
+
* `profiles` base не берутся, `rules`/`defaultProfile`/`mode` base тоже (они
|
|
347
|
+
* относятся к исчезнувшей профильной конфигурации: правила и `defaultProfile`
|
|
348
|
+
* ссылаются на профили, а `mode: selected` остаётся без правил); свои значения
|
|
349
|
+
* runtime сохраняются;
|
|
350
|
+
* - runtime только с `rules`/`mode`/`defaultProfile` — `profiles` base сохраняются.
|
|
351
|
+
*/
|
|
352
|
+
export declare function mergeProxyConfig(base: Partial<ProxyConfig> | undefined, runtime: Partial<ProxyConfig> | undefined): Partial<ProxyConfig>;
|
|
353
|
+
/**
|
|
354
|
+
* Сливает env, runtime и config.yaml для секции `proxy` (ADR-023).
|
|
355
|
+
*
|
|
356
|
+
* Приоритет: явные `SYNTH_PROXY_*` > runtime (`settings.json`, UI) > `config.proxy`
|
|
357
|
+
* > стандартные env (при `fromEnv`) > defaults. Стандартные `HTTP_PROXY`/… не
|
|
358
|
+
* применяются, если runtime/config явно задали `enabled: false`.
|
|
359
|
+
*
|
|
360
|
+
* `options.dataDir` нужен только для файла пароля
|
|
361
|
+
* `{dataDir}/secrets/proxy-password` (инвариант 13).
|
|
362
|
+
*/
|
|
363
|
+
export declare function resolveProxyConfig(config: ProxyConfigSource | undefined, env?: NodeJS.ProcessEnv, options?: ResolveProxyConfigOptions): ResolvedProxyConfig;
|
|
364
|
+
/**
|
|
365
|
+
* Валидация входной секции `proxy` для сохранения runtime-override через API.
|
|
366
|
+
*
|
|
367
|
+
* Схема (`proxyConfigSchema`) + полный резолв (URL/схемы, `noProxy`, только
|
|
368
|
+
* `auth.type=basic`, `tls` caFile↔caPem, cert+key, пароль из env/файла).
|
|
369
|
+
* Дополнительно **запрещает пароль в userinfo URL** и **пароль в теле запроса**
|
|
370
|
+
* (`auth.password`) — в `settings.json`/PG секреты не хранятся (инвариант 13),
|
|
371
|
+
* пароль задаётся отдельным endpoint'ом.
|
|
372
|
+
* `SYNTH_PROXY_*`/стандартные env намеренно игнорируются, чтобы валидировать
|
|
373
|
+
* именно сохраняемый объект (пароль из `SYNTH_PROXY_PASSWORD`/файла остаётся).
|
|
374
|
+
*/
|
|
375
|
+
export declare function validateProxyConfig(input: unknown, env?: NodeJS.ProcessEnv, options?: {
|
|
376
|
+
dataDir?: string;
|
|
377
|
+
}): ProxyConfig;
|
|
378
|
+
/**
|
|
379
|
+
* Единая точка маршрутизации прокси для target-origin (ADR-099).
|
|
380
|
+
*
|
|
381
|
+
* Порядок: `enabled:false` → всё direct; `noProxy` **всегда выигрывает**;
|
|
382
|
+
* правила (первое совпадение); затем default (`mode: all`) либо `no-match`
|
|
383
|
+
* (`mode: selected`). `action: proxy` берёт `rule.profile ?? defaultProfile`.
|
|
384
|
+
* CIDR матчится только по IP-литералу цели (DNS не выполняется).
|
|
385
|
+
*/
|
|
386
|
+
export declare function resolveProxyRoute(config: ResolvedProxyConfig | null | undefined, origin: string | URL): ResolvedProxyRoute;
|
|
387
|
+
/**
|
|
388
|
+
* Эффективный прокси для target-origin: `{url, credentials?}` или `undefined`.
|
|
389
|
+
* Полностью выводится из `resolveProxyRoute` (профили/правила/noProxy).
|
|
390
|
+
*/
|
|
391
|
+
export declare function proxyEntryFor(config: ResolvedProxyConfig, origin: string | URL): {
|
|
392
|
+
url: string;
|
|
393
|
+
credentials?: ProxyCredentials;
|
|
394
|
+
} | undefined;
|
|
395
|
+
/**
|
|
396
|
+
* Прокси по умолчанию (для диагностики/`/settings/proxy/check`): профиль
|
|
397
|
+
* `defaultProfile` без учёта правил; порядок полей `https → all → url → http`
|
|
398
|
+
* (как legacy-поведение). `undefined` — default-профиля/URL нет.
|
|
399
|
+
*/
|
|
400
|
+
export declare function defaultProxyEntry(config: ResolvedProxyConfig): {
|
|
401
|
+
url: string;
|
|
402
|
+
credentials?: ProxyCredentials;
|
|
403
|
+
} | undefined;
|
|
404
|
+
/**
|
|
405
|
+
* URL прокси для target-origin (по маршруту: профили/правила/noProxy).
|
|
406
|
+
* `undefined` — для этой цели прокси нет (direct).
|
|
407
|
+
*/
|
|
408
|
+
export declare function proxyUrlFor(config: ResolvedProxyConfig, origin: string | URL): string | undefined;
|
|
409
|
+
/**
|
|
410
|
+
* Нужно ли направлять URL через прокси (маршрут `action: proxy`).
|
|
411
|
+
* DNS/CIDR-сверка не выполняется (только host/port цели).
|
|
412
|
+
*/
|
|
413
|
+
export declare function shouldProxyUrl(config: ResolvedProxyConfig | null | undefined, rawUrl: string): boolean;
|
|
414
|
+
/** Read-only статус прокси (без userinfo/секретов/PEM). */
|
|
415
|
+
export declare function proxyStatus(config: ResolvedProxyConfig | null | undefined): EgressProxyStatus;
|