cvc-catalog-sync-plugin 1.0.0 → 2.0.0

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/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
+ }