cvc-catalog-sync-plugin 1.0.0 → 2.0.1
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/CHANGELOG.md +203 -0
- package/README.md +297 -203
- package/README.ru.md +380 -0
- package/SECURITY.md +234 -34
- package/client.js +2428 -553
- package/cordis.patch.yml +13 -8
- package/docs/ARCHITECTURE.md +965 -0
- package/docs/COMPATIBILITY.md +260 -0
- package/docs/DETAIL.md +3 -0
- package/docs/UPGRADING.md +357 -0
- package/docs/preview.svg +99 -0
- package/icon.svg +76 -8
- package/index.js +243 -1312
- package/lib/CONTRACT.js +63 -0
- package/lib/balance.js +412 -0
- package/lib/cache.js +114 -0
- package/lib/catalog-build.js +391 -0
- package/lib/catalog-sync.js +856 -0
- package/lib/coefficients.js +308 -0
- package/lib/config.js +558 -0
- package/lib/cvc-api.js +372 -0
- package/lib/http.js +269 -0
- package/lib/providers.js +210 -0
- package/lib/state.js +233 -0
- package/locale/en.json +4 -3
- package/locale/ru.json +4 -3
- package/package.json +32 -10
package/lib/config.js
ADDED
|
@@ -0,0 +1,558 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Схема конфигурации плагина и мост из формата 1.x в 2.x.
|
|
3
|
+
*
|
|
4
|
+
* Схема — единственный источник правды о значениях по умолчанию: страница
|
|
5
|
+
* настроек, `GET /cvc/state` и рантайм читают один и тот же объект. Все поля
|
|
6
|
+
* объявлены `.volatile()`: правка строки патча применяется на лету, без
|
|
7
|
+
* перезапуска плагина (проверено на DSH 0.2.2-rc.5: правка volatile-полей
|
|
8
|
+
* приходит событием `loader/volatile-update`, `apply` повторно не вызывается).
|
|
9
|
+
*
|
|
10
|
+
* Плоский конфиг 1.0.0 остаётся в схеме необязательными устаревшими полями и
|
|
11
|
+
* нормализуется в группы 2.x, чтобы обновление плагина не требовало ручной
|
|
12
|
+
* правки патча.
|
|
13
|
+
*
|
|
14
|
+
* @module cvc-catalog-sync-plugin/lib/config
|
|
15
|
+
*/
|
|
16
|
+
import z from '@deepseek-ai/schemastery'
|
|
17
|
+
|
|
18
|
+
/** Ключи переключателей функций — порядок важен для интерфейса. */
|
|
19
|
+
export const FEATURE_KEYS = Object.freeze(['catalogSync', 'coefficients', 'balance'])
|
|
20
|
+
|
|
21
|
+
/** Группы конфигурации 2.x. */
|
|
22
|
+
export const CONFIG_GROUPS = Object.freeze(['features', 'providers', 'catalog', 'coefficients', 'balance'])
|
|
23
|
+
|
|
24
|
+
/**
|
|
25
|
+
* Плоские ключи 1.x, которые нормализуются в группы.
|
|
26
|
+
*
|
|
27
|
+
* Список совпадает с §2 спецификации: всё, что писалось в строку патча 1.0.0.
|
|
28
|
+
*/
|
|
29
|
+
export const LEGACY_KEYS = Object.freeze([
|
|
30
|
+
'entryId',
|
|
31
|
+
'provider',
|
|
32
|
+
'baseURL',
|
|
33
|
+
'apiKeyEnv',
|
|
34
|
+
'installerUrls',
|
|
35
|
+
'autoSync',
|
|
36
|
+
'intervalHours',
|
|
37
|
+
'startupDelayMs',
|
|
38
|
+
'minModelRatio',
|
|
39
|
+
'keepModels',
|
|
40
|
+
'syncAllowlist',
|
|
41
|
+
'allowlistEntryId',
|
|
42
|
+
'levelsCacheMinutes',
|
|
43
|
+
'timeoutMs',
|
|
44
|
+
])
|
|
45
|
+
|
|
46
|
+
/** Нижняя граница автозамера баланса: чаще нельзя, 0 — только по кнопке. */
|
|
47
|
+
export const BALANCE_MIN_REFRESH_SECONDS = 15
|
|
48
|
+
|
|
49
|
+
/** Официальные установщики CVC: PowerShell для Windows, bash для Linux/WSL. */
|
|
50
|
+
export const DEFAULT_INSTALLER_URLS = Object.freeze([
|
|
51
|
+
'https://ru.cheapvibecode.ru/idhw',
|
|
52
|
+
'https://ru.cheapvibecode.ru/idhl',
|
|
53
|
+
])
|
|
54
|
+
|
|
55
|
+
/** Маркер, которым schemastery помечает volatile-ссылку. */
|
|
56
|
+
const VOLATILE_WRITE = Symbol.for('cosmokit.volatile.write')
|
|
57
|
+
|
|
58
|
+
/** Глубоко заморозить литерал: умолчания не должны меняться рантаймом. */
|
|
59
|
+
function deepFreeze(value) {
|
|
60
|
+
if (value !== null && typeof value === 'object' && !Object.isFrozen(value)) {
|
|
61
|
+
for (const key of Object.keys(value)) deepFreeze(value[key])
|
|
62
|
+
Object.freeze(value)
|
|
63
|
+
}
|
|
64
|
+
return value
|
|
65
|
+
}
|
|
66
|
+
|
|
67
|
+
/** Значения по умолчанию 2.x — ровно те, что объявлены в схеме. */
|
|
68
|
+
export const DEFAULTS = deepFreeze({
|
|
69
|
+
features: {
|
|
70
|
+
catalogSync: true,
|
|
71
|
+
coefficients: true,
|
|
72
|
+
balance: true,
|
|
73
|
+
},
|
|
74
|
+
providers: {
|
|
75
|
+
match: ['cheapvibecode.ru'],
|
|
76
|
+
entryId: 'llm-pi-ai',
|
|
77
|
+
apiKeyEnv: 'CVC_DEEPSEEK_API_KEY',
|
|
78
|
+
baseURL: 'https://ru.cheapvibecode.ru/v1',
|
|
79
|
+
timeoutMs: 20000,
|
|
80
|
+
},
|
|
81
|
+
catalog: {
|
|
82
|
+
provider: 'cheapvibecode',
|
|
83
|
+
autoSync: true,
|
|
84
|
+
intervalHours: 24,
|
|
85
|
+
startupDelayMs: 5000,
|
|
86
|
+
minModelRatio: 0.8,
|
|
87
|
+
keepModels: [],
|
|
88
|
+
installerUrls: [...DEFAULT_INSTALLER_URLS],
|
|
89
|
+
syncAllowlist: true,
|
|
90
|
+
allowlistEntryId: 'subagent-model-selection-settings',
|
|
91
|
+
levelsCacheMinutes: 360,
|
|
92
|
+
},
|
|
93
|
+
coefficients: {
|
|
94
|
+
refreshMinutes: 10,
|
|
95
|
+
showFast: true,
|
|
96
|
+
},
|
|
97
|
+
balance: {
|
|
98
|
+
refreshSeconds: 0,
|
|
99
|
+
showDelta: true,
|
|
100
|
+
},
|
|
101
|
+
})
|
|
102
|
+
|
|
103
|
+
/** Обычный объект, не массив и не null. */
|
|
104
|
+
function isPlainObject(value) {
|
|
105
|
+
return value !== null && typeof value === 'object' && !Array.isArray(value)
|
|
106
|
+
}
|
|
107
|
+
|
|
108
|
+
/** Первое определённое значение: значение 2.x важнее устаревшего. */
|
|
109
|
+
function first(...values) {
|
|
110
|
+
for (const value of values) {
|
|
111
|
+
if (value !== undefined && value !== null) return value
|
|
112
|
+
}
|
|
113
|
+
return undefined
|
|
114
|
+
}
|
|
115
|
+
|
|
116
|
+
/** Непустая строка без хвостовых пробелов или умолчание. */
|
|
117
|
+
function stringOr(value, fallback) {
|
|
118
|
+
return typeof value === 'string' && value.trim().length > 0 ? value.trim() : fallback
|
|
119
|
+
}
|
|
120
|
+
|
|
121
|
+
/** Булево или умолчание. */
|
|
122
|
+
function boolOr(value, fallback) {
|
|
123
|
+
return typeof value === 'boolean' ? value : fallback
|
|
124
|
+
}
|
|
125
|
+
|
|
126
|
+
/** Конечное число в границах или умолчание. */
|
|
127
|
+
function numberOr(value, fallback, min = -Infinity, max = Infinity) {
|
|
128
|
+
if (typeof value !== 'number' || !Number.isFinite(value)) return fallback
|
|
129
|
+
if (value < min || value > max) return fallback
|
|
130
|
+
return value
|
|
131
|
+
}
|
|
132
|
+
|
|
133
|
+
/** Целое число не меньше единицы или умолчание. */
|
|
134
|
+
function positiveIntOr(value, fallback) {
|
|
135
|
+
if (typeof value !== 'number' || !Number.isFinite(value) || value < 1) return fallback
|
|
136
|
+
return Math.trunc(value)
|
|
137
|
+
}
|
|
138
|
+
|
|
139
|
+
/** Доля в (0, 1] или умолчание. */
|
|
140
|
+
function ratioOr(value, fallback) {
|
|
141
|
+
if (typeof value !== 'number' || !Number.isFinite(value) || value <= 0 || value > 1) return fallback
|
|
142
|
+
return value
|
|
143
|
+
}
|
|
144
|
+
|
|
145
|
+
/** `http(s)`-адрес или undefined. */
|
|
146
|
+
function httpUrl(value) {
|
|
147
|
+
if (typeof value !== 'string' || value.trim().length === 0) return undefined
|
|
148
|
+
try {
|
|
149
|
+
const url = new URL(value.trim())
|
|
150
|
+
return url.protocol === 'https:' || url.protocol === 'http:' ? value.trim() : undefined
|
|
151
|
+
} catch {
|
|
152
|
+
return undefined
|
|
153
|
+
}
|
|
154
|
+
}
|
|
155
|
+
|
|
156
|
+
/** Список хостов: строки, обрезанные и в нижнем регистре, без пустых. */
|
|
157
|
+
function hostListOr(value, fallback) {
|
|
158
|
+
if (!Array.isArray(value)) return [...fallback]
|
|
159
|
+
const hosts = value
|
|
160
|
+
.filter((item) => typeof item === 'string')
|
|
161
|
+
.map((item) => item.trim().toLowerCase())
|
|
162
|
+
.filter((item) => item.length > 0)
|
|
163
|
+
return hosts.length > 0 ? hosts : [...fallback]
|
|
164
|
+
}
|
|
165
|
+
|
|
166
|
+
/** Список строк без пустых; пустой результат заменяется умолчанием. */
|
|
167
|
+
function idListOr(value, fallback) {
|
|
168
|
+
if (!Array.isArray(value)) return [...fallback]
|
|
169
|
+
const items = value
|
|
170
|
+
.filter((item) => typeof item === 'string')
|
|
171
|
+
.map((item) => item.trim())
|
|
172
|
+
.filter((item) => item.length > 0)
|
|
173
|
+
return items.length > 0 ? items : [...fallback]
|
|
174
|
+
}
|
|
175
|
+
|
|
176
|
+
/** Список `http(s)`-адресов; невалидный или пустой список заменяется умолчанием. */
|
|
177
|
+
function urlListOr(value, fallback) {
|
|
178
|
+
if (!Array.isArray(value)) return [...fallback]
|
|
179
|
+
const urls = value.filter((item) => httpUrl(item) !== undefined).map((item) => item.trim())
|
|
180
|
+
return urls.length > 0 ? urls : [...fallback]
|
|
181
|
+
}
|
|
182
|
+
|
|
183
|
+
/**
|
|
184
|
+
* Схема конфигурации 2.0.0.
|
|
185
|
+
*
|
|
186
|
+
* Группы объявлены объектами с умолчаниями, листья — `.volatile()`: ссылка
|
|
187
|
+
* читается через `.get()` и обновляется на месте. Плоские ключи 1.x — только
|
|
188
|
+
* для чтения старого патча, в нормализованный конфиг они не попадают.
|
|
189
|
+
*/
|
|
190
|
+
export const Config = z.object({
|
|
191
|
+
features: z.object({
|
|
192
|
+
catalogSync: z.boolean().default(DEFAULTS.features.catalogSync).volatile(),
|
|
193
|
+
coefficients: z.boolean().default(DEFAULTS.features.coefficients).volatile(),
|
|
194
|
+
balance: z.boolean().default(DEFAULTS.features.balance).volatile(),
|
|
195
|
+
}).default({}),
|
|
196
|
+
providers: z.object({
|
|
197
|
+
match: z.array(z.string()).default([...DEFAULTS.providers.match]).volatile(),
|
|
198
|
+
entryId: z.string().default(DEFAULTS.providers.entryId).volatile(),
|
|
199
|
+
apiKeyEnv: z.string().default(DEFAULTS.providers.apiKeyEnv).volatile(),
|
|
200
|
+
baseURL: z.string().default(DEFAULTS.providers.baseURL).volatile(),
|
|
201
|
+
timeoutMs: z.number().min(1).default(DEFAULTS.providers.timeoutMs).volatile(),
|
|
202
|
+
}).default({}),
|
|
203
|
+
catalog: z.object({
|
|
204
|
+
provider: z.string().default(DEFAULTS.catalog.provider).volatile(),
|
|
205
|
+
autoSync: z.boolean().default(DEFAULTS.catalog.autoSync).volatile(),
|
|
206
|
+
intervalHours: z.number().min(0).default(DEFAULTS.catalog.intervalHours).volatile(),
|
|
207
|
+
startupDelayMs: z.number().min(0).default(DEFAULTS.catalog.startupDelayMs).volatile(),
|
|
208
|
+
minModelRatio: z.number().min(0.0001).max(1).default(DEFAULTS.catalog.minModelRatio).volatile(),
|
|
209
|
+
keepModels: z.array(z.string()).default([...DEFAULTS.catalog.keepModels]).volatile(),
|
|
210
|
+
installerUrls: z.array(z.string()).default([...DEFAULT_INSTALLER_URLS]).volatile(),
|
|
211
|
+
syncAllowlist: z.boolean().default(DEFAULTS.catalog.syncAllowlist).volatile(),
|
|
212
|
+
allowlistEntryId: z.string().default(DEFAULTS.catalog.allowlistEntryId).volatile(),
|
|
213
|
+
levelsCacheMinutes: z.number().min(0).default(DEFAULTS.catalog.levelsCacheMinutes).volatile(),
|
|
214
|
+
}).default({}),
|
|
215
|
+
coefficients: z.object({
|
|
216
|
+
refreshMinutes: z.number().min(1).default(DEFAULTS.coefficients.refreshMinutes).volatile(),
|
|
217
|
+
showFast: z.boolean().default(DEFAULTS.coefficients.showFast).volatile(),
|
|
218
|
+
}).default({}),
|
|
219
|
+
balance: z.object({
|
|
220
|
+
refreshSeconds: z.number().min(0).default(DEFAULTS.balance.refreshSeconds).volatile(),
|
|
221
|
+
showDelta: z.boolean().default(DEFAULTS.balance.showDelta).volatile(),
|
|
222
|
+
}).default({}),
|
|
223
|
+
|
|
224
|
+
// Устаревшие плоские поля 1.0.0. Без умолчаний: отсутствие поля в патче
|
|
225
|
+
// должно оставаться отсутствием, иначе миграция никогда не завершится.
|
|
226
|
+
entryId: z.string().volatile(),
|
|
227
|
+
provider: z.string().volatile(),
|
|
228
|
+
baseURL: z.string().volatile(),
|
|
229
|
+
apiKeyEnv: z.string().volatile(),
|
|
230
|
+
installerUrls: z.array(z.string()).volatile(),
|
|
231
|
+
autoSync: z.boolean().volatile(),
|
|
232
|
+
intervalHours: z.number().volatile(),
|
|
233
|
+
startupDelayMs: z.number().volatile(),
|
|
234
|
+
minModelRatio: z.number().volatile(),
|
|
235
|
+
keepModels: z.array(z.string()).volatile(),
|
|
236
|
+
syncAllowlist: z.boolean().volatile(),
|
|
237
|
+
allowlistEntryId: z.string().volatile(),
|
|
238
|
+
levelsCacheMinutes: z.number().volatile(),
|
|
239
|
+
timeoutMs: z.number().volatile(),
|
|
240
|
+
})
|
|
241
|
+
|
|
242
|
+
/**
|
|
243
|
+
* Проверить, что значение — volatile-ссылка schemastery.
|
|
244
|
+
* @param {unknown} value
|
|
245
|
+
* @returns {value is { get: () => unknown }}
|
|
246
|
+
*/
|
|
247
|
+
export function isVolatileReference(value) {
|
|
248
|
+
return value !== null
|
|
249
|
+
&& typeof value === 'object'
|
|
250
|
+
&& typeof (/** @type {{ get?: unknown }} */ (value).get) === 'function'
|
|
251
|
+
&& Object.hasOwn(value, VOLATILE_WRITE)
|
|
252
|
+
}
|
|
253
|
+
|
|
254
|
+
/**
|
|
255
|
+
* Развернуть volatile-ссылки в обычные значения (рекурсивно).
|
|
256
|
+
*
|
|
257
|
+
* Замороженные снимки из ссылок копируются в новые массивы и объекты, чтобы
|
|
258
|
+
* нормализация не зависела от того, отдал ли schemastery общий объект.
|
|
259
|
+
* @param {unknown} value
|
|
260
|
+
* @returns {unknown}
|
|
261
|
+
*/
|
|
262
|
+
export function unwrapReferences(value) {
|
|
263
|
+
if (isVolatileReference(value)) return unwrapReferences(value.get())
|
|
264
|
+
if (Array.isArray(value)) return value.map((item) => unwrapReferences(item))
|
|
265
|
+
if (isPlainObject(value)) {
|
|
266
|
+
/** @type {Record<string, unknown>} */
|
|
267
|
+
const plain = {}
|
|
268
|
+
for (const [key, item] of Object.entries(value)) plain[key] = unwrapReferences(item)
|
|
269
|
+
return plain
|
|
270
|
+
}
|
|
271
|
+
return value
|
|
272
|
+
}
|
|
273
|
+
|
|
274
|
+
/**
|
|
275
|
+
* Привести любой вход (1.x, 2.x, частичный, битый) к полному конфигу 2.x.
|
|
276
|
+
*
|
|
277
|
+
* Битые значения не бросают: плагин должен подниматься и с неполным патчем,
|
|
278
|
+
* иначе одна опечатка молча выключает автообновление.
|
|
279
|
+
* @param {unknown} raw
|
|
280
|
+
* @returns {typeof DEFAULTS}
|
|
281
|
+
*/
|
|
282
|
+
export function normalizeConfig(raw) {
|
|
283
|
+
const source = isPlainObject(unwrapReferences(raw)) ? /** @type {Record<string, any>} */ (unwrapReferences(raw)) : {}
|
|
284
|
+
const features = isPlainObject(source.features) ? source.features : {}
|
|
285
|
+
const providers = isPlainObject(source.providers) ? source.providers : {}
|
|
286
|
+
const catalog = isPlainObject(source.catalog) ? source.catalog : {}
|
|
287
|
+
const coefficients = isPlainObject(source.coefficients) ? source.coefficients : {}
|
|
288
|
+
const balance = isPlainObject(source.balance) ? source.balance : {}
|
|
289
|
+
|
|
290
|
+
const refreshSecondsRaw = numberOr(first(balance.refreshSeconds), DEFAULTS.balance.refreshSeconds, 0)
|
|
291
|
+
// 0 — только по кнопке; ненулевое значение ниже минимума поднимается до него,
|
|
292
|
+
// чтобы опечатка «5» не превращалась в запрос каждые пять секунд.
|
|
293
|
+
const refreshSeconds = refreshSecondsRaw > 0 && refreshSecondsRaw < BALANCE_MIN_REFRESH_SECONDS
|
|
294
|
+
? BALANCE_MIN_REFRESH_SECONDS
|
|
295
|
+
: refreshSecondsRaw
|
|
296
|
+
|
|
297
|
+
return {
|
|
298
|
+
features: {
|
|
299
|
+
catalogSync: boolOr(features.catalogSync, DEFAULTS.features.catalogSync),
|
|
300
|
+
coefficients: boolOr(features.coefficients, DEFAULTS.features.coefficients),
|
|
301
|
+
balance: boolOr(features.balance, DEFAULTS.features.balance),
|
|
302
|
+
},
|
|
303
|
+
providers: {
|
|
304
|
+
match: hostListOr(first(providers.match), DEFAULTS.providers.match),
|
|
305
|
+
entryId: stringOr(first(providers.entryId, source.entryId), DEFAULTS.providers.entryId),
|
|
306
|
+
apiKeyEnv: stringOr(first(providers.apiKeyEnv, source.apiKeyEnv), DEFAULTS.providers.apiKeyEnv),
|
|
307
|
+
baseURL: httpUrl(first(providers.baseURL, source.baseURL)) ?? DEFAULTS.providers.baseURL,
|
|
308
|
+
timeoutMs: numberOr(first(providers.timeoutMs, source.timeoutMs), DEFAULTS.providers.timeoutMs, 1),
|
|
309
|
+
},
|
|
310
|
+
catalog: {
|
|
311
|
+
provider: stringOr(first(catalog.provider, source.provider), DEFAULTS.catalog.provider),
|
|
312
|
+
autoSync: boolOr(first(catalog.autoSync, source.autoSync), DEFAULTS.catalog.autoSync),
|
|
313
|
+
intervalHours: numberOr(first(catalog.intervalHours, source.intervalHours), DEFAULTS.catalog.intervalHours, 0),
|
|
314
|
+
startupDelayMs: numberOr(first(catalog.startupDelayMs, source.startupDelayMs), DEFAULTS.catalog.startupDelayMs, 0),
|
|
315
|
+
minModelRatio: ratioOr(first(catalog.minModelRatio, source.minModelRatio), DEFAULTS.catalog.minModelRatio),
|
|
316
|
+
keepModels: idListOr(first(catalog.keepModels, source.keepModels), DEFAULTS.catalog.keepModels),
|
|
317
|
+
installerUrls: urlListOr(first(catalog.installerUrls, source.installerUrls), DEFAULTS.catalog.installerUrls),
|
|
318
|
+
syncAllowlist: boolOr(first(catalog.syncAllowlist, source.syncAllowlist), DEFAULTS.catalog.syncAllowlist),
|
|
319
|
+
allowlistEntryId: stringOr(first(catalog.allowlistEntryId, source.allowlistEntryId), DEFAULTS.catalog.allowlistEntryId),
|
|
320
|
+
levelsCacheMinutes: numberOr(
|
|
321
|
+
first(catalog.levelsCacheMinutes, source.levelsCacheMinutes),
|
|
322
|
+
DEFAULTS.catalog.levelsCacheMinutes,
|
|
323
|
+
0,
|
|
324
|
+
),
|
|
325
|
+
},
|
|
326
|
+
coefficients: {
|
|
327
|
+
refreshMinutes: positiveIntOr(first(coefficients.refreshMinutes), DEFAULTS.coefficients.refreshMinutes),
|
|
328
|
+
showFast: boolOr(first(coefficients.showFast), DEFAULTS.coefficients.showFast),
|
|
329
|
+
},
|
|
330
|
+
balance: {
|
|
331
|
+
refreshSeconds,
|
|
332
|
+
showDelta: boolOr(first(balance.showDelta), DEFAULTS.balance.showDelta),
|
|
333
|
+
},
|
|
334
|
+
}
|
|
335
|
+
}
|
|
336
|
+
|
|
337
|
+
/**
|
|
338
|
+
* Прочитать действующий конфиг плагина из того, что передал Loader.
|
|
339
|
+
*
|
|
340
|
+
* Loader передаёт объект со ссылками; в тестах и на странице настроек может
|
|
341
|
+
* прийти обычный объект. Оба вида приводятся к нормализованному конфигу 2.x.
|
|
342
|
+
* @param {unknown} config
|
|
343
|
+
* @returns {ReturnType<typeof normalizeConfig>}
|
|
344
|
+
*/
|
|
345
|
+
export function readPluginConfig(config) {
|
|
346
|
+
return normalizeConfig(unwrapReferences(config))
|
|
347
|
+
}
|
|
348
|
+
|
|
349
|
+
/**
|
|
350
|
+
* Форма записанного в патч конфига.
|
|
351
|
+
*
|
|
352
|
+
* `legacy` — только плоские ключи 1.x; `v2` — есть хотя бы одна группа 2.x
|
|
353
|
+
* (или записывать нечего). Обе формы вместе считаются v2: группы важнее.
|
|
354
|
+
* @param {unknown} raw
|
|
355
|
+
* @returns {'legacy' | 'v2'}
|
|
356
|
+
*/
|
|
357
|
+
export function configShapeOf(raw) {
|
|
358
|
+
const source = isPlainObject(raw) ? raw : {}
|
|
359
|
+
const hasLegacy = LEGACY_KEYS.some((key) => Object.hasOwn(source, key))
|
|
360
|
+
const hasGroups = CONFIG_GROUPS.some((key) => isPlainObject(source[key]))
|
|
361
|
+
return hasLegacy && !hasGroups ? 'legacy' : 'v2'
|
|
362
|
+
}
|
|
363
|
+
|
|
364
|
+
/** Проверить значение устаревшего ключа 1.x по тем же правилам. */
|
|
365
|
+
function validateLegacy(source, errors) {
|
|
366
|
+
const stringKeys = ['entryId', 'provider', 'apiKeyEnv', 'baseURL', 'allowlistEntryId']
|
|
367
|
+
for (const key of stringKeys) {
|
|
368
|
+
if (source[key] === undefined) continue
|
|
369
|
+
if (typeof source[key] !== 'string' || source[key].trim().length === 0) errors.push(`${key}: non-empty string required`)
|
|
370
|
+
}
|
|
371
|
+
if (source.baseURL !== undefined && httpUrl(source.baseURL) === undefined) {
|
|
372
|
+
errors.push('baseURL: http(s) URL required')
|
|
373
|
+
}
|
|
374
|
+
if (source.installerUrls !== undefined) {
|
|
375
|
+
if (!Array.isArray(source.installerUrls) || source.installerUrls.length === 0) {
|
|
376
|
+
errors.push('installerUrls: non-empty list of URLs required')
|
|
377
|
+
} else if (source.installerUrls.some((url) => httpUrl(url) === undefined)) {
|
|
378
|
+
errors.push('installerUrls: every item must be an http(s) URL')
|
|
379
|
+
}
|
|
380
|
+
}
|
|
381
|
+
if (source.keepModels !== undefined) {
|
|
382
|
+
if (!Array.isArray(source.keepModels) || source.keepModels.some((id) => typeof id !== 'string')) {
|
|
383
|
+
errors.push('keepModels: list of strings required')
|
|
384
|
+
}
|
|
385
|
+
}
|
|
386
|
+
for (const key of ['autoSync', 'syncAllowlist']) {
|
|
387
|
+
if (source[key] !== undefined && typeof source[key] !== 'boolean') errors.push(`${key}: boolean required`)
|
|
388
|
+
}
|
|
389
|
+
const numbers = [
|
|
390
|
+
['intervalHours', 0, Infinity],
|
|
391
|
+
['startupDelayMs', 0, Infinity],
|
|
392
|
+
['levelsCacheMinutes', 0, Infinity],
|
|
393
|
+
['timeoutMs', 1, Infinity],
|
|
394
|
+
['minModelRatio', Number.MIN_VALUE, 1],
|
|
395
|
+
]
|
|
396
|
+
for (const [key, min, max] of numbers) {
|
|
397
|
+
if (source[key] === undefined) continue
|
|
398
|
+
const value = source[key]
|
|
399
|
+
if (typeof value !== 'number' || !Number.isFinite(value) || value < min || value > max) {
|
|
400
|
+
errors.push(`${key}: number in [${min}, ${max}] required`)
|
|
401
|
+
}
|
|
402
|
+
}
|
|
403
|
+
}
|
|
404
|
+
|
|
405
|
+
/**
|
|
406
|
+
* Проверить пользовательский ввод перед записью в патч.
|
|
407
|
+
*
|
|
408
|
+
* Возвращает понятные поля с ошибками, а не молча подставляет умолчания:
|
|
409
|
+
* опечатка в интерфейсе не должна тихо превращаться в другие настройки.
|
|
410
|
+
* Проверяются только присутствующие поля — клиент вправе прислать одну группу.
|
|
411
|
+
* @param {unknown} raw
|
|
412
|
+
* @returns {string[]}
|
|
413
|
+
*/
|
|
414
|
+
export function validateConfigInput(raw) {
|
|
415
|
+
if (!isPlainObject(raw)) return ['config: object required']
|
|
416
|
+
const errors = []
|
|
417
|
+
const source = /** @type {Record<string, any>} */ (raw)
|
|
418
|
+
|
|
419
|
+
for (const group of CONFIG_GROUPS) {
|
|
420
|
+
if (source[group] !== undefined && !isPlainObject(source[group])) errors.push(`${group}: object required`)
|
|
421
|
+
}
|
|
422
|
+
|
|
423
|
+
const features = isPlainObject(source.features) ? source.features : {}
|
|
424
|
+
for (const key of FEATURE_KEYS) {
|
|
425
|
+
if (features[key] !== undefined && typeof features[key] !== 'boolean') {
|
|
426
|
+
errors.push(`features.${key}: boolean required`)
|
|
427
|
+
}
|
|
428
|
+
}
|
|
429
|
+
|
|
430
|
+
const providers = isPlainObject(source.providers) ? source.providers : {}
|
|
431
|
+
if (providers.match !== undefined) {
|
|
432
|
+
if (!Array.isArray(providers.match) || providers.match.length === 0) {
|
|
433
|
+
errors.push('providers.match: non-empty list of host names required')
|
|
434
|
+
} else if (providers.match.some((host) => typeof host !== 'string' || host.trim().length === 0)) {
|
|
435
|
+
errors.push('providers.match: every host must be a non-empty string')
|
|
436
|
+
}
|
|
437
|
+
}
|
|
438
|
+
for (const key of ['entryId', 'apiKeyEnv']) {
|
|
439
|
+
if (providers[key] !== undefined && (typeof providers[key] !== 'string' || providers[key].trim().length === 0)) {
|
|
440
|
+
errors.push(`providers.${key}: non-empty string required`)
|
|
441
|
+
}
|
|
442
|
+
}
|
|
443
|
+
if (providers.baseURL !== undefined && httpUrl(providers.baseURL) === undefined) {
|
|
444
|
+
errors.push('providers.baseURL: http(s) URL required')
|
|
445
|
+
}
|
|
446
|
+
if (providers.timeoutMs !== undefined) {
|
|
447
|
+
const value = providers.timeoutMs
|
|
448
|
+
if (typeof value !== 'number' || !Number.isFinite(value) || value < 1) {
|
|
449
|
+
errors.push('providers.timeoutMs: number >= 1 required')
|
|
450
|
+
}
|
|
451
|
+
}
|
|
452
|
+
|
|
453
|
+
const catalog = isPlainObject(source.catalog) ? source.catalog : {}
|
|
454
|
+
if (catalog.provider !== undefined && (typeof catalog.provider !== 'string' || catalog.provider.trim().length === 0)) {
|
|
455
|
+
errors.push('catalog.provider: non-empty string required')
|
|
456
|
+
}
|
|
457
|
+
for (const key of ['autoSync', 'syncAllowlist']) {
|
|
458
|
+
if (catalog[key] !== undefined && typeof catalog[key] !== 'boolean') errors.push(`catalog.${key}: boolean required`)
|
|
459
|
+
}
|
|
460
|
+
const catalogNumbers = [
|
|
461
|
+
['intervalHours', 0, Infinity],
|
|
462
|
+
['startupDelayMs', 0, Infinity],
|
|
463
|
+
['levelsCacheMinutes', 0, Infinity],
|
|
464
|
+
['minModelRatio', Number.MIN_VALUE, 1],
|
|
465
|
+
]
|
|
466
|
+
for (const [key, min, max] of catalogNumbers) {
|
|
467
|
+
if (catalog[key] === undefined) continue
|
|
468
|
+
const value = catalog[key]
|
|
469
|
+
if (typeof value !== 'number' || !Number.isFinite(value) || value < min || value > max) {
|
|
470
|
+
errors.push(`catalog.${key}: number in [${min}, ${max}] required`)
|
|
471
|
+
}
|
|
472
|
+
}
|
|
473
|
+
if (catalog.allowlistEntryId !== undefined) {
|
|
474
|
+
const value = catalog.allowlistEntryId
|
|
475
|
+
if (typeof value !== 'string' || value.trim().length === 0) {
|
|
476
|
+
errors.push('catalog.allowlistEntryId: non-empty string required')
|
|
477
|
+
}
|
|
478
|
+
}
|
|
479
|
+
if (catalog.keepModels !== undefined) {
|
|
480
|
+
if (!Array.isArray(catalog.keepModels) || catalog.keepModels.some((id) => typeof id !== 'string')) {
|
|
481
|
+
errors.push('catalog.keepModels: list of strings required')
|
|
482
|
+
}
|
|
483
|
+
}
|
|
484
|
+
if (catalog.installerUrls !== undefined) {
|
|
485
|
+
if (!Array.isArray(catalog.installerUrls) || catalog.installerUrls.length === 0) {
|
|
486
|
+
errors.push('catalog.installerUrls: non-empty list of URLs required')
|
|
487
|
+
} else if (catalog.installerUrls.some((url) => httpUrl(url) === undefined)) {
|
|
488
|
+
errors.push('catalog.installerUrls: every item must be an http(s) URL')
|
|
489
|
+
}
|
|
490
|
+
}
|
|
491
|
+
|
|
492
|
+
const coefficients = isPlainObject(source.coefficients) ? source.coefficients : {}
|
|
493
|
+
if (coefficients.refreshMinutes !== undefined) {
|
|
494
|
+
const value = coefficients.refreshMinutes
|
|
495
|
+
if (typeof value !== 'number' || !Number.isFinite(value) || value < 1) {
|
|
496
|
+
errors.push('coefficients.refreshMinutes: number >= 1 required')
|
|
497
|
+
}
|
|
498
|
+
}
|
|
499
|
+
if (coefficients.showFast !== undefined && typeof coefficients.showFast !== 'boolean') {
|
|
500
|
+
errors.push('coefficients.showFast: boolean required')
|
|
501
|
+
}
|
|
502
|
+
|
|
503
|
+
const balance = isPlainObject(source.balance) ? source.balance : {}
|
|
504
|
+
if (balance.refreshSeconds !== undefined) {
|
|
505
|
+
const value = balance.refreshSeconds
|
|
506
|
+
if (typeof value !== 'number' || !Number.isFinite(value) || value < 0) {
|
|
507
|
+
errors.push('balance.refreshSeconds: number >= 0 required')
|
|
508
|
+
} else if (value > 0 && value < BALANCE_MIN_REFRESH_SECONDS) {
|
|
509
|
+
errors.push(`balance.refreshSeconds: 0 or at least ${BALANCE_MIN_REFRESH_SECONDS} required`)
|
|
510
|
+
}
|
|
511
|
+
}
|
|
512
|
+
if (balance.showDelta !== undefined && typeof balance.showDelta !== 'boolean') {
|
|
513
|
+
errors.push('balance.showDelta: boolean required')
|
|
514
|
+
}
|
|
515
|
+
|
|
516
|
+
validateLegacy(source, errors)
|
|
517
|
+
return errors
|
|
518
|
+
}
|
|
519
|
+
|
|
520
|
+
/**
|
|
521
|
+
* Детерминированная JSON-строка: ключи объектов отсортированы.
|
|
522
|
+
*
|
|
523
|
+
* Нужна для сравнения конфигов (сброс к умолчаниям, «конфиг не изменился»)
|
|
524
|
+
* и для диффа моделей в порту каталога.
|
|
525
|
+
* @param {unknown} value
|
|
526
|
+
* @returns {string}
|
|
527
|
+
*/
|
|
528
|
+
export function stableStringify(value) {
|
|
529
|
+
if (value === undefined) return 'undefined'
|
|
530
|
+
if (value === null || typeof value !== 'object') return JSON.stringify(value)
|
|
531
|
+
if (Array.isArray(value)) return `[${value.map((item) => stableStringify(item)).join(',')}]`
|
|
532
|
+
const record = /** @type {Record<string, unknown>} */ (value)
|
|
533
|
+
const keys = Object.keys(record).sort()
|
|
534
|
+
return `{${keys.map((key) => `${JSON.stringify(key)}:${stableStringify(record[key])}`).join(',')}}`
|
|
535
|
+
}
|
|
536
|
+
|
|
537
|
+
/**
|
|
538
|
+
* Совпадают ли два конфига по значению.
|
|
539
|
+
* @param {unknown} left
|
|
540
|
+
* @param {unknown} right
|
|
541
|
+
* @returns {boolean}
|
|
542
|
+
*/
|
|
543
|
+
export function sameConfig(left, right) {
|
|
544
|
+
return stableStringify(left) === stableStringify(right)
|
|
545
|
+
}
|
|
546
|
+
|
|
547
|
+
/**
|
|
548
|
+
* Только переключатели функций.
|
|
549
|
+
* @param {{ features: Record<string, boolean> }} config
|
|
550
|
+
* @returns {{ catalogSync: boolean, coefficients: boolean, balance: boolean }}
|
|
551
|
+
*/
|
|
552
|
+
export function featuresOf(config) {
|
|
553
|
+
return {
|
|
554
|
+
catalogSync: config.features.catalogSync === true,
|
|
555
|
+
coefficients: config.features.coefficients === true,
|
|
556
|
+
balance: config.features.balance === true,
|
|
557
|
+
}
|
|
558
|
+
}
|