vimp-engine 0.38.1 → 0.38.3

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 lgick
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,9 +1,15 @@
 # vimp-engine
 
-VIMP — движок-приложение: мастер (лобби, WebRTC-сигналинг), P2P-транспорт,
-Worker-хост, мета-модули матча, MVC-каркас клиента. Игровые правила
-(например, `@vimp-games/tanks`) подключаются динамически через
-[plugin-api](https://github.com/lgick/vimp/blob/main/docs/en/plugin-api.md)
-— этот пакет их не содержит.
+The VIMP engine SDK for game plugins: the browser host and client runtime,
+the standalone mode (`vimp-engine/standalone`) and the CLI tools `vimp-sim`
+and `vimp-contract`. Game rules live in separate plugin packages that the
+engine loads at runtime through the
+[plugin contract](https://docs.vimp.lgick.dev/en/plugin-api).
 
-Документация: https://github.com/lgick/vimp/tree/main/docs/en
+Start a game:
+
+```bash
+npm create vimp-game my-game
+```
+
+Documentation: https://docs.vimp.lgick.dev

package/bin/vimp-sim.js

@@ -40,8 +40,8 @@ const BUILTIN_NOTICE =
   'notice: the built-in smoke scenario is running against --game. It only\n' +
   'notice: proves the loop closes on this plugin: key coverage (invariant 2)\n' +
   'notice: and prediction drift (invariant 9) are skipped — both need a\n' +
-  'notice: scenario written for your game. See § Scenario format in the\n' +
-  "notice: engine's docs/en/debugging.md (github.com/lgick/vimp), then run\n" +
+  'notice: scenario written for your game. See § Scenario format at\n' +
+  'notice: https://docs.vimp.lgick.dev/en/debugging#scenario-format, then run\n' +
   'notice: vimp-sim --scenario <file>.\n\n';
 
 // типичная опечатка «--core без --game»: фикстурное ядро — обычный JS и

package/core/Cargo.toml

@@ -1,10 +1,11 @@
 [package]
 name = "vimp-engine-core"
-version = "0.23.2"
+version = "0.23.4"
 edition = "2024"
-description = "VIMP — движковый каркас симуляции (физика, карта, снапшот-фрейминг, интерполяция/предикт/raycast-примитивы, нав-утилиты). Без wasm-bindgen — обёртки для WASM-ABI собирает game-crate."
+description = "VIMP engine simulation core: physics, map, snapshot framing, interpolation/prediction/raycast primitives, navigation utilities. No wasm-bindgen — the game crate builds the WASM ABI wrappers."
 license = "MIT"
-repository = "https://github.com/lgick/vimp"
+homepage = "https://docs.vimp.lgick.dev/en/core"
+documentation = "https://docs.rs/vimp-engine-core"
 readme = "README.md"
 
 [lib]

package/package.json

@@ -1,13 +1,14 @@
 {
   "name": "vimp-engine",
-  "version": "0.38.1",
-  "description": "VIMP — движок-приложение (мастер, P2P-транспорт, Worker-хост, мета, MVC-каркас клиента)",
+  "version": "0.38.3",
+  "description": "VIMP engine SDK: browser host and client runtime, standalone mode and CLI tools (vimp-sim, vimp-contract) for VIMP game plugins",
   "license": "MIT",
   "repository": {
     "type": "git",
-    "url": "git+ssh://git@github.com/lgick/vimp.git"
+    "url": "git+ssh://git@github.com/lgick/vimp.git",
+    "directory": "packages/engine"
   },
-  "homepage": "https://github.com/lgick/vimp#readme",
+  "homepage": "https://docs.vimp.lgick.dev",
   "type": "module",
   "engines": {
     "node": ">=20.11.0"
@@ -23,15 +24,23 @@
   },
   "files": [
     "src/lib",
+    "!src/lib/clientIp.js",
+    "!src/lib/rateLimiter.js",
+    "!src/lib/security.js",
     "src/config",
+    "!src/config/env.js",
+    "!src/config/master.js",
     "src/host",
     "src/client",
     "!src/client/_*",
     "src/standalone",
     "src/devtools",
+    "!src/devtools/surface/abiParse.js",
+    "!src/devtools/surface/collect.js",
     "tests/fixtures",
     "core/Cargo.toml",
-    "bin"
+    "bin",
+    "!bin/vimp-surface.js"
   ],
   "scripts": {
     "predev": "node scripts/sync-pixi-vendor.mjs",

package/src/client/boot.js

@@ -11,8 +11,14 @@
 // window не вводим: они переживают перезагрузку бандла и ломают вторую
 // вкладку SDK в том же документе.
 
+import {
+  bodyReadFailure,
+  fetchRetrying,
+  isNetworkFailure,
+} from './lib/retryOnNetworkError.js';
+
 // эндпоинт режима: его отдаёт dedicated-сервер, у мастера его нет —
-// 404/сеть/мусор означают прод-лобби (обратная совместимость)
+// 404 и мусор означают прод-лобби; сбой сети — отказ загрузки
 const CONFIG_URL = '/config';
 
 // умолчание игрового WS dedicated-сервера: тот же хост, путь /game
@@ -65,23 +71,40 @@ export function resetBootConfig() {
 /**
  * Разрешает режим загрузки: инъекция SDK → GET /config → лобби.
  * @param {Function} [fetchImpl] - Реализация fetch (тесты подставляют свою).
- * @returns {Promise<Object>} Конфиг загрузки.
+ * @param {Object} [retry] - Параметры fetchRetrying (тесты отключают паузы).
+ * @returns {Promise<Object>} Конфиг загрузки; отклоняется NetworkFailure, если
+ *   сеть не ответила после повторов.
  */
-export async function resolveBootConfig(fetchImpl) {
+export async function resolveBootConfig(fetchImpl, retry) {
   if (bootConfig) {
     return bootConfig;
   }
 
   const doFetch = fetchImpl ?? ((...args) => fetch(...args));
+  let res = null;
 
   try {
-    const res = await doFetch(CONFIG_URL);
+    res = await fetchRetrying(doFetch, CONFIG_URL, retry);
+  } catch (e) {
+    // сети нет: режим неизвестен, и лобби здесь — догадка, а не факт
+    if (isNetworkFailure(e)) {
+      throw e;
+    }
+  }
 
-    if (res.ok) {
+  if (res?.ok) {
+    try {
       bootConfig = normalize(await res.json());
+    } catch (e) {
+      // мусор в JSON — лобби; обрыв при чтении тела — сбой сети
+      const failure = bodyReadFailure(e);
+
+      if (isNetworkFailure(failure)) {
+        throw failure;
+      }
+
+      bootConfig = null;
     }
-  } catch (e) {
-    // сети/эндпоинта нет — это и есть прод-лобби, шуметь не о чем
   }
 
   bootConfig = bootConfig ?? { mode: 'lobby' };

package/src/client/components/controller/ClientReports.js

@@ -2,7 +2,7 @@
 
 let clientReportsCtrl;
 
-// Контроллер журнала клиентских ошибок (plan/client-reports, этап 5):
+// Контроллер журнала клиентских ошибок:
 // связывает view-события с моделью, собственного сетевого I/O не делает
 export default class ClientReportsCtrl {
   constructor(model, view) {

package/src/client/components/controller/Games.js

@@ -95,7 +95,7 @@ export default class GamesCtrl {
   }
 
   approve({ id }) {
-    this._model.moderate(id, { status: 'approved' });
+    this._model.approve(id);
   }
 
   reject({ id, note }) {

package/src/client/components/model/ClientReports.js

@@ -4,7 +4,7 @@ import Publisher from '../../../lib/Publisher.js';
 
 let clientReportsModel;
 
-// Модель журнала клиентских ошибок в лобби (plan/client-reports, этап 5):
+// Модель журнала клиентских ошибок в лобби:
 // страницы журнала, фильтры и решение админа по строке. Как GamesModel,
 // сетевые запросы делает сама (простой REST к мастеру) и DOM не трогает.
 // Наружу — одно событие 'changed' с полным состоянием: список, счётчик,

package/src/client/components/model/Games.js

@@ -222,6 +222,24 @@ export default class GamesModel {
     await this.loadAdmin();
   }
 
+  // одобрение называет заявку, которую модератор видит в карточке
+  // (this._all — то, что нарисовано): переподанная после загрузки очереди
+  // заявка вернёт 409 moderationStale
+  async approve(id) {
+    const game = this._all.find(item => item.id === id);
+
+    if (!game) {
+      this._fail('admin', { error: 'unknownGame' });
+      return;
+    }
+
+    await this.moderate(id, {
+      status: 'approved',
+      expectedPendingVersion: game.pendingVersion ?? null,
+      expectedPendingRepoUrl: game.pendingRepoUrl ?? null,
+    });
+  }
+
   async moderate(id, patch) {
     const { ok, json } = await this._request(this._config.urls.moderate(id), {
       method: 'PATCH',
@@ -229,6 +247,12 @@ export default class GamesModel {
     });
 
     if (!ok) {
+      // карточка устарела: показать свежую и только потом отказ — иначе
+      // перерисовка сотрёт его тем же тиком
+      if (json?.error === 'moderationStale') {
+        await this.loadAdmin();
+      }
+
       this._fail('admin', json);
       return;
     }

package/src/client/components/view/Auth.js

@@ -13,7 +13,8 @@ export default class AuthView {
   // texts — игровые тексты формы (authSchema.texts: title, sections);
   // сам каркас (auth.pug) нейтрален и текстов игры не содержит.
   // params — та же дескрипторная схема формы, что и у room-формы
-  // (docs/en/plugin-api.md "Form schema"), едет по сети в PS_AUTH_DATA
+  // (docs.vimp.lgick.dev/en/plugin-api "Form schema"), едет по сети в
+  // PS_AUTH_DATA
   constructor(model, elems, texts = null, params = null) {
     if (authView) {
       return authView;
@@ -63,7 +64,8 @@ export default class AuthView {
   }
 
   // строит контролы формы игрока из той же дескрипторной схемы, что и
-  // room-форма (единый formBuilder, docs/en/plugin-api.md "Form schema")
+  // room-форма (единый formBuilder, docs.vimp.lgick.dev/en/plugin-api "Form
+  // schema")
   _renderFields(elems, params) {
     if (!Array.isArray(params)) {
       return;

package/src/client/components/view/ClientReports.js

@@ -57,7 +57,7 @@ function truncate(text, max) {
   return text.length > max ? `${text.slice(0, max - 1)}…` : text;
 }
 
-// Представление журнала клиентских ошибок (plan/client-reports, этап 5).
+// Представление журнала клиентских ошибок.
 //
 // ***** БЕЗОПАСНОСТЬ *****
 //

package/src/client/components/view/Games.js

@@ -19,6 +19,9 @@ const ERROR_MESSAGES = {
   gameExists: 'A game with this id already exists',
   tooManyGames: 'Too many submissions from one author',
   unknownGame: 'Game is not in the registry',
+  // автор переподал заявку, пока модератор смотрел карточку
+  moderationStale:
+    'The request changed while you were reviewing it — check the refreshed card',
   gamePublished: 'Published game — ask an admin to disable it first',
   unknownUser: 'No player with this nick',
   invalidGameId: 'Invalid game id',
@@ -270,6 +273,7 @@ export default class GamesView {
       );
       item.appendChild(this._line(this._statusLine(game)));
       this._appendRepo(item, game.repoUrl);
+      this._appendPendingRepo(item, game);
 
       if (game.moderatorNote) {
         item.appendChild(this._line(`Note: ${game.moderatorNote}`));
@@ -390,6 +394,7 @@ export default class GamesView {
       ),
     );
     this._appendRepo(item, game.repoUrl);
+    this._appendPendingRepo(item, game);
     item.appendChild(
       this._line(
         `Served: ${game.version ?? '—'}; requested: ${game.pendingVersion ?? '—'}` +
@@ -460,7 +465,7 @@ export default class GamesView {
   // принимает только http(s): href — единственное место представления, где
   // содержимое поля становится исполняемым (javascript:), и полагаться на
   // одну проверку на другой стороне сети тут не стоит
-  _appendRepo(item, url) {
+  _appendRepo(item, url, prefix = '') {
     if (typeof url !== 'string' || !/^https?:\/\//i.test(url)) {
       return;
     }
@@ -472,10 +477,23 @@ export default class GamesView {
     link.textContent = url;
     link.target = '_blank';
     link.rel = 'noopener noreferrer';
+
+    if (prefix) {
+      line.append(prefix);
+    }
+
     line.appendChild(link);
     item.appendChild(line);
   }
 
+  // адрес, который версия на модерации принесёт при одобрении: строка
+  // появляется, только если он отличается от текущего
+  _appendPendingRepo(item, game) {
+    if (game.pendingRepoUrl && game.pendingRepoUrl !== game.repoUrl) {
+      this._appendRepo(item, game.pendingRepoUrl, 'After approval: ');
+    }
+  }
+
   _statusLine(game) {
     const status = STATUS_TITLES[game.status] ?? game.status;
     const date = game.createdAt

package/src/client/components/view/Lobby.js

@@ -1,6 +1,5 @@
 import Publisher from '../../../lib/Publisher.js';
-import { ENGINE_PROJECT_URL, ENGINE_VERSION } from '../../lib/engineVersion.js';
-import { renderProjectLink } from '../../lib/footerLink.js';
+import { ENGINE_VERSION } from '../../lib/engineVersion.js';
 import { absoluteLink, formatRoomLink } from '../../lib/roomLink.js';
 
 // Singleton LobbyView
@@ -65,11 +64,6 @@ export default class LobbyView {
       version.textContent = ENGINE_VERSION;
     }
 
-    renderProjectLink(
-      document.getElementById(elems.linkId),
-      ENGINE_PROJECT_URL,
-    );
-
     // заголовок игры для "<TITLE> TOP-N" (SVG-ориентир) — задаётся controller'ом
     // при выборе игры (сама модель не хранит title манифеста)
     this._gameTitle = '';

package/src/client/debug.js

@@ -1,4 +1,4 @@
-// Браузерная половина отладочного контура (этап 6 плана plan/done/ai-debug).
+// Браузерная половина отладочного контура.
 //
 // Всё, что headless-прогон не воспроизводит — реальный WebRTC, PixiJS, живой
 // ввод человека — читается и записывается отсюда: `window.__vimpDebug`

package/src/client/lib/authApi.js

@@ -1,4 +1,4 @@
-// REST-клиент auth-сервиса (packages/auth): регистрация, сессия, OAuth,
+// REST-клиент auth-сервиса: регистрация, сессия, OAuth,
 // управление профилем. Без DOM; fetch инъектируется (тесты).
 //
 // Каждый метод возвращает { ok: true, status, data } или

package/src/client/lib/diagnostics.js

@@ -1,4 +1,4 @@
-// Журнал клиентских ошибок (plan/client-reports, этап 3): неперехваченные
+// Журнал клиентских ошибок: неперехваченные
 // ошибки и отклонения страницы, ошибки Worker'а хоста, нарушения CSP и явные
 // warn/capture плагинов уходят на свой же бокс (POST /client-reports), а тот
 // пересылает их в центральный журнал.
@@ -175,7 +175,7 @@ function noop() {}
  * @param {number} [opts.flushDelayMs=2000] - задержка первой отправки
  * @param {number} [opts.minIntervalMs=10000] - интервал между отправками по
  *   таймеру; прямой flush() его не ждёт
- * @returns {{ capture, warn, flush, setContext, install }}
+ * @returns {{ capture, ignore, warn, flush, setContext, install }}
  */
 export function createDiagnostics({
   url,
@@ -189,6 +189,7 @@ export function createDiagnostics({
   if (!url) {
     return {
       capture: noop,
+      ignore: noop,
       warn: noop,
       flush: noop,
       setContext: noop,
@@ -211,7 +212,7 @@ export function createDiagnostics({
   let busy = false;
 
   function record(item) {
-    const key = `${item.source}|${item.kind}|${item.code ?? item.message}|${topFrame(item.stack)}`;
+    const key = `${item.source}|${item.kind}|${item.code ?? item.message}|${item.code ? '' : topFrame(item.stack)}`;
     const at = now();
     const known = records.get(key);
 
@@ -276,8 +277,22 @@ export function createDiagnostics({
     }
   }
 
+  // ошибки, о которых вызывающий уже позаботился сам (сбой сети при
+  // загрузке): перехватчик окна их не записывает
+  const ignored = new WeakSet();
+
+  function ignore(error) {
+    if (error !== null && typeof error === 'object') {
+      ignored.add(error);
+    }
+  }
+
   function capture(error, { source = 'client', kind = 'error' } = {}) {
     guarded(() => {
+      if (error !== null && typeof error === 'object' && ignored.has(error)) {
+        return;
+      }
+
       const raw =
         error !== null && error !== undefined && error.message !== undefined
           ? error.message
@@ -485,5 +500,5 @@ export function createDiagnostics({
     };
   }
 
-  return { capture, warn, flush, setContext, install };
+  return { capture, ignore, warn, flush, setContext, install };
 }

package/src/client/lib/engineVersion.js

@@ -7,11 +7,5 @@
 // бандлу (в npm-тарболле vimp-engine package.json есть всегда, поэтому
 // standalone SDK собирается у игры тем же импортом).
 import pkg from '../../../package.json' with { type: 'json' };
-import { resolveProjectUrl } from '../../lib/packageLink.js';
 
 export const ENGINE_VERSION = pkg.version;
-
-// адрес проекта для ссылки в футере лобби — то же поле, что мастер отдаёт
-// про пакет игры (GameCatalog.packageUrl), чтобы оба футера строил один
-// projectLink
-export const ENGINE_PROJECT_URL = resolveProjectUrl(pkg);

package/src/client/lib/footerLink.js

@@ -1,29 +1,30 @@
-import { projectLink } from '../../lib/packageLink.js';
-
-// Ссылка в футере лобби и формы входа. Один рендер на оба экрана: лобби
-// подставляет адрес проекта движка, форма входа — адрес игры из манифеста.
-//
-// Адреса нет (пакет не объявил repository/homepage) — якорь гасится, а не
-// прячется: ячейка футера остаётся пустой, и раскладка space-between не едет.
+// Ссылка на документацию в футере формы входа игры. Показывается только в
+// dev-сборке: разработчик игры при локальном запуске видит, где читать
+// документацию, а игрок на проде — нет. Футер лобби несёт ту же ссылку
+// статичной разметкой (lobby.pug). Тот же адрес — литералом в lobby.pug и в
+// `homepage` пакета; совпадение сторожит tests/client/footerLink.test.js.
+export const DOCS_URL = 'https://docs.vimp.lgick.dev';
 
 /**
  * @param {HTMLAnchorElement|null} anchor - якорь футера
- * @param {string|null} url - адрес проекта (resolveProjectUrl)
+ * @param {boolean} enabled - true только в dev-сборке
  */
-export function renderProjectLink(anchor, url) {
+export function renderDocsLink(anchor, enabled) {
   if (!anchor) {
     return;
   }
 
-  const link = projectLink(url);
-
-  if (!link) {
+  if (!enabled) {
     anchor.textContent = '';
     anchor.removeAttribute('href');
+    anchor.removeAttribute('target');
+    anchor.removeAttribute('rel');
 
     return;
   }
 
-  anchor.textContent = link.label;
-  anchor.href = link.url;
+  anchor.textContent = 'docs';
+  anchor.href = DOCS_URL;
+  anchor.target = '_blank';
+  anchor.rel = 'noopener';
 }

package/src/client/lib/formBuilder.js

@@ -4,9 +4,9 @@ import { resolveDescriptor } from '../../lib/formControls.js';
 import { toDisplay, toStored, isNumericField } from '../../lib/formUnit.js';
 
 // Общий билдер полей форм (room-форма и auth-форма используют один
-// контракт дескрипторов — docs/en/plugin-api.md, раздел "Form schema").
-// control: 'select'|'text'|'checkbox'|'radio'; все контролы — нативные
-// элементы формы, без визуальной кастомизации.
+// контракт дескрипторов — docs.vimp.lgick.dev/en/plugin-api, раздел "Form
+// schema"). control: 'select'|'text'|'checkbox'|'radio'; все контролы —
+// нативные элементы формы, без визуальной кастомизации.
 //
 // Имя контрола приезжает от игры и разрешается через append-only реестр
 // (lib/formControls.js): имена, выведенные из эксплуатации в v3 ('range',
@@ -270,7 +270,8 @@ const builders = {
 // control» на имени, которое реестр считает живым
 export const FORM_CONTROLS = Object.keys(builders);
 
-// строит одно поле формы по дескриптору (docs/en/plugin-api.md, "Form schema")
+// строит одно поле формы по дескриптору (docs.vimp.lgick.dev/en/plugin-api,
+// "Form schema")
 export function buildField(descriptor, ctx = {}) {
   // алиас выведенного контрола ('range' → numeric 'text') разрешается
   // здесь же, где строится поле, и теми же правилами, что в валидации
@@ -291,10 +292,10 @@ export function buildField(descriptor, ctx = {}) {
 }
 
 // засеивает default каждого дескриптора room-формы значением из roomDefaults
-// (docs/en/plugin-api.md "Form schema": roomDefaults остаётся единственным
-// источником значений по умолчанию); явный descriptor.default, если он есть
-// в схеме, побеждает. Вынесено из populateRoomForm (main.js), чтобы этот же
-// код был накрыт тестом, а не продублирован в нём
+// (docs.vimp.lgick.dev/en/plugin-api "Form schema": roomDefaults остаётся
+// единственным источником значений по умолчанию); явный descriptor.default,
+// если он есть в схеме, побеждает. Вынесено из populateRoomForm (main.js),
+// чтобы этот же код был накрыт тестом, а не продублирован в нём
 export function mergeRoomDefaults(descriptors, roomDefaults) {
   return descriptors.map(descriptor => ({
     default: roomDefaults[descriptor.name],

package/src/client/lib/retryOnNetworkError.js

@@ -0,0 +1,60 @@
+// Повтор запроса загрузки при сбое сети. fetch отклоняется TypeError'ом,
+// только когда ответа нет вовсе (обрыв, смена сети, вкладка из фона);
+// HTTP-статус и разбор ответа сбоем сети не являются и не повторяются.
+// Повторяется только сам вызов fetch: TypeError из разбора ответа — ошибка
+// кода, а не сети.
+
+// паузы перед повторами: три запроса, отказ не позже ~2 с сверх самих запросов
+export const BOOT_RETRY_DELAYS_MS = [500, 1500];
+
+const defaultSleep = ms => new Promise(resolve => setTimeout(resolve, ms));
+
+/** Сбой сети, оставшийся после повторов; отличает его от ошибок кода. */
+export class NetworkFailure extends Error {
+  constructor(cause) {
+    super(cause?.message ?? 'Network failure', { cause });
+    this.name = 'NetworkFailure';
+  }
+}
+
+export const isNetworkFailure = error => error instanceof NetworkFailure;
+
+/**
+ * Оборачивает отказ чтения тела ответа: SyntaxError — это мусор в JSON,
+ * любой другой отказ (TypeError обрыва) — сбой сети.
+ * @param {Error} error
+ * @returns {Error}
+ */
+export const bodyReadFailure = error =>
+  error instanceof SyntaxError ? error : new NetworkFailure(error);
+
+/**
+ * @param {Function} doFetch - (...args) => Promise<Response>: сам fetch.
+ * @param {*} url
+ * @param {Object} [options]
+ * @param {number[]} [options.delaysMs] - паузы перед повторами, мс.
+ * @param {Function} [options.sleep] - (ms) => Promise (тесты подставляют свою).
+ * @returns {Promise<Response>} ответ первой удавшейся попытки; отклоняется
+ *   NetworkFailure, когда сеть не ответила во всех попытках.
+ */
+export async function fetchRetrying(
+  doFetch,
+  url,
+  { delaysMs = BOOT_RETRY_DELAYS_MS, sleep = defaultSleep } = {},
+) {
+  for (let attempt = 0; ; attempt += 1) {
+    try {
+      return await doFetch(url);
+    } catch (e) {
+      if (!(e instanceof TypeError)) {
+        throw e;
+      }
+
+      if (attempt >= delaysMs.length) {
+        throw new NetworkFailure(e);
+      }
+
+      await sleep(delaysMs[attempt]);
+    }
+  }
+}