1e4925007d
SPA — долгоживущий клиент: вкладку держат часами, сервер за это время передеплоивают. Старый index.html ссылается на content-hashed чанки, которых в новом образе нет → ленивый import() → catch-all отдаёт index.html как text/html → WebKit «not a valid JavaScript MIME type» (наблюдали в проде). Реактивный предохранитель (chunk-error-boundary) ловит УЖЕ случившуюся ошибку. Делаем сигнал ПРОАКТИВНЫМ: сервер сообщает версию по существующему WS, клиент сравнивает и делает guarded reload ДО битого чанка. closes #481 - Единый источник версии: vite.config.ts вычисляет resolveAppVersion РОВНО раз → и в define.APP_VERSION, и в плагине, пишущем dist/version.json. Бандл и файл тождественны by construction. Сервер читает client/dist/version.json при старте (client-version.ts: resolveClientDistPath вынесен из static.module — единый источник пути; readClientBuildVersion → версия или '' на любой ошибке, fail-safe). НИКАКИХ Docker/ENV-изменений. - WS: отдельное событие app-version {version} (НЕ в message/WebSocketEvent — член без operation сломал бы union). ws.gateway читает версию в onModuleInit + boot-лог ACTIVE/DISABLED; emit в handleConnection (success-ветка, после join). ТОЛЬКО per-connect анонс, БЕЗ broadcast (broadcast в кластере → thundering-herd reload флота; естественный реконнект покрывает и single-container, и кластер). - Клиент: listener навешан СИНХРОННО в том же useEffect, что создаёт сокет (до connect — иначе гонка с немедленным emit сервера). Чистая decideVersionAction (reload|banner|noop; пустая версия → noop fail-safe). Грязная оболочка triggerGuardedReload: модульный latch, hidden→немедленный reload, visible→баннер + reload-on-hidden {once}, фикс-id закрываемый баннер с кнопкой «Обновить». - Общий one-shot флаг: reload-guard.ts (hasAutoReloaded/markAutoReloaded над существующим chunk-reload-attempted); chunk-load-error-boundary переведён на него. Проактивный + реактивный reload делят ОДИН счётчик → максимум одна авто-перезагрузка за сессию суммарно; permanent skew / oscillation / disabled storage → после первого reload только баннер, петли нет (проверено трассировкой). Проверка: server jest client-version 7/7; client vitest version-coherence+ reload-guard+guarded-reload 16/16 (coverage 97.9%). Build-proof единого источника: APP_VERSION=test-A → dist/version.json {"version":"test-A"} + вшито в бандл. Полный staging-приём (docker build-arg, WS-кадры в DevTools, мульти-таб) — вне автостенда, шаги приёмки #481 (крит.1-4) на ручную проверку. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
65 lines
1.5 KiB
TypeScript
65 lines
1.5 KiB
TypeScript
import { describe, it, expect } from "vitest";
|
|
import { decideVersionAction } from "./version-coherence";
|
|
|
|
describe("decideVersionAction", () => {
|
|
it("noop when the server version is empty (fail-safe)", () => {
|
|
expect(
|
|
decideVersionAction({
|
|
serverVersion: "",
|
|
clientVersion: "v1",
|
|
autoReloadUsed: false,
|
|
}),
|
|
).toBe("noop");
|
|
});
|
|
|
|
it("noop when the client version is empty (fail-safe)", () => {
|
|
expect(
|
|
decideVersionAction({
|
|
serverVersion: "v1",
|
|
clientVersion: "",
|
|
autoReloadUsed: false,
|
|
}),
|
|
).toBe("noop");
|
|
});
|
|
|
|
it("noop when versions are equal (in sync)", () => {
|
|
expect(
|
|
decideVersionAction({
|
|
serverVersion: "v1",
|
|
clientVersion: "v1",
|
|
autoReloadUsed: false,
|
|
}),
|
|
).toBe("noop");
|
|
});
|
|
|
|
it("reload on a real mismatch the first time this session", () => {
|
|
expect(
|
|
decideVersionAction({
|
|
serverVersion: "test-B",
|
|
clientVersion: "test-A",
|
|
autoReloadUsed: false,
|
|
}),
|
|
).toBe("reload");
|
|
});
|
|
|
|
it("banner on a mismatch once the session auto-reload is spent", () => {
|
|
expect(
|
|
decideVersionAction({
|
|
serverVersion: "test-B",
|
|
clientVersion: "test-A",
|
|
autoReloadUsed: true,
|
|
}),
|
|
).toBe("banner");
|
|
});
|
|
|
|
it("equal versions stay noop even if auto-reload was already used", () => {
|
|
expect(
|
|
decideVersionAction({
|
|
serverVersion: "v1",
|
|
clientVersion: "v1",
|
|
autoReloadUsed: true,
|
|
}),
|
|
).toBe("noop");
|
|
});
|
|
});
|