@ovineko/spa-guard 0.0.1-alpha-5 → 0.0.1-alpha-7

package/README.md

@@ -76,7 +76,7 @@ export default defineConfig({
         endpoint: "/api/beacon",
       },
       errors: {
-        ignore: [], // Filter out specific error messages from reporting
+        ignore: [], // Error substrings to fully skip (no log, no beacon, no reload)
         forceRetry: [], // Custom error messages that trigger retry/reload (like chunk errors)
       },
       useRetryId: true, // Use query parameters for cache busting (default: true)
@@ -274,7 +274,7 @@ spaGuardVitePlugin({
 
   // Error filtering and retry
   errors: {
-    ignore: [], // Array of error message substrings to ignore
+    ignore: [], // Array of error message substrings to fully skip (no log, no beacon, no reload)
     forceRetry: [], // Array of error message substrings that trigger retry/reload
   },
 
@@ -322,7 +322,7 @@ interface Options {
   };
 
   errors?: {
-    ignore?: string[]; // Error message substrings to filter out (default: [])
+    ignore?: string[]; // Error message substrings to fully skip (no log, no beacon, no reload) (default: [])
     forceRetry?: string[]; // Error message substrings that trigger retry/reload (default: [])
   };
 
@@ -800,7 +800,7 @@ function createDebugger(options?: {
 
 - Framework-agnostic vanilla JS (no React dependency)
 - Fixed-position overlay panel with toggle open/close
-- Error scenario buttons: ChunkLoadError, Network Timeout, Sync Runtime Error, Async Runtime Error, Finally Error
+- Error scenario buttons: ChunkLoadError, Network Timeout, Sync Runtime Error, Async Runtime Error, Finally Error, ForceRetry Error, Unhandled Rejection
 - Button visual states (default, loading, triggered)
 - Live spa-guard state display (attempt, isWaiting, isFallbackShown)
 - Scrollable event history with timestamps
@@ -1138,7 +1138,7 @@ interface Options {
   };
 
   errors?: {
-    ignore?: string[]; // Error message substrings to filter out (default: [])
+    ignore?: string[]; // Error message substrings to fully skip (no log, no beacon, no reload) (default: [])
     forceRetry?: string[]; // Error message substrings that trigger retry/reload (default: [])
   };
 
@@ -1521,8 +1521,8 @@ import spaGuardEslint from "@ovineko/spa-guard/eslint";
 
 ## Build Sizes
 
-- **Production:** `dist-inline/index.js` ~8.3 KB minified (Terser)
-- **Trace:** `dist-inline-trace/index.js` ~13.3 KB minified (Terser)
+- **Production:** `dist-inline/index.js` ~8.9 KB minified (Terser)
+- **Trace:** `dist-inline-trace/index.js` ~13.8 KB minified (Terser)
 - **Main library:** `dist/` varies by export
 
 ## Advanced Usage
@@ -1646,7 +1646,7 @@ spaGuardVitePlugin({
 });
 ```
 
-**`errors.ignore`** - Errors containing any of these substrings will not be logged to console and beacons will not be sent. Case-sensitive substring matching.
+**`errors.ignore`** - Errors containing any of these substrings are fully ignored: no console log, no beacon, no reload, and no further processing. The error handler returns immediately after the ignore check. Case-sensitive substring matching.
 
 **`errors.forceRetry`** - Errors containing any of these substrings will trigger the same retry/reload process as chunk load errors (calls `attemptReload()`). Useful for custom error patterns that indicate a stale deployment. Case-sensitive substring matching.
 
@@ -1709,6 +1709,16 @@ throw new ForceRetryError("stale module detected");
 
 // Works with no message too
 throw new ForceRetryError();
+
+// Wrap an original error with { cause } (ES2022 ErrorOptions)
+try {
+  await initializeAuth();
+} catch (error) {
+  throw new ForceRetryError("Failed to init auth", { cause: error });
+}
+
+// cause-only (no custom message)
+throw new ForceRetryError(undefined, { cause: originalError });
 ```
 
 **Use cases:**
@@ -1729,6 +1739,11 @@ err.name; // "ForceRetryError"
 err.message; // "__SPA_GUARD_FORCE_RETRY__version mismatch"
 err instanceof ForceRetryError; // true
 err instanceof Error; // true
+
+// With cause
+const original = new TypeError("network timeout");
+const err2 = new ForceRetryError("version mismatch", { cause: original });
+err2.cause; // TypeError: network timeout
 ```
 
 ### Custom Retry Strategy

package/dist/{chunk-LGPIRNKE.js → chunk-4N3XJ7VS.js}

@@ -1,9 +1,9 @@
-import {
-  getLogger
-} from "./chunk-T5RWH2HR.js";
 import {
   getOptions
-} from "./chunk-G6QM353W.js";
+} from "./chunk-UXLGA3TG.js";
+import {
+  getLogger
+} from "./chunk-BLVJHZST.js";
 
 // src/common/checkVersion.ts
 var versionCheckInterval = null;

package/dist/{chunk-T5RWH2HR.js → chunk-BLVJHZST.js}

@@ -7,6 +7,15 @@ import {
   loggerWindowKey
 } from "./chunk-EDRTFPCN.js";
 
+// src/common/errors/ForceRetryError.ts
+var FORCE_RETRY_MAGIC = "__SPA_GUARD_FORCE_RETRY__";
+var ForceRetryError = class extends Error {
+  constructor(message, options) {
+    super(`${FORCE_RETRY_MAGIC}${message ?? ""}`, options);
+    this.name = "ForceRetryError";
+  }
+};
+
 // src/common/events/internal.ts
 if (globalThis.window && !globalThis.window[eventSubscribersWindowKey]) {
   globalThis.window[eventSubscribersWindowKey] = /* @__PURE__ */ new Set();
@@ -255,6 +264,8 @@ var getRetryInfoForBeacon = () => {
 };
 
 export {
+  FORCE_RETRY_MAGIC,
+  ForceRetryError,
   setLogger,
   getLogger,
   emitEvent,

package/dist/{chunk-RXW44IWI.js → chunk-D5NHZ5BD.js}

@@ -5,20 +5,22 @@ import {
   attemptReload,
   isChunkError,
   sendBeacon,
-  shouldForceRetry
-} from "./chunk-RFGT43OM.js";
-import {
-  getRetryInfoForBeacon
-} from "./chunk-T5RWH2HR.js";
+  shouldForceRetry,
+  shouldIgnoreMessages
+} from "./chunk-U2DZSTRT.js";
 import {
   defaultErrorFallbackHtml,
   defaultLoadingFallbackHtml
-} from "./chunk-G6QM353W.js";
+} from "./chunk-UXLGA3TG.js";
+import {
+  getRetryInfoForBeacon
+} from "./chunk-BLVJHZST.js";
 
 // src/common/DefaultErrorFallback.tsx
 import { useLayoutEffect, useMemo, useRef } from "react";
 import { jsx } from "react/jsx-runtime";
 var escapeHtml = (str) => str.replaceAll("&", "&amp;").replaceAll("<", "&lt;").replaceAll(">", "&gt;").replaceAll('"', "&quot;");
+var reloadHandler = () => location.reload();
 var DefaultErrorFallback = ({
   error,
   isChunkError: isChunk,
@@ -52,14 +54,19 @@ var DefaultErrorFallback = ({
     if (!el) {
       return;
     }
-    if (onReset) {
-      const tryAgainBtn = el.querySelector('[data-spa-guard-action="try-again"]');
-      if (tryAgainBtn) {
-        const handler = () => onReset();
-        tryAgainBtn.addEventListener("click", handler);
-        return () => tryAgainBtn.removeEventListener("click", handler);
-      }
+    const reloadBtn = el.querySelector('[data-spa-guard-action="reload"]');
+    reloadBtn?.addEventListener("click", reloadHandler);
+    const tryAgainHandler = onReset ? () => onReset() : null;
+    const tryAgainBtn = onReset ? el.querySelector('[data-spa-guard-action="try-again"]') : null;
+    if (tryAgainHandler && tryAgainBtn) {
+      tryAgainBtn.addEventListener("click", tryAgainHandler);
     }
+    return () => {
+      reloadBtn?.removeEventListener("click", reloadHandler);
+      if (tryAgainHandler && tryAgainBtn) {
+        tryAgainBtn.removeEventListener("click", tryAgainHandler);
+      }
+    };
   }, [onReset, html]);
   const innerHtml = useMemo(() => ({ __html: html }), [html]);
   return /* @__PURE__ */ jsx("div", { dangerouslySetInnerHTML: innerHtml, ref: containerRef });
@@ -78,8 +85,11 @@ var handleErrorWithSpaGuard = (error, options) => {
     onError?.(error);
   } catch {
   }
-  const isChunk = isChunkError(error);
   const errorMessage = error instanceof Error ? error.message : String(error);
+  if (shouldIgnoreMessages([errorMessage])) {
+    return;
+  }
+  const isChunk = isChunkError(error);
   const isForceRetry = shouldForceRetry([errorMessage]);
   if ((isChunk || isForceRetry) && autoRetryChunkErrors) {
     attemptReload(error);

package/dist/{chunk-RFGT43OM.js → chunk-U2DZSTRT.js}

@@ -1,7 +1,8 @@
 import {
-  FORCE_RETRY_MAGIC
-} from "./chunk-L5UEVGWR.js";
+  getOptions
+} from "./chunk-UXLGA3TG.js";
 import {
+  FORCE_RETRY_MAGIC,
   clearLastReloadTime,
   clearRetryAttemptFromUrl,
   clearRetryStateFromUrl,
@@ -15,10 +16,7 @@ import {
   setLastReloadTime,
   setLastRetryResetInfo,
   shouldResetRetryCycle
-} from "./chunk-T5RWH2HR.js";
-import {
-  getOptions
-} from "./chunk-G6QM353W.js";
+} from "./chunk-BLVJHZST.js";
 import {
   RETRY_ATTEMPT_PARAM,
   RETRY_ID_PARAM
@@ -60,7 +58,7 @@ var getErrorMessage = (error) => {
 // src/common/shouldIgnore.ts
 var shouldIgnoreMessages = (messages) => {
   const options = getOptions();
-  const ignorePatterns = options.errors?.ignore ?? [];
+  const ignorePatterns = (options.errors?.ignore ?? []).filter((p) => p !== "");
   if (ignorePatterns.length === 0) {
     return false;
   }
@@ -71,7 +69,9 @@ var shouldIgnoreMessages = (messages) => {
 };
 var shouldForceRetry = (messages) => {
   const options = getOptions();
-  const forceRetryPatterns = [...options.errors?.forceRetry ?? [], FORCE_RETRY_MAGIC];
+  const forceRetryPatterns = [...options.errors?.forceRetry ?? [], FORCE_RETRY_MAGIC].filter(
+    (p) => p !== ""
+  );
   const validMessages = messages.filter((msg) => typeof msg === "string");
   return validMessages.some(
     (message) => forceRetryPatterns.some((pattern) => message.includes(pattern))
@@ -95,7 +95,7 @@ var sendBeacon = (beacon) => {
   const body = JSON.stringify(enrichedBeacon);
   const isSendBeaconAvailable = typeof globalThis.window?.navigator?.sendBeacon === "function";
   const isSentBeacon = isSendBeaconAvailable && globalThis.window.navigator.sendBeacon(options.reportBeacon.endpoint, body);
-  if (!isSentBeacon) {
+  if (!isSentBeacon && typeof fetch === "function") {
     fetch(options.reportBeacon.endpoint, { body, keepalive: true, method: "POST" }).catch(
       (error) => {
         getLogger()?.beaconSendFailed(error);
@@ -122,109 +122,116 @@ var attemptReload = (error) => {
     getLogger()?.reloadAlreadyScheduled(error);
     return;
   }
-  const options = getOptions();
-  const reloadDelays = options.reloadDelays ?? [1e3, 2e3, 5e3];
-  const useRetryId = options.useRetryId ?? true;
-  const enableRetryReset = options.enableRetryReset ?? true;
-  const minTimeBetweenResets = options.minTimeBetweenResets ?? 5e3;
-  let retryState;
-  if (useRetryId) {
-    retryState = getRetryStateFromUrl();
-  } else {
-    const attempt = getRetryAttemptFromUrl();
-    retryState = attempt === null ? null : { retryAttempt: attempt, retryId: generateRetryId() };
-  }
-  let currentAttempt = retryState ? retryState.retryAttempt : 0;
-  let retryId = retryState?.retryId ?? generateRetryId();
-  getLogger()?.retryCycleStarting(retryId, currentAttempt);
-  const retryEnabled = isDefaultRetryEnabled();
-  emitEvent({
-    error,
-    isRetrying: retryEnabled && currentAttempt >= 0 && currentAttempt < reloadDelays.length,
-    name: "chunk-error"
-  });
-  if (!retryEnabled) {
-    return;
-  }
-  if (enableRetryReset && retryState && retryState.retryAttempt > 0 && shouldResetRetryCycle(retryState, reloadDelays, minTimeBetweenResets)) {
-    const lastReload = getLastReloadTime();
-    const timeSinceReload = lastReload ? Date.now() - lastReload.timestamp : 0;
-    clearRetryStateFromUrl();
-    clearLastReloadTime();
-    setLastRetryResetInfo(retryState.retryId);
-    const errorMsg2 = String(error);
-    emitEvent(
-      {
-        name: "retry-reset",
-        previousAttempt: retryState.retryAttempt,
-        previousRetryId: retryState.retryId,
-        timeSinceReload
-      },
-      { silent: shouldIgnoreMessages([errorMsg2]) }
-    );
-    currentAttempt = 0;
-    retryId = generateRetryId();
-  }
-  if (currentAttempt === -1) {
-    const errorMsg2 = String(error);
-    if (!shouldIgnoreMessages([errorMsg2])) {
-      getLogger()?.fallbackAlreadyShown(error);
+  reloadScheduled = true;
+  try {
+    const options = getOptions();
+    const reloadDelays = options.reloadDelays ?? [1e3, 2e3, 5e3];
+    const useRetryId = options.useRetryId ?? true;
+    const enableRetryReset = options.enableRetryReset ?? true;
+    const minTimeBetweenResets = options.minTimeBetweenResets ?? 5e3;
+    let retryState;
+    if (useRetryId) {
+      retryState = getRetryStateFromUrl();
+    } else {
+      const attempt = getRetryAttemptFromUrl();
+      retryState = attempt === null ? null : { retryAttempt: attempt, retryId: generateRetryId() };
     }
-    showFallbackUI();
-    return;
-  }
-  if (currentAttempt >= reloadDelays.length) {
-    const errorMsg2 = String(error);
+    let currentAttempt = retryState ? retryState.retryAttempt : 0;
+    let retryId = retryState?.retryId ?? generateRetryId();
+    getLogger()?.retryCycleStarting(retryId, currentAttempt);
+    const retryEnabled = isDefaultRetryEnabled();
+    emitEvent({
+      error,
+      isRetrying: retryEnabled && currentAttempt >= 0 && currentAttempt < reloadDelays.length,
+      name: "chunk-error"
+    });
+    if (!retryEnabled) {
+      reloadScheduled = false;
+      return;
+    }
+    if (enableRetryReset && retryState && retryState.retryAttempt > 0 && shouldResetRetryCycle(retryState, reloadDelays, minTimeBetweenResets)) {
+      const lastReload = getLastReloadTime();
+      const timeSinceReload = lastReload ? Date.now() - lastReload.timestamp : 0;
+      clearRetryStateFromUrl();
+      clearLastReloadTime();
+      setLastRetryResetInfo(retryState.retryId);
+      const errorMsg2 = String(error);
+      emitEvent(
+        {
+          name: "retry-reset",
+          previousAttempt: retryState.retryAttempt,
+          previousRetryId: retryState.retryId,
+          timeSinceReload
+        },
+        { silent: shouldIgnoreMessages([errorMsg2]) }
+      );
+      currentAttempt = 0;
+      retryId = generateRetryId();
+    }
+    if (currentAttempt === -1) {
+      const errorMsg2 = String(error);
+      if (!shouldIgnoreMessages([errorMsg2])) {
+        getLogger()?.fallbackAlreadyShown(error);
+      }
+      reloadScheduled = false;
+      showFallbackUI();
+      return;
+    }
+    if (currentAttempt >= reloadDelays.length) {
+      const errorMsg2 = String(error);
+      emitEvent(
+        {
+          finalAttempt: currentAttempt,
+          name: "retry-exhausted",
+          retryId: retryState?.retryId ?? ""
+        },
+        { silent: shouldIgnoreMessages([errorMsg2]) }
+      );
+      sendBeacon({
+        errorMessage: "Exceeded maximum reload attempts",
+        eventName: "chunk_error_max_reloads",
+        retryAttempt: currentAttempt,
+        retryId: retryState?.retryId,
+        serialized: JSON.stringify({
+          error: String(error),
+          retryAttempt: currentAttempt,
+          retryId: retryState?.retryId
+        })
+      });
+      if (!useRetryId) {
+        clearRetryAttemptFromUrl();
+      }
+      reloadScheduled = false;
+      showFallbackUI();
+      return;
+    }
+    const nextAttempt = currentAttempt + 1;
+    const delay = reloadDelays[currentAttempt] ?? 1e3;
+    const errorMsg = String(error);
     emitEvent(
       {
-        finalAttempt: currentAttempt,
-        name: "retry-exhausted",
-        retryId: retryState?.retryId ?? ""
+        attempt: nextAttempt,
+        delay,
+        name: "retry-attempt",
+        retryId
       },
-      { silent: shouldIgnoreMessages([errorMsg2]) }
+      { silent: shouldIgnoreMessages([errorMsg]) }
     );
-    sendBeacon({
-      errorMessage: "Exceeded maximum reload attempts",
-      eventName: "chunk_error_max_reloads",
-      retryAttempt: currentAttempt,
-      retryId: retryState?.retryId,
-      serialized: JSON.stringify({
-        error: String(error),
-        retryAttempt: currentAttempt,
-        retryId: retryState?.retryId
-      })
-    });
-    if (!useRetryId) {
-      clearRetryAttemptFromUrl();
-    }
-    showFallbackUI();
-    return;
+    getLogger()?.retrySchedulingReload(retryId, nextAttempt, delay);
+    setTimeout(() => {
+      if (useRetryId && enableRetryReset) {
+        setLastReloadTime(retryId, nextAttempt);
+      }
+      if (useRetryId) {
+        const reloadUrl = buildReloadUrl(retryId, nextAttempt);
+        globalThis.window.location.href = reloadUrl;
+      } else {
+        globalThis.window.location.href = buildReloadUrlAttemptOnly(nextAttempt);
+      }
+    }, delay);
+  } catch {
+    reloadScheduled = false;
   }
-  const nextAttempt = currentAttempt + 1;
-  const delay = reloadDelays[currentAttempt] ?? 1e3;
-  const errorMsg = String(error);
-  emitEvent(
-    {
-      attempt: nextAttempt,
-      delay,
-      name: "retry-attempt",
-      retryId
-    },
-    { silent: shouldIgnoreMessages([errorMsg]) }
-  );
-  reloadScheduled = true;
-  getLogger()?.retrySchedulingReload(retryId, nextAttempt, delay);
-  setTimeout(() => {
-    if (useRetryId && enableRetryReset) {
-      setLastReloadTime(retryId, nextAttempt);
-    }
-    if (useRetryId) {
-      const reloadUrl = buildReloadUrl(retryId, nextAttempt);
-      globalThis.window.location.href = reloadUrl;
-    } else {
-      globalThis.window.location.href = buildReloadUrlAttemptOnly(nextAttempt);
-    }
-  }, delay);
 };
 var showFallbackUI = () => {
   const options = getOptions();
@@ -249,6 +256,10 @@ var showFallbackUI = () => {
     } else if (!useRetryId && !retryState) {
       clearRetryAttemptFromUrl();
     }
+    const reloadBtn = targetElement.querySelector('[data-spa-guard-action="reload"]');
+    if (reloadBtn) {
+      reloadBtn.addEventListener("click", () => location.reload());
+    }
     if (retryState) {
       const retryIdElements = document.getElementsByClassName("spa-guard-retry-id");
       for (const element of retryIdElements) {

package/dist/{chunk-G6QM353W.js → chunk-UXLGA3TG.js}

@@ -13,7 +13,7 @@ __export(options_exports, {
 });
 
 // src/common/fallbackHtml.generated.ts
-var defaultErrorFallbackHtml = `<style>.spa-guard-error-id:has(.spa-guard-retry-id:empty){display:none}</style><div style="display:flex;align-items:center;justify-content:center;min-height:100vh;padding:2rem"><div style="text-align:center"><h1 data-spa-guard-content="heading">Something went wrong</h1><p data-spa-guard-content="message" style="max-width:600px;margin:1rem auto">Please refresh the page to continue.</p><div style="display:flex;gap:.5rem;justify-content:center"><button data-spa-guard-action="try-again" type="button" style="display:none">Try again</button> <button data-spa-guard-action="reload" type="button" onclick="location.reload()">Reload page</button></div><p class="spa-guard-error-id" style="margin-top:20px;font-size:12px">Error ID: <span class="spa-guard-retry-id"></span></p></div></div>`;
+var defaultErrorFallbackHtml = `<style>.spa-guard-error-id:has(.spa-guard-retry-id:empty){display:none}.spa-guard-error-id{font-family:monospace}</style><div style="display:flex;align-items:center;justify-content:center;min-height:100vh;padding:2rem"><div style="text-align:center"><h1 data-spa-guard-content="heading">Something went wrong</h1><p data-spa-guard-content="message" style="max-width:600px;margin:1rem auto">Please refresh the page to continue.</p><div style="display:flex;gap:.5rem;justify-content:center"><button data-spa-guard-action="try-again" type="button" style="display:none">Try again</button> <button data-spa-guard-action="reload" type="button">Reload page</button></div><p class="spa-guard-error-id" style="margin-top:20px;font-size:12px">Error ID: <span class="spa-guard-retry-id"></span></p></div></div>`;
 var defaultLoadingFallbackHtml = `<div style="display:flex;align-items:center;justify-content:center;min-height:100vh;padding:2rem"><div style="text-align:center"><h2>Loading...</h2><p data-spa-guard-section="retrying" style="display:none">Retry attempt <span data-spa-guard-content="attempt"></span></p></div></div>`;
 
 // src/common/options.ts

package/dist/{chunk-2DFYUVHH.js → chunk-WKH2B2XS.js}

@@ -3,7 +3,7 @@ import {
   getRetryAttemptFromUrl,
   getRetryStateFromUrl,
   subscribe
-} from "./chunk-T5RWH2HR.js";
+} from "./chunk-BLVJHZST.js";
 
 // src/runtime/state.ts
 var getInitialStateFromUrl = () => {

package/dist/{chunk-IC7SCT5F.js → chunk-XOCUWXQL.js}

@@ -1,19 +1,19 @@
 import {
   attemptReload,
   isChunkError
-} from "./chunk-RFGT43OM.js";
+} from "./chunk-U2DZSTRT.js";
 import {
   getState,
   subscribeToState
-} from "./chunk-2DFYUVHH.js";
+} from "./chunk-WKH2B2XS.js";
+import {
+  getOptions
+} from "./chunk-UXLGA3TG.js";
 import {
   emitEvent,
   isDefaultRetryEnabled,
   subscribe
-} from "./chunk-T5RWH2HR.js";
-import {
-  getOptions
-} from "./chunk-G6QM353W.js";
+} from "./chunk-BLVJHZST.js";
 import {
   debugSyncErrorEventType
 } from "./chunk-EDRTFPCN.js";
@@ -38,9 +38,7 @@ function DebugSyncErrorTrigger() {
     };
   }, []);
   if (error) {
-    const err = error;
-    setError(null);
-    throw err;
+    throw error;
   }
   return null;
 }

package/dist/common/errors/ForceRetryError.d.ts

@@ -1,5 +1,5 @@
 declare const FORCE_RETRY_MAGIC = "__SPA_GUARD_FORCE_RETRY__";
 export { FORCE_RETRY_MAGIC };
 export declare class ForceRetryError extends Error {
-    constructor(message?: string);
+    constructor(message?: string, options?: ErrorOptions);
 }

package/dist/common/fallbackHtml.generated.d.ts

@@ -1,2 +1,2 @@
-export declare const defaultErrorFallbackHtml = "<style>.spa-guard-error-id:has(.spa-guard-retry-id:empty){display:none}</style><div style=\"display:flex;align-items:center;justify-content:center;min-height:100vh;padding:2rem\"><div style=\"text-align:center\"><h1 data-spa-guard-content=\"heading\">Something went wrong</h1><p data-spa-guard-content=\"message\" style=\"max-width:600px;margin:1rem auto\">Please refresh the page to continue.</p><div style=\"display:flex;gap:.5rem;justify-content:center\"><button data-spa-guard-action=\"try-again\" type=\"button\" style=\"display:none\">Try again</button> <button data-spa-guard-action=\"reload\" type=\"button\" onclick=\"location.reload()\">Reload page</button></div><p class=\"spa-guard-error-id\" style=\"margin-top:20px;font-size:12px\">Error ID: <span class=\"spa-guard-retry-id\"></span></p></div></div>";
+export declare const defaultErrorFallbackHtml = "<style>.spa-guard-error-id:has(.spa-guard-retry-id:empty){display:none}.spa-guard-error-id{font-family:monospace}</style><div style=\"display:flex;align-items:center;justify-content:center;min-height:100vh;padding:2rem\"><div style=\"text-align:center\"><h1 data-spa-guard-content=\"heading\">Something went wrong</h1><p data-spa-guard-content=\"message\" style=\"max-width:600px;margin:1rem auto\">Please refresh the page to continue.</p><div style=\"display:flex;gap:.5rem;justify-content:center\"><button data-spa-guard-action=\"try-again\" type=\"button\" style=\"display:none\">Try again</button> <button data-spa-guard-action=\"reload\" type=\"button\">Reload page</button></div><p class=\"spa-guard-error-id\" style=\"margin-top:20px;font-size:12px\">Error ID: <span class=\"spa-guard-retry-id\"></span></p></div></div>";
 export declare const defaultLoadingFallbackHtml = "<div style=\"display:flex;align-items:center;justify-content:center;min-height:100vh;padding:2rem\"><div style=\"text-align:center\"><h2>Loading...</h2><p data-spa-guard-section=\"retrying\" style=\"display:none\">Retry attempt <span data-spa-guard-content=\"attempt\"></span></p></div></div>";

package/dist/common/index.js

@@ -10,11 +10,13 @@ import {
   sendBeacon,
   shouldForceRetry,
   shouldIgnoreMessages
-} from "../chunk-RFGT43OM.js";
+} from "../chunk-U2DZSTRT.js";
 import {
-  ForceRetryError
-} from "../chunk-L5UEVGWR.js";
+  getOptions,
+  options_exports
+} from "../chunk-UXLGA3TG.js";
 import {
+  ForceRetryError,
   disableDefaultRetry,
   emitEvent,
   enableDefaultRetry,
@@ -27,11 +29,7 @@ import {
   setLogger,
   subscribe,
   updateRetryStateInUrl
-} from "../chunk-T5RWH2HR.js";
-import {
-  getOptions,
-  options_exports
-} from "../chunk-G6QM353W.js";
+} from "../chunk-BLVJHZST.js";
 import "../chunk-EDRTFPCN.js";
 import "../chunk-RP52SPBK.js";
 import {
@@ -212,10 +210,10 @@ var listenInternal = (serializeError2, logger) => {
   wa(
     "error",
     (event) => {
-      const shouldIgnore = shouldIgnoreMessages([event.message]);
-      if (!shouldIgnore) {
-        getLogger()?.capturedError("error", event);
+      if (shouldIgnoreMessages([event.message])) {
+        return;
       }
+      getLogger()?.capturedError("error", event);
       if (isChunkError(event)) {
         event.preventDefault();
         attemptReload(event.error ?? event);
@@ -238,10 +236,10 @@ var listenInternal = (serializeError2, logger) => {
   );
   wa("unhandledrejection", (event) => {
     const errorMessage = String(event.reason);
-    const shouldIgnore = shouldIgnoreMessages([errorMessage]);
-    if (!shouldIgnore) {
-      getLogger()?.capturedError("unhandledrejection", event);
+    if (shouldIgnoreMessages([errorMessage])) {
+      return;
     }
+    getLogger()?.capturedError("unhandledrejection", event);
     if (isChunkError(event.reason)) {
       event.preventDefault();
       attemptReload(event.reason);
@@ -269,10 +267,10 @@ var listenInternal = (serializeError2, logger) => {
   });
   wa("securitypolicyviolation", (event) => {
     const eventMessage = `${event.violatedDirective}: ${event.blockedURI}`;
-    const shouldIgnore = shouldIgnoreMessages([eventMessage]);
-    if (!shouldIgnore) {
-      getLogger()?.capturedError("csp", event.blockedURI, event.violatedDirective);
+    if (shouldIgnoreMessages([eventMessage])) {
+      return;
     }
+    getLogger()?.capturedError("csp", event.blockedURI, event.violatedDirective);
     const serialized = serializeError2(event);
     sendBeacon({
       eventMessage,
@@ -283,10 +281,10 @@ var listenInternal = (serializeError2, logger) => {
   });
   wa("vite:preloadError", (event) => {
     const errorMsg = event?.payload?.message || event?.message;
-    const shouldIgnore = shouldIgnoreMessages([errorMsg]);
-    if (!shouldIgnore) {
-      getLogger()?.capturedError("vite:preloadError", event);
+    if (shouldIgnoreMessages([errorMsg])) {
+      return;
     }
+    getLogger()?.capturedError("vite:preloadError", event);
     event.preventDefault();
     attemptReload(event?.payload ?? event);
   });

package/dist/common/reload.d.ts

@@ -1,3 +1,3 @@
-/** @internal Reset for testing only */
+/** @internal */
 export declare const resetReloadScheduled: () => void;
 export declare const attemptReload: (error: unknown) => void;

package/dist/fastify/index.js

@@ -1,13 +1,13 @@
 import {
   parseBeacon
 } from "../chunk-WE7SWL5H.js";
-import "../chunk-KZEBQNOZ.js";
 import {
   BeaconError
 } from "../chunk-3SCN2UE4.js";
 import {
   name
 } from "../chunk-RP52SPBK.js";
+import "../chunk-KZEBQNOZ.js";
 import "../chunk-MLKGABMK.js";
 
 // src/fastify/index.ts

package/dist/react/index.js

@@ -4,15 +4,14 @@ import {
   useSPAGuardChunkError,
   useSPAGuardEvents,
   useSpaGuardState
-} from "../chunk-IC7SCT5F.js";
-import "../chunk-RFGT43OM.js";
-import "../chunk-LGPIRNKE.js";
-import "../chunk-2DFYUVHH.js";
+} from "../chunk-XOCUWXQL.js";
+import "../chunk-U2DZSTRT.js";
+import "../chunk-4N3XJ7VS.js";
+import "../chunk-WKH2B2XS.js";
+import "../chunk-UXLGA3TG.js";
 import {
   ForceRetryError
-} from "../chunk-L5UEVGWR.js";
-import "../chunk-T5RWH2HR.js";
-import "../chunk-G6QM353W.js";
+} from "../chunk-BLVJHZST.js";
 import "../chunk-EDRTFPCN.js";
 import "../chunk-RP52SPBK.js";
 import "../chunk-MLKGABMK.js";

package/dist/react-error-boundary/index.js

@@ -1,19 +1,18 @@
 import {
   DefaultErrorFallback,
   handleErrorWithSpaGuard
-} from "../chunk-RXW44IWI.js";
+} from "../chunk-D5NHZ5BD.js";
 import "../chunk-HUAI4DRW.js";
 import {
   useSpaGuardState
-} from "../chunk-IC7SCT5F.js";
+} from "../chunk-XOCUWXQL.js";
 import {
   isChunkError
-} from "../chunk-RFGT43OM.js";
-import "../chunk-LGPIRNKE.js";
-import "../chunk-2DFYUVHH.js";
-import "../chunk-L5UEVGWR.js";
-import "../chunk-T5RWH2HR.js";
-import "../chunk-G6QM353W.js";
+} from "../chunk-U2DZSTRT.js";
+import "../chunk-4N3XJ7VS.js";
+import "../chunk-WKH2B2XS.js";
+import "../chunk-UXLGA3TG.js";
+import "../chunk-BLVJHZST.js";
 import "../chunk-EDRTFPCN.js";
 import "../chunk-RP52SPBK.js";
 import "../chunk-MLKGABMK.js";

package/dist/react-router/index.js

@@ -1,19 +1,18 @@
 import {
   DefaultErrorFallback,
   handleErrorWithSpaGuard
-} from "../chunk-RXW44IWI.js";
+} from "../chunk-D5NHZ5BD.js";
 import "../chunk-HUAI4DRW.js";
 import {
   useSpaGuardState
-} from "../chunk-IC7SCT5F.js";
+} from "../chunk-XOCUWXQL.js";
 import {
   isChunkError
-} from "../chunk-RFGT43OM.js";
-import "../chunk-LGPIRNKE.js";
-import "../chunk-2DFYUVHH.js";
-import "../chunk-L5UEVGWR.js";
-import "../chunk-T5RWH2HR.js";
-import "../chunk-G6QM353W.js";
+} from "../chunk-U2DZSTRT.js";
+import "../chunk-4N3XJ7VS.js";
+import "../chunk-WKH2B2XS.js";
+import "../chunk-UXLGA3TG.js";
+import "../chunk-BLVJHZST.js";
 import "../chunk-EDRTFPCN.js";
 import "../chunk-RP52SPBK.js";
 import "../chunk-MLKGABMK.js";

package/dist/runtime/debug/errorDispatchers.d.ts

@@ -24,6 +24,12 @@ export declare function dispatchChunkLoadError(): void;
  * a window "unhandledrejection" event.
  */
 export declare function dispatchFinallyError(): void;
+/**
+ * Dispatches a ForceRetryError via void Promise.reject().
+ * Triggers window "unhandledrejection" with a ForceRetryError whose message
+ * contains the FORCE_RETRY_MAGIC prefix, exercising the forceRetry path.
+ */
+export declare function dispatchForceRetryError(): void;
 /**
  * Dispatches an unhandled network timeout error after a delay.
  * Uses setTimeout + void Promise.reject() to trigger window "unhandledrejection".
@@ -36,3 +42,9 @@ export declare function dispatchNetworkTimeout(delayMs?: number): void;
  * React Error Boundary can catch it.
  */
 export declare function dispatchSyncRuntimeError(): void;
+/**
+ * Dispatches a plain unhandled promise rejection via void Promise.reject().
+ * This is NOT a chunk error and NOT a ForceRetry — it exercises the
+ * handleUnhandledRejections config path for generic rejections.
+ */
+export declare function dispatchUnhandledRejection(): void;

package/dist/runtime/debug/index.js

@@ -1,9 +1,10 @@
 import {
   subscribeToState
-} from "../../chunk-2DFYUVHH.js";
+} from "../../chunk-WKH2B2XS.js";
 import {
+  ForceRetryError,
   subscribe
-} from "../../chunk-T5RWH2HR.js";
+} from "../../chunk-BLVJHZST.js";
 import {
   debugSyncErrorEventType
 } from "../../chunk-EDRTFPCN.js";
@@ -28,6 +29,9 @@ function dispatchFinallyError() {
     throw new Error("Failed to fetch dynamically imported module: /finally-error-chunk.js");
   });
 }
+function dispatchForceRetryError() {
+  void Promise.reject(new ForceRetryError("Simulated force-retry from spa-guard debug panel"));
+}
 function dispatchNetworkTimeout(delayMs = 3e3) {
   setTimeout(() => {
     void Promise.reject(new TypeError("NetworkError: request timed out"));
@@ -37,6 +41,11 @@ function dispatchSyncRuntimeError() {
   const error = new Error("Simulated sync runtime error from spa-guard debug panel");
   globalThis.dispatchEvent(new CustomEvent(debugSyncErrorEventType, { detail: { error } }));
 }
+function dispatchUnhandledRejection() {
+  void Promise.reject(
+    new Error("Simulated unhandled promise rejection from spa-guard debug panel")
+  );
+}
 
 // src/runtime/debug/index.ts
 var SCENARIOS = [
@@ -44,7 +53,13 @@ var SCENARIOS = [
   { dispatch: () => dispatchNetworkTimeout(100), key: "network-timeout", label: "Network Timeout" },
   { dispatch: dispatchSyncRuntimeError, key: "sync-runtime-error", label: "Sync Runtime Error" },
   { dispatch: dispatchAsyncRuntimeError, key: "async-runtime-error", label: "Async Runtime Error" },
-  { dispatch: dispatchFinallyError, key: "finally-error", label: "Finally Error" }
+  { dispatch: dispatchFinallyError, key: "finally-error", label: "Finally Error" },
+  { dispatch: dispatchForceRetryError, key: "force-retry-error", label: "ForceRetry Error" },
+  {
+    dispatch: dispatchUnhandledRejection,
+    key: "unhandled-rejection",
+    label: "Unhandled Rejection"
+  }
 ];
 var POSITION_MAP = {
   "bottom-left": "bottom:16px;left:16px;",

package/dist/runtime/index.js

@@ -2,16 +2,15 @@ import {
   recommendedSetup,
   startVersionCheck,
   stopVersionCheck
-} from "../chunk-LGPIRNKE.js";
+} from "../chunk-4N3XJ7VS.js";
 import {
   getState,
   subscribeToState
-} from "../chunk-2DFYUVHH.js";
+} from "../chunk-WKH2B2XS.js";
+import "../chunk-UXLGA3TG.js";
 import {
   ForceRetryError
-} from "../chunk-L5UEVGWR.js";
-import "../chunk-T5RWH2HR.js";
-import "../chunk-G6QM353W.js";
+} from "../chunk-BLVJHZST.js";
 import "../chunk-EDRTFPCN.js";
 import "../chunk-RP52SPBK.js";
 import "../chunk-MLKGABMK.js";

package/dist/vite-plugin/index.js

@@ -1,4 +1,4 @@
-import "../chunk-G6QM353W.js";
+import "../chunk-UXLGA3TG.js";
 import {
   optionsWindowKey
 } from "../chunk-EDRTFPCN.js";

package/dist-inline/index.js

@@ -1 +1 @@
-var e="@ovineko/spa-guard",t=Symbol.for(e+":event-subscribers"),r=Symbol.for(e+":internal-config"),a=Symbol.for(e+":initialized"),n=Symbol.for(e+":logger"),l="spaGuardRetryId",o="spaGuardRetryAttempt";globalThis.window&&!globalThis.window[t]&&(globalThis.window[t]=new Set),globalThis.window&&!globalThis.window[r]&&(globalThis.window[r]={defaultRetryEnabled:!0,initialized:!1,inlineScriptLoaded:!1});var i=globalThis.window?.[t]??new Set,s=globalThis.window?.[r]??{defaultRetryEnabled:!0,initialized:!1,inlineScriptLoaded:!1},d=()=>globalThis.window?.[n],c=(e,t)=>{t?.silent||d()?.logEvent(e),i.forEach(t=>{try{t(e)}catch{}})},y=e=>{let t=p(e);return!!t&&[/Failed to fetch dynamically imported module/i,/Importing a module script failed/i,/error loading dynamically imported module/i,/Unable to preload CSS/i,/Loading chunk \d+ failed/i,/Loading CSS chunk \d+ failed/i,/ChunkLoadError/i].some(e=>e.test(t))},p=e=>e instanceof Error?e.message:"string"==typeof e?e:e&&"object"==typeof e&&"message"in e?e.message+"":e&&"object"==typeof e&&"reason"in e?p(e.reason):null,m={checkVersion:{interval:3e5,mode:"html",onUpdate:"reload"},enableRetryReset:!0,errors:{forceRetry:[],ignore:[]},handleUnhandledRejections:{retry:!0,sendBeacon:!0},html:{fallback:{content:'<style>.spa-guard-error-id:has(.spa-guard-retry-id:empty){display:none}</style><div style="display:flex;align-items:center;justify-content:center;min-height:100vh;padding:2rem"><div style="text-align:center"><h1 data-spa-guard-content="heading">Something went wrong</h1><p data-spa-guard-content="message" style="max-width:600px;margin:1rem auto">Please refresh the page to continue.</p><div style="display:flex;gap:.5rem;justify-content:center"><button data-spa-guard-action="try-again" type="button" style="display:none">Try again</button> <button data-spa-guard-action="reload" type="button" onclick="location.reload()">Reload page</button></div><p class="spa-guard-error-id" style="margin-top:20px;font-size:12px">Error ID: <span class="spa-guard-retry-id"></span></p></div></div>',selector:"body"},loading:{content:'<div style="display:flex;align-items:center;justify-content:center;min-height:100vh;padding:2rem"><div style="text-align:center"><h2>Loading...</h2><p data-spa-guard-section="retrying" style="display:none">Retry attempt <span data-spa-guard-content="attempt"></span></p></div></div>'}},lazyRetry:{callReloadOnFailure:!0,retryDelays:[1e3,2e3]},minTimeBetweenResets:5e3,reloadDelays:[1e3,2e3,5e3],useRetryId:!0},u=()=>{let e=globalThis.window?.__SPA_GUARD_OPTIONS__;return{...m,...e,checkVersion:{...m.checkVersion,...e?.checkVersion},errors:{...m.errors,...e?.errors},handleUnhandledRejections:{...m.handleUnhandledRejections,...e?.handleUnhandledRejections},html:{fallback:{...m.html?.fallback,...e?.html?.fallback},loading:{...m.html?.loading,...e?.html?.loading}},lazyRetry:{...m.lazyRetry,...e?.lazyRetry},reportBeacon:{...m.reportBeacon,...e?.reportBeacon}}},g="__spa_guard_last_reload_timestamp__",h="__spa_guard_last_retry_reset__",f=null,w=null,b=()=>{try{return void 0!==globalThis.window&&typeof sessionStorage<"u"}catch{return!1}},v=()=>{if(b())try{let e=sessionStorage.getItem(g);if(e)return JSON.parse(e)}catch{return f}return f},R=()=>{try{let e=new URLSearchParams(globalThis.window.location.search),t=e.get(l),r=e.get(o);if(t&&r){let e=parseInt(r,10);return Number.isNaN(e)?null:{retryAttempt:e,retryId:t}}return null}catch{return null}},S=()=>{try{let e=new URL(globalThis.window.location.href);e.searchParams.delete(l),e.searchParams.delete(o),globalThis.window.history.replaceState(null,"",e.toString())}catch{}},I=()=>{if(typeof crypto<"u"&&crypto.randomUUID)return crypto.randomUUID();if(typeof crypto<"u"&&crypto.getRandomValues){let e=new Uint32Array(2);return crypto.getRandomValues(e),`${Date.now()}-${e[0].toString(36)}${e[1].toString(36)}`}return`${Date.now()}-${Math.random().toString(36).slice(2,15)}`},T=()=>{try{let e=new URL(globalThis.window.location.href);e.searchParams.delete(o),globalThis.window.history.replaceState(null,"",e.toString())}catch{}},_=()=>{let e=R();return e?{retryAttempt:e.retryAttempt,retryId:e.retryId}:{}},k=e=>{let t=u().errors?.ignore??[];return 0!==t.length&&e.filter(e=>"string"==typeof e).some(e=>t.some(t=>e.includes(t)))},N=e=>{let t=[...u().errors?.forceRetry??[],"__SPA_GUARD_FORCE_RETRY__"];return e.filter(e=>"string"==typeof e).some(e=>t.some(t=>e.includes(t)))},A=e=>{if((e=>k([e.errorMessage,e.eventMessage]))(e))return;let t=u();if(!t.reportBeacon?.endpoint)return void d()?.noBeaconEndpoint();let r=t.appName?{...e,appName:t.appName}:e,a=JSON.stringify(r);"function"==typeof globalThis.window?.navigator?.sendBeacon&&globalThis.window.navigator.sendBeacon(t.reportBeacon.endpoint,a)||fetch(t.reportBeacon.endpoint,{body:a,keepalive:!0,method:"POST"}).catch(e=>{d()?.beaconSendFailed(e)})},D=!1,U=e=>{if(D)return void d()?.reloadAlreadyScheduled(e);let t,r=u(),a=r.reloadDelays??[1e3,2e3,5e3],n=r.useRetryId??!0,i=r.enableRetryReset??!0,y=r.minTimeBetweenResets??5e3;if(n)t=R();else{let e=(()=>{try{let e=new URLSearchParams(globalThis.window.location.search).get(o);if(e){let t=parseInt(e,10);return Number.isNaN(t)?null:t}return null}catch{return null}})();t=null===e?null:{retryAttempt:e,retryId:I()}}let p=t?t.retryAttempt:0,m=t?.retryId??I();d()?.retryCycleStarting(m,p);let _=s.defaultRetryEnabled;if(c({error:e,isRetrying:_&&p>=0&&p<a.length,name:"chunk-error"}),!_)return;if(i&&t&&t.retryAttempt>0&&((e,t,r=5e3)=>{if(0===e.retryAttempt)return!1;let a=v();if(!a||a.retryId!==e.retryId)return!1;let n=(()=>{if(b())try{let e=sessionStorage.getItem(h);if(e)return JSON.parse(e)}catch{return w}return w})();return!(n&&Date.now()-n.timestamp<r)&&Date.now()-a.timestamp>(t[a.attemptNumber-1]??1e3)+3e4})(t,a,y)){let r=v(),a=r?Date.now()-r.timestamp:0;S(),(()=>{if(b())try{sessionStorage.removeItem(g)}catch{}f=null})(),(e=>{let t={previousRetryId:e,timestamp:Date.now()};if(b())try{sessionStorage.setItem(h,JSON.stringify(t))}catch{w=t}else w=t})(t.retryId);let n=e+"";c({name:"retry-reset",previousAttempt:t.retryAttempt,previousRetryId:t.retryId,timeSinceReload:a},{silent:k([n])}),p=0,m=I()}if(-1===p)return k([e+""])||d()?.fallbackAlreadyShown(e),void E();if(p>=a.length){let r=e+"";return c({finalAttempt:p,name:"retry-exhausted",retryId:t?.retryId??""},{silent:k([r])}),A({errorMessage:"Exceeded maximum reload attempts",eventName:"chunk_error_max_reloads",retryAttempt:p,retryId:t?.retryId,serialized:JSON.stringify({error:e+"",retryAttempt:p,retryId:t?.retryId})}),n||T(),void E()}let N=p+1,U=a[p]??1e3;c({attempt:N,delay:U,name:"retry-attempt",retryId:m},{silent:k([e+""])}),D=!0,d()?.retrySchedulingReload(m,N,U),setTimeout(()=>{if(n&&i&&((e,t)=>{let r={attemptNumber:t,retryId:e,timestamp:Date.now()};if(b())try{sessionStorage.setItem(g,JSON.stringify(r))}catch{f=r}else f=r})(m,N),n){let e=((e,t)=>{let r=new URL(globalThis.window.location.href);return r.searchParams.set(l,e),r.searchParams.set(o,t+""),r.toString()})(m,N);globalThis.window.location.href=e}else globalThis.window.location.href=(e=>{let t=new URL(globalThis.window.location.href);return t.searchParams.set(o,e+""),t.toString()})(N)},U)},E=()=>{let e=u(),t=e.html?.fallback?.content,r=e.html?.fallback?.selector??"body";if(t)try{let a=document.querySelector(r);if(!a)return void d()?.fallbackTargetNotFound(r);a.innerHTML=t;let n=e.useRetryId??!0,l=R();if(l&&-1===l.retryAttempt?(d()?.clearingRetryState(),S()):!n&&!l&&T(),l){let e=document.getElementsByClassName("spa-guard-retry-id");for(let t of e)t.textContent=l.retryId}c({name:"fallback-ui-shown"})}catch(e){d()?.fallbackInjectFailed(e)}else d()?.noFallbackConfigured()};(()=>{if(s.initialized)return;s.initialized=!0,void 0!==globalThis.window&&(globalThis.window[a]=!0);let e=u(),t=e.reloadDelays??[],r=R();r&&r.retryAttempt>=t.length&&(d()?.retryLimitExceeded(r.retryAttempt,t.length),(e=>{try{let t=new URL(globalThis.window.location.href);t.searchParams.set(l,e),t.searchParams.set(o,"-1"),globalThis.window.history.replaceState(null,"",t.toString())}catch{}})(r.retryId));let n=globalThis.window.addEventListener.bind(globalThis.window);n("error",e=>(k([e.message])||d()?.capturedError("error",e),y(e)||N([e.message])?(e.preventDefault(),void U(e.error??e)):void A({errorMessage:e.message,eventName:"error",serialized:"",..._()})),!0),n("unhandledrejection",t=>{let r=t.reason+"";if(k([r])||d()?.capturedError("unhandledrejection",t),y(t.reason))return t.preventDefault(),void U(t.reason);if(N([r]))return t.preventDefault(),void U(t.reason);let a=e.handleUnhandledRejections;!1!==a?.sendBeacon&&A({errorMessage:r,eventName:"unhandledrejection",serialized:"",..._()}),!1!==a?.retry&&(t.preventDefault(),U(t.reason))}),n("securitypolicyviolation",e=>{let t=`${e.violatedDirective}: ${e.blockedURI}`;k([t])||d()?.capturedError("csp",e.blockedURI,e.violatedDirective),A({eventMessage:t,eventName:"securitypolicyviolation",serialized:"",..._()})}),n("vite:preloadError",e=>{k([e?.payload?.message||e?.message])||d()?.capturedError("vite:preloadError",e),e.preventDefault(),U(e?.payload??e)})})();
+var e="@ovineko/spa-guard",t=Symbol.for(e+":event-subscribers"),r=Symbol.for(e+":internal-config"),a=Symbol.for(e+":initialized"),n=Symbol.for(e+":logger"),l="spaGuardRetryId",o="spaGuardRetryAttempt";globalThis.window&&!globalThis.window[t]&&(globalThis.window[t]=new Set),globalThis.window&&!globalThis.window[r]&&(globalThis.window[r]={defaultRetryEnabled:!0,initialized:!1,inlineScriptLoaded:!1});var i=globalThis.window?.[t]??new Set,s=globalThis.window?.[r]??{defaultRetryEnabled:!0,initialized:!1,inlineScriptLoaded:!1},d=()=>globalThis.window?.[n],c=(e,t)=>{t?.silent||d()?.logEvent(e),i.forEach(t=>{try{t(e)}catch{}})},y=e=>{let t=p(e);return!!t&&[/Failed to fetch dynamically imported module/i,/Importing a module script failed/i,/error loading dynamically imported module/i,/Unable to preload CSS/i,/Loading chunk \d+ failed/i,/Loading CSS chunk \d+ failed/i,/ChunkLoadError/i].some(e=>e.test(t))},p=e=>e instanceof Error?e.message:"string"==typeof e?e:e&&"object"==typeof e&&"message"in e?e.message+"":e&&"object"==typeof e&&"reason"in e?p(e.reason):null,u={checkVersion:{interval:3e5,mode:"html",onUpdate:"reload"},enableRetryReset:!0,errors:{forceRetry:[],ignore:[]},handleUnhandledRejections:{retry:!0,sendBeacon:!0},html:{fallback:{content:'<style>.spa-guard-error-id:has(.spa-guard-retry-id:empty){display:none}.spa-guard-error-id{font-family:monospace}</style><div style="display:flex;align-items:center;justify-content:center;min-height:100vh;padding:2rem"><div style="text-align:center"><h1 data-spa-guard-content="heading">Something went wrong</h1><p data-spa-guard-content="message" style="max-width:600px;margin:1rem auto">Please refresh the page to continue.</p><div style="display:flex;gap:.5rem;justify-content:center"><button data-spa-guard-action="try-again" type="button" style="display:none">Try again</button> <button data-spa-guard-action="reload" type="button">Reload page</button></div><p class="spa-guard-error-id" style="margin-top:20px;font-size:12px">Error ID: <span class="spa-guard-retry-id"></span></p></div></div>',selector:"body"},loading:{content:'<div style="display:flex;align-items:center;justify-content:center;min-height:100vh;padding:2rem"><div style="text-align:center"><h2>Loading...</h2><p data-spa-guard-section="retrying" style="display:none">Retry attempt <span data-spa-guard-content="attempt"></span></p></div></div>'}},lazyRetry:{callReloadOnFailure:!0,retryDelays:[1e3,2e3]},minTimeBetweenResets:5e3,reloadDelays:[1e3,2e3,5e3],useRetryId:!0},m=()=>{let e=globalThis.window?.__SPA_GUARD_OPTIONS__;return{...u,...e,checkVersion:{...u.checkVersion,...e?.checkVersion},errors:{...u.errors,...e?.errors},handleUnhandledRejections:{...u.handleUnhandledRejections,...e?.handleUnhandledRejections},html:{fallback:{...u.html?.fallback,...e?.html?.fallback},loading:{...u.html?.loading,...e?.html?.loading}},lazyRetry:{...u.lazyRetry,...e?.lazyRetry},reportBeacon:{...u.reportBeacon,...e?.reportBeacon}}},g="__spa_guard_last_reload_timestamp__",h="__spa_guard_last_retry_reset__",f=null,w=null,b=()=>{try{return void 0!==globalThis.window&&typeof sessionStorage<"u"}catch{return!1}},v=()=>{if(b())try{let e=sessionStorage.getItem(g);if(e)return JSON.parse(e)}catch{return f}return f},S=()=>{try{let e=new URLSearchParams(globalThis.window.location.search),t=e.get(l),r=e.get(o);if(t&&r){let e=parseInt(r,10);return Number.isNaN(e)?null:{retryAttempt:e,retryId:t}}return null}catch{return null}},R=()=>{try{let e=new URL(globalThis.window.location.href);e.searchParams.delete(l),e.searchParams.delete(o),globalThis.window.history.replaceState(null,"",e.toString())}catch{}},I=()=>{if(typeof crypto<"u"&&crypto.randomUUID)return crypto.randomUUID();if(typeof crypto<"u"&&crypto.getRandomValues){let e=new Uint32Array(2);return crypto.getRandomValues(e),`${Date.now()}-${e[0].toString(36)}${e[1].toString(36)}`}return`${Date.now()}-${Math.random().toString(36).slice(2,15)}`},T=()=>{try{let e=new URL(globalThis.window.location.href);e.searchParams.delete(o),globalThis.window.history.replaceState(null,"",e.toString())}catch{}},_=()=>{let e=S();return e?{retryAttempt:e.retryAttempt,retryId:e.retryId}:{}},k="__SPA_GUARD_FORCE_RETRY__",N=e=>{let t=(m().errors?.ignore??[]).filter(e=>""!==e);return 0!==t.length&&e.filter(e=>"string"==typeof e).some(e=>t.some(t=>e.includes(t)))},A=e=>{let t=[...m().errors?.forceRetry??[],k].filter(e=>""!==e);return e.filter(e=>"string"==typeof e).some(e=>t.some(t=>e.includes(t)))},D=e=>{if((e=>N([e.errorMessage,e.eventMessage]))(e))return;let t=m();if(!t.reportBeacon?.endpoint)return void d()?.noBeaconEndpoint();let r=t.appName?{...e,appName:t.appName}:e,a=JSON.stringify(r);("function"!=typeof globalThis.window?.navigator?.sendBeacon||!globalThis.window.navigator.sendBeacon(t.reportBeacon.endpoint,a))&&"function"==typeof fetch&&fetch(t.reportBeacon.endpoint,{body:a,keepalive:!0,method:"POST"}).catch(e=>{d()?.beaconSendFailed(e)})},U=!1,E=e=>{if(U)d()?.reloadAlreadyScheduled(e);else{U=!0;try{let t,r=m(),a=r.reloadDelays??[1e3,2e3,5e3],n=r.useRetryId??!0,i=r.enableRetryReset??!0,y=r.minTimeBetweenResets??5e3;if(n)t=S();else{let e=(()=>{try{let e=new URLSearchParams(globalThis.window.location.search).get(o);if(e){let t=parseInt(e,10);return Number.isNaN(t)?null:t}return null}catch{return null}})();t=null===e?null:{retryAttempt:e,retryId:I()}}let p=t?t.retryAttempt:0,u=t?.retryId??I();d()?.retryCycleStarting(u,p);let _=s.defaultRetryEnabled;if(c({error:e,isRetrying:_&&p>=0&&p<a.length,name:"chunk-error"}),!_)return void(U=!1);if(i&&t&&t.retryAttempt>0&&((e,t,r=5e3)=>{if(0===e.retryAttempt)return!1;let a=v();if(!a||a.retryId!==e.retryId)return!1;let n=(()=>{if(b())try{let e=sessionStorage.getItem(h);if(e)return JSON.parse(e)}catch{return w}return w})();return!(n&&Date.now()-n.timestamp<r)&&Date.now()-a.timestamp>(t[a.attemptNumber-1]??1e3)+3e4})(t,a,y)){let r=v(),a=r?Date.now()-r.timestamp:0;R(),(()=>{if(b())try{sessionStorage.removeItem(g)}catch{}f=null})(),(e=>{let t={previousRetryId:e,timestamp:Date.now()};if(b())try{sessionStorage.setItem(h,JSON.stringify(t))}catch{w=t}else w=t})(t.retryId);let n=e+"";c({name:"retry-reset",previousAttempt:t.retryAttempt,previousRetryId:t.retryId,timeSinceReload:a},{silent:N([n])}),p=0,u=I()}if(-1===p)return N([e+""])||d()?.fallbackAlreadyShown(e),U=!1,void L();if(p>=a.length){let r=e+"";return c({finalAttempt:p,name:"retry-exhausted",retryId:t?.retryId??""},{silent:N([r])}),D({errorMessage:"Exceeded maximum reload attempts",eventName:"chunk_error_max_reloads",retryAttempt:p,retryId:t?.retryId,serialized:JSON.stringify({error:e+"",retryAttempt:p,retryId:t?.retryId})}),n||T(),U=!1,void L()}let k=p+1,A=a[p]??1e3;c({attempt:k,delay:A,name:"retry-attempt",retryId:u},{silent:N([e+""])}),d()?.retrySchedulingReload(u,k,A),setTimeout(()=>{if(n&&i&&((e,t)=>{let r={attemptNumber:t,retryId:e,timestamp:Date.now()};if(b())try{sessionStorage.setItem(g,JSON.stringify(r))}catch{f=r}else f=r})(u,k),n){let e=((e,t)=>{let r=new URL(globalThis.window.location.href);return r.searchParams.set(l,e),r.searchParams.set(o,t+""),r.toString()})(u,k);globalThis.window.location.href=e}else globalThis.window.location.href=(e=>{let t=new URL(globalThis.window.location.href);return t.searchParams.set(o,e+""),t.toString()})(k)},A)}catch{U=!1}}},L=()=>{let e=m(),t=e.html?.fallback?.content,r=e.html?.fallback?.selector??"body";if(t)try{let a=document.querySelector(r);if(!a)return void d()?.fallbackTargetNotFound(r);a.innerHTML=t;let n=e.useRetryId??!0,l=S();l&&-1===l.retryAttempt?(d()?.clearingRetryState(),R()):!n&&!l&&T();let o=a.querySelector('[data-spa-guard-action="reload"]');if(o&&o.addEventListener("click",()=>location.reload()),l){let e=document.getElementsByClassName("spa-guard-retry-id");for(let t of e)t.textContent=l.retryId}c({name:"fallback-ui-shown"})}catch(e){d()?.fallbackInjectFailed(e)}else d()?.noFallbackConfigured()};(()=>{if(s.initialized)return;s.initialized=!0,void 0!==globalThis.window&&(globalThis.window[a]=!0);let e=m(),t=e.reloadDelays??[],r=S();r&&r.retryAttempt>=t.length&&(d()?.retryLimitExceeded(r.retryAttempt,t.length),(e=>{try{let t=new URL(globalThis.window.location.href);t.searchParams.set(l,e),t.searchParams.set(o,"-1"),globalThis.window.history.replaceState(null,"",t.toString())}catch{}})(r.retryId));let n=globalThis.window.addEventListener.bind(globalThis.window);n("error",e=>{if(!N([e.message]))return d()?.capturedError("error",e),y(e)||A([e.message])?(e.preventDefault(),void E(e.error??e)):void D({errorMessage:e.message,eventName:"error",serialized:"",..._()})},!0),n("unhandledrejection",t=>{let r=t.reason+"";if(N([r]))return;if(d()?.capturedError("unhandledrejection",t),y(t.reason))return t.preventDefault(),void E(t.reason);if(A([r]))return t.preventDefault(),void E(t.reason);let a=e.handleUnhandledRejections;!1!==a?.sendBeacon&&D({errorMessage:r,eventName:"unhandledrejection",serialized:"",..._()}),!1!==a?.retry&&(t.preventDefault(),E(t.reason))}),n("securitypolicyviolation",e=>{let t=`${e.violatedDirective}: ${e.blockedURI}`;N([t])||(d()?.capturedError("csp",e.blockedURI,e.violatedDirective),D({eventMessage:t,eventName:"securitypolicyviolation",serialized:"",..._()}))}),n("vite:preloadError",e=>{N([e?.payload?.message||e?.message])||(d()?.capturedError("vite:preloadError",e),e.preventDefault(),E(e?.payload??e))})})();

package/dist-inline-trace/index.js

@@ -1 +1 @@
-var e="@ovineko/spa-guard",t=Symbol.for(e+":event-subscribers"),r=Symbol.for(e+":internal-config"),a=Symbol.for(e+":initialized"),n=Symbol.for(e+":logger"),o="spaGuardRetryId",l="spaGuardRetryAttempt";globalThis.window&&!globalThis.window[t]&&(globalThis.window[t]=new Set),globalThis.window&&!globalThis.window[r]&&(globalThis.window[r]={defaultRetryEnabled:!0,initialized:!1,inlineScriptLoaded:!1});var i=globalThis.window?.[t]??new Set,s=globalThis.window?.[r]??{defaultRetryEnabled:!0,initialized:!1,inlineScriptLoaded:!1},d=()=>globalThis.window?.[n],c=(e,t)=>{t?.silent||d()?.logEvent(e),i.forEach(t=>{try{t(e)}catch{}})},y=e=>{let t=u(e);return!!t&&[/Failed to fetch dynamically imported module/i,/Importing a module script failed/i,/error loading dynamically imported module/i,/Unable to preload CSS/i,/Loading chunk \d+ failed/i,/Loading CSS chunk \d+ failed/i,/ChunkLoadError/i].some(e=>e.test(t))},u=e=>e instanceof Error?e.message:"string"==typeof e?e:e&&"object"==typeof e&&"message"in e?e.message+"":e&&"object"==typeof e&&"reason"in e?u(e.reason):null,m={checkVersion:{interval:3e5,mode:"html",onUpdate:"reload"},enableRetryReset:!0,errors:{forceRetry:[],ignore:[]},handleUnhandledRejections:{retry:!0,sendBeacon:!0},html:{fallback:{content:'<style>.spa-guard-error-id:has(.spa-guard-retry-id:empty){display:none}</style><div style="display:flex;align-items:center;justify-content:center;min-height:100vh;padding:2rem"><div style="text-align:center"><h1 data-spa-guard-content="heading">Something went wrong</h1><p data-spa-guard-content="message" style="max-width:600px;margin:1rem auto">Please refresh the page to continue.</p><div style="display:flex;gap:.5rem;justify-content:center"><button data-spa-guard-action="try-again" type="button" style="display:none">Try again</button> <button data-spa-guard-action="reload" type="button" onclick="location.reload()">Reload page</button></div><p class="spa-guard-error-id" style="margin-top:20px;font-size:12px">Error ID: <span class="spa-guard-retry-id"></span></p></div></div>',selector:"body"},loading:{content:'<div style="display:flex;align-items:center;justify-content:center;min-height:100vh;padding:2rem"><div style="text-align:center"><h2>Loading...</h2><p data-spa-guard-section="retrying" style="display:none">Retry attempt <span data-spa-guard-content="attempt"></span></p></div></div>'}},lazyRetry:{callReloadOnFailure:!0,retryDelays:[1e3,2e3]},minTimeBetweenResets:5e3,reloadDelays:[1e3,2e3,5e3],useRetryId:!0},p=()=>{let e=globalThis.window?.__SPA_GUARD_OPTIONS__;return{...m,...e,checkVersion:{...m.checkVersion,...e?.checkVersion},errors:{...m.errors,...e?.errors},handleUnhandledRejections:{...m.handleUnhandledRejections,...e?.handleUnhandledRejections},html:{fallback:{...m.html?.fallback,...e?.html?.fallback},loading:{...m.html?.loading,...e?.html?.loading}},lazyRetry:{...m.lazyRetry,...e?.lazyRetry},reportBeacon:{...m.reportBeacon,...e?.reportBeacon}}},g="__spa_guard_last_reload_timestamp__",h="__spa_guard_last_retry_reset__",f=null,w=null,b=()=>{try{return void 0!==globalThis.window&&typeof sessionStorage<"u"}catch{return!1}},v=()=>{if(b())try{let e=sessionStorage.getItem(g);if(e)return JSON.parse(e)}catch{return f}return f},k=()=>{try{let e=new URLSearchParams(globalThis.window.location.search),t=e.get(o),r=e.get(l);if(t&&r){let e=parseInt(r,10);return Number.isNaN(e)?null:{retryAttempt:e,retryId:t}}return null}catch{return null}},R=()=>{try{let e=new URL(globalThis.window.location.href);e.searchParams.delete(o),e.searchParams.delete(l),globalThis.window.history.replaceState(null,"",e.toString())}catch{}},S=()=>{if(typeof crypto<"u"&&crypto.randomUUID)return crypto.randomUUID();if(typeof crypto<"u"&&crypto.getRandomValues){let e=new Uint32Array(2);return crypto.getRandomValues(e),`${Date.now()}-${e[0].toString(36)}${e[1].toString(36)}`}return`${Date.now()}-${Math.random().toString(36).slice(2,15)}`},$=()=>{try{let e=new URL(globalThis.window.location.href);e.searchParams.delete(l),globalThis.window.history.replaceState(null,"",e.toString())}catch{}},I=()=>{let e=k();return e?{retryAttempt:e.retryAttempt,retryId:e.retryId}:{}},T=e=>{let t=p().errors?.ignore??[];return 0!==t.length&&e.filter(e=>"string"==typeof e).some(e=>t.some(t=>e.includes(t)))},N=e=>{let t=[...p().errors?.forceRetry??[],"__SPA_GUARD_FORCE_RETRY__"];return e.filter(e=>"string"==typeof e).some(e=>t.some(t=>e.includes(t)))},E=e=>{if((e=>T([e.errorMessage,e.eventMessage]))(e))return;let t=p();if(!t.reportBeacon?.endpoint)return void d()?.noBeaconEndpoint();let r=t.appName?{...e,appName:t.appName}:e,a=JSON.stringify(r);"function"==typeof globalThis.window?.navigator?.sendBeacon&&globalThis.window.navigator.sendBeacon(t.reportBeacon.endpoint,a)||fetch(t.reportBeacon.endpoint,{body:a,keepalive:!0,method:"POST"}).catch(e=>{d()?.beaconSendFailed(e)})},U=!1,A=e=>{if(U)return void d()?.reloadAlreadyScheduled(e);let t,r=p(),a=r.reloadDelays??[1e3,2e3,5e3],n=r.useRetryId??!0,i=r.enableRetryReset??!0,y=r.minTimeBetweenResets??5e3;if(n)t=k();else{let e=(()=>{try{let e=new URLSearchParams(globalThis.window.location.search).get(l);if(e){let t=parseInt(e,10);return Number.isNaN(t)?null:t}return null}catch{return null}})();t=null===e?null:{retryAttempt:e,retryId:S()}}let u=t?t.retryAttempt:0,m=t?.retryId??S();d()?.retryCycleStarting(m,u);let I=s.defaultRetryEnabled;if(c({error:e,isRetrying:I&&u>=0&&u<a.length,name:"chunk-error"}),!I)return;if(i&&t&&t.retryAttempt>0&&((e,t,r=5e3)=>{if(0===e.retryAttempt)return!1;let a=v();if(!a||a.retryId!==e.retryId)return!1;let n=(()=>{if(b())try{let e=sessionStorage.getItem(h);if(e)return JSON.parse(e)}catch{return w}return w})();return!(n&&Date.now()-n.timestamp<r)&&Date.now()-a.timestamp>(t[a.attemptNumber-1]??1e3)+3e4})(t,a,y)){let r=v(),a=r?Date.now()-r.timestamp:0;R(),(()=>{if(b())try{sessionStorage.removeItem(g)}catch{}f=null})(),(e=>{let t={previousRetryId:e,timestamp:Date.now()};if(b())try{sessionStorage.setItem(h,JSON.stringify(t))}catch{w=t}else w=t})(t.retryId);let n=e+"";c({name:"retry-reset",previousAttempt:t.retryAttempt,previousRetryId:t.retryId,timeSinceReload:a},{silent:T([n])}),u=0,m=S()}if(-1===u)return T([e+""])||d()?.fallbackAlreadyShown(e),void _();if(u>=a.length){let r=e+"";return c({finalAttempt:u,name:"retry-exhausted",retryId:t?.retryId??""},{silent:T([r])}),E({errorMessage:"Exceeded maximum reload attempts",eventName:"chunk_error_max_reloads",retryAttempt:u,retryId:t?.retryId,serialized:JSON.stringify({error:e+"",retryAttempt:u,retryId:t?.retryId})}),n||$(),void _()}let N=u+1,A=a[u]??1e3;c({attempt:N,delay:A,name:"retry-attempt",retryId:m},{silent:T([e+""])}),U=!0,d()?.retrySchedulingReload(m,N,A),setTimeout(()=>{if(n&&i&&((e,t)=>{let r={attemptNumber:t,retryId:e,timestamp:Date.now()};if(b())try{sessionStorage.setItem(g,JSON.stringify(r))}catch{f=r}else f=r})(m,N),n){let e=((e,t)=>{let r=new URL(globalThis.window.location.href);return r.searchParams.set(o,e),r.searchParams.set(l,t+""),r.toString()})(m,N);globalThis.window.location.href=e}else globalThis.window.location.href=(e=>{let t=new URL(globalThis.window.location.href);return t.searchParams.set(l,e+""),t.toString()})(N)},A)},_=()=>{let e=p(),t=e.html?.fallback?.content,r=e.html?.fallback?.selector??"body";if(t)try{let a=document.querySelector(r);if(!a)return void d()?.fallbackTargetNotFound(r);a.innerHTML=t;let n=e.useRetryId??!0,o=k();if(o&&-1===o.retryAttempt?(d()?.clearingRetryState(),R()):!n&&!o&&$(),o){let e=document.getElementsByClassName("spa-guard-retry-id");for(let t of e)t.textContent=o.retryId}c({name:"fallback-ui-shown"})}catch(e){d()?.fallbackInjectFailed(e)}else d()?.noFallbackConfigured()},D="[spa-guard]",z={"chunk-error":"error","fallback-ui-shown":"warn","lazy-retry-attempt":"warn","lazy-retry-exhausted":"error","lazy-retry-success":"log","retry-attempt":"warn","retry-exhausted":"error","retry-reset":"log"},P=e=>{if(null==e)return{type:"null",value:e};if("object"!=typeof e)return{type:typeof e,value:e};if(e instanceof Error)return{message:e.message,name:e.name,stack:e.stack,type:"Error",...x(e)};if("reason"in e&&"promise"in e)return{reason:P(e.reason),type:"PromiseRejectionEvent"};if("error"in e&&"message"in e&&"filename"in e)return{colno:e.colno,error:P(e.error),filename:e.filename,lineno:e.lineno,message:e.message,type:"ErrorEvent"};if("violatedDirective"in e&&"blockedURI"in e){let t=e;return{blockedURI:t.blockedURI,columnNumber:t.columnNumber,effectiveDirective:t.effectiveDirective,lineNumber:t.lineNumber,originalPolicy:t.originalPolicy,sourceFile:t.sourceFile,type:"SecurityPolicyViolationEvent",violatedDirective:t.violatedDirective}}if("type"in e&&"target"in e){let t=e;return{eventType:t.type,target:C(t.target),timeStamp:t.timeStamp,type:"Event"}}return{type:"object",value:j(e)}},x=e=>{let t={};for(let r of Object.getOwnPropertyNames(e))if(!["message","name","stack"].includes(r))try{t[r]=e[r]}catch{}return t},C=e=>e?e instanceof HTMLElement?{className:e.className,href:e.href,id:e.id,src:e.src,tagName:e.tagName}:{type:e+""}:null,j=e=>{let t={};for(let r of Object.keys(e))try{let a=e[r];t[r]="object"==typeof a?a+"":a}catch{}return t};((e,t)=>{if(t&&(e=>{void 0!==globalThis.window&&(globalThis.window[n]=e)})(t),s.initialized)return;s.initialized=!0,void 0!==globalThis.window&&(globalThis.window[a]=!0);let r=p(),i=r.reloadDelays??[],c=k();c&&c.retryAttempt>=i.length&&(d()?.retryLimitExceeded(c.retryAttempt,i.length),(e=>{try{let t=new URL(globalThis.window.location.href);t.searchParams.set(o,e),t.searchParams.set(l,"-1"),globalThis.window.history.replaceState(null,"",t.toString())}catch{}})(c.retryId));let u=globalThis.window.addEventListener.bind(globalThis.window);u("error",t=>{if(T([t.message])||d()?.capturedError("error",t),y(t))return t.preventDefault(),void A(t.error??t);if(N([t.message]))return t.preventDefault(),void A(t.error??t);let r=e(t);E({errorMessage:t.message,eventName:"error",serialized:r,...I()})},!0),u("unhandledrejection",t=>{let a=t.reason+"";if(T([a])||d()?.capturedError("unhandledrejection",t),y(t.reason))return t.preventDefault(),void A(t.reason);if(N([a]))return t.preventDefault(),void A(t.reason);let n=r.handleUnhandledRejections;if(!1!==n?.sendBeacon){let r=e(t);E({errorMessage:a,eventName:"unhandledrejection",serialized:r,...I()})}!1!==n?.retry&&(t.preventDefault(),A(t.reason))}),u("securitypolicyviolation",t=>{let r=`${t.violatedDirective}: ${t.blockedURI}`;T([r])||d()?.capturedError("csp",t.blockedURI,t.violatedDirective);let a=e(t);E({eventMessage:r,eventName:"securitypolicyviolation",serialized:a,...I()})}),u("vite:preloadError",e=>{T([e?.payload?.message||e?.message])||d()?.capturedError("vite:preloadError",e),e.preventDefault(),A(e?.payload??e)})})(e=>{try{let t=P(e);return JSON.stringify(t,null,2)}catch{return JSON.stringify({error:"Failed to serialize error",fallback:e+""})}},{beaconSendFailed(e){console.error(D+" Failed to send beacon:",e)},capturedError(e,...t){console.error(`${D} ${e}:capture:`,...t)},clearingRetryState(){console.log(D+" Clearing retry state from URL to allow clean reload attempt")},error(e,...t){console.error(`${D} ${e}`,...t)},fallbackAlreadyShown(e){console.error(D+" Fallback UI was already shown. Not retrying to prevent infinite loop.",e)},fallbackInjectFailed(e){console.error(D+" Failed to inject fallback UI",e)},fallbackTargetNotFound(e){console.error(`${D} Target element not found for selector: ${e}`)},log(e,...t){console.log(`${D} ${e}`,...t)},logEvent(e){let t=z[e.name],r=(e=>{switch(e.name){case"chunk-error":return`${D} chunk-error: isRetrying=${e.isRetrying}`;case"fallback-ui-shown":return D+" fallback-ui-shown";case"lazy-retry-attempt":return`${D} lazy-retry-attempt: attempt ${e.attempt}/${e.totalAttempts}, delay ${e.delay}ms`;case"lazy-retry-exhausted":return`${D} lazy-retry-exhausted: ${e.totalAttempts} attempts, willReload=${e.willReload}`;case"lazy-retry-success":return`${D} lazy-retry-success: succeeded on attempt ${e.attempt}`;case"retry-attempt":return`${D} retry-attempt: attempt ${e.attempt} in ${e.delay}ms (retryId: ${e.retryId})`;case"retry-exhausted":return`${D} retry-exhausted: finalAttempt=${e.finalAttempt} (retryId: ${e.retryId})`;case"retry-reset":return`${D} retry-reset: ${e.timeSinceReload}ms since last reload (retryId: ${e.previousRetryId})`}})(e);"chunk-error"===e.name?console[t](r,e.error):console[t](r)},noBeaconEndpoint(){console.warn(D+" Report endpoint is not configured")},noFallbackConfigured(){console.error(D+" No fallback UI configured")},reloadAlreadyScheduled(e){console.log(D+" Reload already scheduled, ignoring duplicate chunk error:",e)},retryCycleStarting(e,t){console.log(`${D} Retry cycle starting: retryId=${e}, fromAttempt=${t}`)},retryLimitExceeded(e,t){console.log(`${D} Retry limit exceeded (${e}/${t}), marking as fallback shown`)},retrySchedulingReload(e,t,r){console.log(`${D} Scheduling reload: retryId=${e}, attempt=${t}, delay=${r}ms`)},updatedRetryAttempt(e){console.log(`${D} Updated retry attempt to ${e} in URL for fallback UI`)},versionChangeDetected(e,t){console.warn(`${D} New version available (${e??"unknown"} → ${t}). Please refresh to get the latest version.`)},versionCheckAlreadyRunning(){console.warn(D+" Version check already running")},versionCheckDisabled(){console.warn(D+" Version checking disabled: no version configured")},versionCheckFailed(e){console.error(D+" Version check failed",e)},versionCheckHttpError(e){console.warn(`${D} Version check HTTP error: ${e}`)},versionCheckParseError(){console.warn(D+" Failed to parse version from HTML")},versionCheckPaused(){console.log(D+" Version check paused (tab hidden)")},versionCheckRequiresEndpoint(){console.warn(D+" JSON version check mode requires endpoint")},versionCheckResumed(){console.log(D+" Version check resumed (tab visible)")},versionCheckResumedImmediate(){console.log(D+" Version check resumed with immediate check (tab visible, interval elapsed)")},versionCheckStarted(e,t,r){console.log(`${D} Starting version check (mode: ${e}, interval: ${t}ms, current: ${r})`)},versionCheckStopped(){console.log(D+" Version check stopped")},warn(e,...t){console.warn(`${D} ${e}`,...t)}});
+var e="@ovineko/spa-guard",t=Symbol.for(e+":event-subscribers"),r=Symbol.for(e+":internal-config"),a=Symbol.for(e+":initialized"),n=Symbol.for(e+":logger"),o="spaGuardRetryId",l="spaGuardRetryAttempt";globalThis.window&&!globalThis.window[t]&&(globalThis.window[t]=new Set),globalThis.window&&!globalThis.window[r]&&(globalThis.window[r]={defaultRetryEnabled:!0,initialized:!1,inlineScriptLoaded:!1});var i=globalThis.window?.[t]??new Set,s=globalThis.window?.[r]??{defaultRetryEnabled:!0,initialized:!1,inlineScriptLoaded:!1},d=()=>globalThis.window?.[n],c=(e,t)=>{t?.silent||d()?.logEvent(e),i.forEach(t=>{try{t(e)}catch{}})},y=e=>{let t=u(e);return!!t&&[/Failed to fetch dynamically imported module/i,/Importing a module script failed/i,/error loading dynamically imported module/i,/Unable to preload CSS/i,/Loading chunk \d+ failed/i,/Loading CSS chunk \d+ failed/i,/ChunkLoadError/i].some(e=>e.test(t))},u=e=>e instanceof Error?e.message:"string"==typeof e?e:e&&"object"==typeof e&&"message"in e?e.message+"":e&&"object"==typeof e&&"reason"in e?u(e.reason):null,m={checkVersion:{interval:3e5,mode:"html",onUpdate:"reload"},enableRetryReset:!0,errors:{forceRetry:[],ignore:[]},handleUnhandledRejections:{retry:!0,sendBeacon:!0},html:{fallback:{content:'<style>.spa-guard-error-id:has(.spa-guard-retry-id:empty){display:none}.spa-guard-error-id{font-family:monospace}</style><div style="display:flex;align-items:center;justify-content:center;min-height:100vh;padding:2rem"><div style="text-align:center"><h1 data-spa-guard-content="heading">Something went wrong</h1><p data-spa-guard-content="message" style="max-width:600px;margin:1rem auto">Please refresh the page to continue.</p><div style="display:flex;gap:.5rem;justify-content:center"><button data-spa-guard-action="try-again" type="button" style="display:none">Try again</button> <button data-spa-guard-action="reload" type="button">Reload page</button></div><p class="spa-guard-error-id" style="margin-top:20px;font-size:12px">Error ID: <span class="spa-guard-retry-id"></span></p></div></div>',selector:"body"},loading:{content:'<div style="display:flex;align-items:center;justify-content:center;min-height:100vh;padding:2rem"><div style="text-align:center"><h2>Loading...</h2><p data-spa-guard-section="retrying" style="display:none">Retry attempt <span data-spa-guard-content="attempt"></span></p></div></div>'}},lazyRetry:{callReloadOnFailure:!0,retryDelays:[1e3,2e3]},minTimeBetweenResets:5e3,reloadDelays:[1e3,2e3,5e3],useRetryId:!0},p=()=>{let e=globalThis.window?.__SPA_GUARD_OPTIONS__;return{...m,...e,checkVersion:{...m.checkVersion,...e?.checkVersion},errors:{...m.errors,...e?.errors},handleUnhandledRejections:{...m.handleUnhandledRejections,...e?.handleUnhandledRejections},html:{fallback:{...m.html?.fallback,...e?.html?.fallback},loading:{...m.html?.loading,...e?.html?.loading}},lazyRetry:{...m.lazyRetry,...e?.lazyRetry},reportBeacon:{...m.reportBeacon,...e?.reportBeacon}}},g="__spa_guard_last_reload_timestamp__",h="__spa_guard_last_retry_reset__",f=null,w=null,b=()=>{try{return void 0!==globalThis.window&&typeof sessionStorage<"u"}catch{return!1}},v=()=>{if(b())try{let e=sessionStorage.getItem(g);if(e)return JSON.parse(e)}catch{return f}return f},k=()=>{try{let e=new URLSearchParams(globalThis.window.location.search),t=e.get(o),r=e.get(l);if(t&&r){let e=parseInt(r,10);return Number.isNaN(e)?null:{retryAttempt:e,retryId:t}}return null}catch{return null}},R=()=>{try{let e=new URL(globalThis.window.location.href);e.searchParams.delete(o),e.searchParams.delete(l),globalThis.window.history.replaceState(null,"",e.toString())}catch{}},S=()=>{if(typeof crypto<"u"&&crypto.randomUUID)return crypto.randomUUID();if(typeof crypto<"u"&&crypto.getRandomValues){let e=new Uint32Array(2);return crypto.getRandomValues(e),`${Date.now()}-${e[0].toString(36)}${e[1].toString(36)}`}return`${Date.now()}-${Math.random().toString(36).slice(2,15)}`},$=()=>{try{let e=new URL(globalThis.window.location.href);e.searchParams.delete(l),globalThis.window.history.replaceState(null,"",e.toString())}catch{}},I=()=>{let e=k();return e?{retryAttempt:e.retryAttempt,retryId:e.retryId}:{}},T="__SPA_GUARD_FORCE_RETRY__",N=e=>{let t=(p().errors?.ignore??[]).filter(e=>""!==e);return 0!==t.length&&e.filter(e=>"string"==typeof e).some(e=>t.some(t=>e.includes(t)))},E=e=>{let t=[...p().errors?.forceRetry??[],T].filter(e=>""!==e);return e.filter(e=>"string"==typeof e).some(e=>t.some(t=>e.includes(t)))},U=e=>{if((e=>N([e.errorMessage,e.eventMessage]))(e))return;let t=p();if(!t.reportBeacon?.endpoint)return void d()?.noBeaconEndpoint();let r=t.appName?{...e,appName:t.appName}:e,a=JSON.stringify(r);("function"!=typeof globalThis.window?.navigator?.sendBeacon||!globalThis.window.navigator.sendBeacon(t.reportBeacon.endpoint,a))&&"function"==typeof fetch&&fetch(t.reportBeacon.endpoint,{body:a,keepalive:!0,method:"POST"}).catch(e=>{d()?.beaconSendFailed(e)})},A=!1,_=e=>{if(A)d()?.reloadAlreadyScheduled(e);else{A=!0;try{let t,r=p(),a=r.reloadDelays??[1e3,2e3,5e3],n=r.useRetryId??!0,i=r.enableRetryReset??!0,y=r.minTimeBetweenResets??5e3;if(n)t=k();else{let e=(()=>{try{let e=new URLSearchParams(globalThis.window.location.search).get(l);if(e){let t=parseInt(e,10);return Number.isNaN(t)?null:t}return null}catch{return null}})();t=null===e?null:{retryAttempt:e,retryId:S()}}let u=t?t.retryAttempt:0,m=t?.retryId??S();d()?.retryCycleStarting(m,u);let I=s.defaultRetryEnabled;if(c({error:e,isRetrying:I&&u>=0&&u<a.length,name:"chunk-error"}),!I)return void(A=!1);if(i&&t&&t.retryAttempt>0&&((e,t,r=5e3)=>{if(0===e.retryAttempt)return!1;let a=v();if(!a||a.retryId!==e.retryId)return!1;let n=(()=>{if(b())try{let e=sessionStorage.getItem(h);if(e)return JSON.parse(e)}catch{return w}return w})();return!(n&&Date.now()-n.timestamp<r)&&Date.now()-a.timestamp>(t[a.attemptNumber-1]??1e3)+3e4})(t,a,y)){let r=v(),a=r?Date.now()-r.timestamp:0;R(),(()=>{if(b())try{sessionStorage.removeItem(g)}catch{}f=null})(),(e=>{let t={previousRetryId:e,timestamp:Date.now()};if(b())try{sessionStorage.setItem(h,JSON.stringify(t))}catch{w=t}else w=t})(t.retryId);let n=e+"";c({name:"retry-reset",previousAttempt:t.retryAttempt,previousRetryId:t.retryId,timeSinceReload:a},{silent:N([n])}),u=0,m=S()}if(-1===u)return N([e+""])||d()?.fallbackAlreadyShown(e),A=!1,void D();if(u>=a.length){let r=e+"";return c({finalAttempt:u,name:"retry-exhausted",retryId:t?.retryId??""},{silent:N([r])}),U({errorMessage:"Exceeded maximum reload attempts",eventName:"chunk_error_max_reloads",retryAttempt:u,retryId:t?.retryId,serialized:JSON.stringify({error:e+"",retryAttempt:u,retryId:t?.retryId})}),n||$(),A=!1,void D()}let T=u+1,E=a[u]??1e3;c({attempt:T,delay:E,name:"retry-attempt",retryId:m},{silent:N([e+""])}),d()?.retrySchedulingReload(m,T,E),setTimeout(()=>{if(n&&i&&((e,t)=>{let r={attemptNumber:t,retryId:e,timestamp:Date.now()};if(b())try{sessionStorage.setItem(g,JSON.stringify(r))}catch{f=r}else f=r})(m,T),n){let e=((e,t)=>{let r=new URL(globalThis.window.location.href);return r.searchParams.set(o,e),r.searchParams.set(l,t+""),r.toString()})(m,T);globalThis.window.location.href=e}else globalThis.window.location.href=(e=>{let t=new URL(globalThis.window.location.href);return t.searchParams.set(l,e+""),t.toString()})(T)},E)}catch{A=!1}}},D=()=>{let e=p(),t=e.html?.fallback?.content,r=e.html?.fallback?.selector??"body";if(t)try{let a=document.querySelector(r);if(!a)return void d()?.fallbackTargetNotFound(r);a.innerHTML=t;let n=e.useRetryId??!0,o=k();o&&-1===o.retryAttempt?(d()?.clearingRetryState(),R()):!n&&!o&&$();let l=a.querySelector('[data-spa-guard-action="reload"]');if(l&&l.addEventListener("click",()=>location.reload()),o){let e=document.getElementsByClassName("spa-guard-retry-id");for(let t of e)t.textContent=o.retryId}c({name:"fallback-ui-shown"})}catch(e){d()?.fallbackInjectFailed(e)}else d()?.noFallbackConfigured()},z="[spa-guard]",P={"chunk-error":"error","fallback-ui-shown":"warn","lazy-retry-attempt":"warn","lazy-retry-exhausted":"error","lazy-retry-success":"log","retry-attempt":"warn","retry-exhausted":"error","retry-reset":"log"},x=e=>{if(null==e)return{type:"null",value:e};if("object"!=typeof e)return{type:typeof e,value:e};if(e instanceof Error)return{message:e.message,name:e.name,stack:e.stack,type:"Error",...C(e)};if("reason"in e&&"promise"in e)return{reason:x(e.reason),type:"PromiseRejectionEvent"};if("error"in e&&"message"in e&&"filename"in e)return{colno:e.colno,error:x(e.error),filename:e.filename,lineno:e.lineno,message:e.message,type:"ErrorEvent"};if("violatedDirective"in e&&"blockedURI"in e){let t=e;return{blockedURI:t.blockedURI,columnNumber:t.columnNumber,effectiveDirective:t.effectiveDirective,lineNumber:t.lineNumber,originalPolicy:t.originalPolicy,sourceFile:t.sourceFile,type:"SecurityPolicyViolationEvent",violatedDirective:t.violatedDirective}}if("type"in e&&"target"in e){let t=e;return{eventType:t.type,target:j(t.target),timeStamp:t.timeStamp,type:"Event"}}return{type:"object",value:L(e)}},C=e=>{let t={};for(let r of Object.getOwnPropertyNames(e))if(!["message","name","stack"].includes(r))try{t[r]=e[r]}catch{}return t},j=e=>e?e instanceof HTMLElement?{className:e.className,href:e.href,id:e.id,src:e.src,tagName:e.tagName}:{type:e+""}:null,L=e=>{let t={};for(let r of Object.keys(e))try{let a=e[r];t[r]="object"==typeof a?a+"":a}catch{}return t};((e,t)=>{if(t&&(e=>{void 0!==globalThis.window&&(globalThis.window[n]=e)})(t),s.initialized)return;s.initialized=!0,void 0!==globalThis.window&&(globalThis.window[a]=!0);let r=p(),i=r.reloadDelays??[],c=k();c&&c.retryAttempt>=i.length&&(d()?.retryLimitExceeded(c.retryAttempt,i.length),(e=>{try{let t=new URL(globalThis.window.location.href);t.searchParams.set(o,e),t.searchParams.set(l,"-1"),globalThis.window.history.replaceState(null,"",t.toString())}catch{}})(c.retryId));let u=globalThis.window.addEventListener.bind(globalThis.window);u("error",t=>{if(N([t.message]))return;if(d()?.capturedError("error",t),y(t))return t.preventDefault(),void _(t.error??t);if(E([t.message]))return t.preventDefault(),void _(t.error??t);let r=e(t);U({errorMessage:t.message,eventName:"error",serialized:r,...I()})},!0),u("unhandledrejection",t=>{let a=t.reason+"";if(N([a]))return;if(d()?.capturedError("unhandledrejection",t),y(t.reason))return t.preventDefault(),void _(t.reason);if(E([a]))return t.preventDefault(),void _(t.reason);let n=r.handleUnhandledRejections;if(!1!==n?.sendBeacon){let r=e(t);U({errorMessage:a,eventName:"unhandledrejection",serialized:r,...I()})}!1!==n?.retry&&(t.preventDefault(),_(t.reason))}),u("securitypolicyviolation",t=>{let r=`${t.violatedDirective}: ${t.blockedURI}`;if(N([r]))return;d()?.capturedError("csp",t.blockedURI,t.violatedDirective);let a=e(t);U({eventMessage:r,eventName:"securitypolicyviolation",serialized:a,...I()})}),u("vite:preloadError",e=>{N([e?.payload?.message||e?.message])||(d()?.capturedError("vite:preloadError",e),e.preventDefault(),_(e?.payload??e))})})(e=>{try{let t=x(e);return JSON.stringify(t,null,2)}catch{return JSON.stringify({error:"Failed to serialize error",fallback:e+""})}},{beaconSendFailed(e){console.error(z+" Failed to send beacon:",e)},capturedError(e,...t){console.error(`${z} ${e}:capture:`,...t)},clearingRetryState(){console.log(z+" Clearing retry state from URL to allow clean reload attempt")},error(e,...t){console.error(`${z} ${e}`,...t)},fallbackAlreadyShown(e){console.error(z+" Fallback UI was already shown. Not retrying to prevent infinite loop.",e)},fallbackInjectFailed(e){console.error(z+" Failed to inject fallback UI",e)},fallbackTargetNotFound(e){console.error(`${z} Target element not found for selector: ${e}`)},log(e,...t){console.log(`${z} ${e}`,...t)},logEvent(e){let t=P[e.name],r=(e=>{switch(e.name){case"chunk-error":return`${z} chunk-error: isRetrying=${e.isRetrying}`;case"fallback-ui-shown":return z+" fallback-ui-shown";case"lazy-retry-attempt":return`${z} lazy-retry-attempt: attempt ${e.attempt}/${e.totalAttempts}, delay ${e.delay}ms`;case"lazy-retry-exhausted":return`${z} lazy-retry-exhausted: ${e.totalAttempts} attempts, willReload=${e.willReload}`;case"lazy-retry-success":return`${z} lazy-retry-success: succeeded on attempt ${e.attempt}`;case"retry-attempt":return`${z} retry-attempt: attempt ${e.attempt} in ${e.delay}ms (retryId: ${e.retryId})`;case"retry-exhausted":return`${z} retry-exhausted: finalAttempt=${e.finalAttempt} (retryId: ${e.retryId})`;case"retry-reset":return`${z} retry-reset: ${e.timeSinceReload}ms since last reload (retryId: ${e.previousRetryId})`}})(e);"chunk-error"===e.name?console[t](r,e.error):console[t](r)},noBeaconEndpoint(){console.warn(z+" Report endpoint is not configured")},noFallbackConfigured(){console.error(z+" No fallback UI configured")},reloadAlreadyScheduled(e){console.log(z+" Reload already scheduled, ignoring duplicate chunk error:",e)},retryCycleStarting(e,t){console.log(`${z} Retry cycle starting: retryId=${e}, fromAttempt=${t}`)},retryLimitExceeded(e,t){console.log(`${z} Retry limit exceeded (${e}/${t}), marking as fallback shown`)},retrySchedulingReload(e,t,r){console.log(`${z} Scheduling reload: retryId=${e}, attempt=${t}, delay=${r}ms`)},updatedRetryAttempt(e){console.log(`${z} Updated retry attempt to ${e} in URL for fallback UI`)},versionChangeDetected(e,t){console.warn(`${z} New version available (${e??"unknown"} → ${t}). Please refresh to get the latest version.`)},versionCheckAlreadyRunning(){console.warn(z+" Version check already running")},versionCheckDisabled(){console.warn(z+" Version checking disabled: no version configured")},versionCheckFailed(e){console.error(z+" Version check failed",e)},versionCheckHttpError(e){console.warn(`${z} Version check HTTP error: ${e}`)},versionCheckParseError(){console.warn(z+" Failed to parse version from HTML")},versionCheckPaused(){console.log(z+" Version check paused (tab hidden)")},versionCheckRequiresEndpoint(){console.warn(z+" JSON version check mode requires endpoint")},versionCheckResumed(){console.log(z+" Version check resumed (tab visible)")},versionCheckResumedImmediate(){console.log(z+" Version check resumed with immediate check (tab visible, interval elapsed)")},versionCheckStarted(e,t,r){console.log(`${z} Starting version check (mode: ${e}, interval: ${t}ms, current: ${r})`)},versionCheckStopped(){console.log(z+" Version check stopped")},warn(e,...t){console.warn(`${z} ${e}`,...t)}});

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ovineko/spa-guard",
-  "version": "0.0.1-alpha-5",
+  "version": "0.0.1-alpha-7",
   "description": "Chunk load error handling for SPAs with automatic recovery, beacon reporting, and deployment monitoring",
   "keywords": [
     "spa",

package/dist/chunk-L5UEVGWR.js

@@ -1,13 +0,0 @@
-// src/common/errors/ForceRetryError.ts
-var FORCE_RETRY_MAGIC = "__SPA_GUARD_FORCE_RETRY__";
-var ForceRetryError = class extends Error {
-  constructor(message) {
-    super(`${FORCE_RETRY_MAGIC}${message ?? ""}`);
-    this.name = "ForceRetryError";
-  }
-};
-
-export {
-  FORCE_RETRY_MAGIC,
-  ForceRetryError
-};