@escapenavigator/hooks 1.10.150 → 1.10.152

package/dist/index.d.ts

@@ -1,5 +1,6 @@
 export * from './functional-popover';
 export * from './input-tel';
+export * from './lazy-with-retry';
 export * from './players-and-variation-picker';
 export * from './use-debounced-value';
 export * from './use-localstore-state';

package/dist/index.js

@@ -16,6 +16,7 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./functional-popover"), exports);
 __exportStar(require("./input-tel"), exports);
+__exportStar(require("./lazy-with-retry"), exports);
 __exportStar(require("./players-and-variation-picker"), exports);
 __exportStar(require("./use-debounced-value"), exports);
 __exportStar(require("./use-localstore-state"), exports);

package/dist/lazy-with-retry.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Обёртка над `React.lazy`, устойчивая к «исчезнувшим» чанкам после деплоя.
+ * Общая для всех фронтов (app / orders), завязана на React → живёт в hooks.
+ *
+ * Кейс: у пользователя открыта старая вкладка с index-OLD.js. После релиза
+ * этого чанка на CDN уже нет → `import()` бросает (формулировки зависят от
+ * браузера — см. `isStaleChunkError` в @escapenavigator/utils):
+ *   - "Failed to fetch dynamically imported module" (Chrome/Safari)
+ *   - "error loading dynamically imported module" (Firefox)
+ *   - "Importing a module script failed"
+ *   - "ChunkLoadError" / "Loading chunk N failed"
+ *
+ * Алгоритм:
+ *   1. Один retry с небольшой паузой — на случай флапа сети/прогрева CDN.
+ *   2. Если опять упало и похоже на «протухший чанк» — один раз перезагружаем
+ *      страницу с `?v=<ts>`, чтобы выкинуть HTTP-кэш. Флаг в sessionStorage
+ *      защищает от циклической перезагрузки.
+ */
+import { ComponentType, lazy } from 'react';
+/** Query-параметр cache-bust после reload; не должен попадать в `where` таблиц. */
+export declare const CHUNK_RELOAD_QUERY_PARAM = "v";
+/**
+ * Убирает служебный `?v=` из адресной строки (replaceState, без reload).
+ * Вызываем до первого рендера и после успешной загрузки lazy-чанка.
+ */
+export declare const stripChunkReloadQueryParam: () => boolean;
+export declare function lazyWithRetry<T extends ComponentType<any>>(factory: () => Promise<{
+    default: T;
+}>): ReturnType<typeof lazy<T>>;

package/dist/lazy-with-retry.js

@@ -0,0 +1,96 @@
+"use strict";
+/**
+ * Обёртка над `React.lazy`, устойчивая к «исчезнувшим» чанкам после деплоя.
+ * Общая для всех фронтов (app / orders), завязана на React → живёт в hooks.
+ *
+ * Кейс: у пользователя открыта старая вкладка с index-OLD.js. После релиза
+ * этого чанка на CDN уже нет → `import()` бросает (формулировки зависят от
+ * браузера — см. `isStaleChunkError` в @escapenavigator/utils):
+ *   - "Failed to fetch dynamically imported module" (Chrome/Safari)
+ *   - "error loading dynamically imported module" (Firefox)
+ *   - "Importing a module script failed"
+ *   - "ChunkLoadError" / "Loading chunk N failed"
+ *
+ * Алгоритм:
+ *   1. Один retry с небольшой паузой — на случай флапа сети/прогрева CDN.
+ *   2. Если опять упало и похоже на «протухший чанк» — один раз перезагружаем
+ *      страницу с `?v=<ts>`, чтобы выкинуть HTTP-кэш. Флаг в sessionStorage
+ *      защищает от циклической перезагрузки.
+ */
+/* eslint-disable @typescript-eslint/no-explicit-any */
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.stripChunkReloadQueryParam = exports.CHUNK_RELOAD_QUERY_PARAM = void 0;
+exports.lazyWithRetry = lazyWithRetry;
+const is_stale_chunk_error_1 = require("@escapenavigator/utils/dist/is-stale-chunk-error");
+const react_1 = require("react");
+const RELOAD_FLAG = 'lazy_chunk_reload_attempted';
+/** Query-параметр cache-bust после reload; не должен попадать в `where` таблиц. */
+exports.CHUNK_RELOAD_QUERY_PARAM = 'v';
+/**
+ * Убирает служебный `?v=` из адресной строки (replaceState, без reload).
+ * Вызываем до первого рендера и после успешной загрузки lazy-чанка.
+ */
+const stripChunkReloadQueryParam = () => {
+    if (typeof window === 'undefined')
+        return false;
+    const url = new URL(window.location.href);
+    if (!url.searchParams.has(exports.CHUNK_RELOAD_QUERY_PARAM))
+        return false;
+    url.searchParams.delete(exports.CHUNK_RELOAD_QUERY_PARAM);
+    const next = url.pathname + (url.searchParams.toString() ? `?${url.searchParams}` : '') + url.hash;
+    window.history.replaceState(window.history.state, '', next);
+    return true;
+};
+exports.stripChunkReloadQueryParam = stripChunkReloadQueryParam;
+const reloadOnce = () => {
+    try {
+        if (sessionStorage.getItem(RELOAD_FLAG))
+            return;
+        sessionStorage.setItem(RELOAD_FLAG, '1');
+    }
+    catch (_a) {
+        // sessionStorage может быть недоступен (Safari privacy / iframe);
+        // тогда просто перезагрузимся, лучше один лишний reload, чем белый экран.
+    }
+    const url = new URL(window.location.href);
+    url.searchParams.set(exports.CHUNK_RELOAD_QUERY_PARAM, Date.now().toString(36));
+    window.location.replace(url.toString());
+};
+function lazyWithRetry(factory) {
+    return (0, react_1.lazy)(() => __awaiter(this, void 0, void 0, function* () {
+        try {
+            const mod = yield factory();
+            try {
+                sessionStorage.removeItem(RELOAD_FLAG);
+            }
+            catch (_a) {
+                // см. reloadOnce: storage может быть недоступен
+            }
+            (0, exports.stripChunkReloadQueryParam)();
+            return mod;
+        }
+        catch (firstError) {
+            if (!(0, is_stale_chunk_error_1.isStaleChunkError)(firstError))
+                throw firstError;
+            try {
+                yield new Promise((r) => setTimeout(r, 350));
+                return yield factory();
+            }
+            catch (secondError) {
+                if ((0, is_stale_chunk_error_1.isStaleChunkError)(secondError)) {
+                    reloadOnce();
+                }
+                throw secondError;
+            }
+        }
+    }));
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@escapenavigator/hooks",
-  "version": "1.10.150",
+  "version": "1.10.152",
   "publishConfig": {
     "access": "public"
   },
@@ -14,9 +14,9 @@
     "test": "jest"
   },
   "dependencies": {
-    "@escapenavigator/services": "^1.10.158",
-    "@escapenavigator/types": "^1.10.148",
-    "@escapenavigator/utils": "^1.10.153",
+    "@escapenavigator/services": "^1.10.160",
+    "@escapenavigator/types": "^1.10.149",
+    "@escapenavigator/utils": "^1.10.155",
     "libphonenumber-js": "^1.12.24",
     "react": "19.2.6",
     "react-phone-input-2": "^2.15.1"
@@ -32,5 +32,5 @@
     "ts-jest": "^29.1.1",
     "typescript": "^5.6"
   },
-  "gitHead": "141d0c0d4b5a5bbf13f481696d604cb4953a8bdb"
+  "gitHead": "e868f8962dfa6caab506d64bd4c6c091514e44a2"
 }