npm - @ovineko/spa-guard - Versions diffs - 0.0.1-alpha-4 → 0.0.1-alpha-5 - Mend

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

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (31) hide show

package/README.md +219 -15
package/dist/chunk-3SCN2UE4.js +38 -0
package/dist/{chunk-DPOQIK4J.js → chunk-G6QM353W.js} +8 -0
package/dist/{chunk-UMNFZ7IW.js → chunk-IC7SCT5F.js} +2 -2
package/dist/{chunk-7HWVSDJZ.js → chunk-KZEBQNOZ.js} +1 -0
package/dist/chunk-L5UEVGWR.js +13 -0
package/dist/{chunk-FAFKLSME.js → chunk-LGPIRNKE.js} +14 -7
package/dist/{chunk-6XKIZF5S.js → chunk-RFGT43OM.js} +8 -7
package/dist/{chunk-HVBPX75C.js → chunk-RXW44IWI.js} +2 -2
package/dist/{chunk-AB733L4R.js → chunk-WE7SWL5H.js} +1 -1
package/dist/common/errors/BeaconError.d.ts +12 -0
package/dist/common/errors/ForceRetryError.d.ts +5 -0
package/dist/common/index.d.ts +2 -0
package/dist/common/index.js +24 -9
package/dist/common/options.d.ts +22 -0
package/dist/fastify/index.d.ts +1 -0
package/dist/fastify/index.js +15 -20
package/dist/react/index.d.ts +1 -0
package/dist/react/index.js +8 -4
package/dist/react-error-boundary/index.js +6 -5
package/dist/react-router/index.js +6 -5
package/dist/runtime/debug/index.js +8 -2
package/dist/runtime/index.d.ts +1 -0
package/dist/runtime/index.js +6 -2
package/dist/schema/index.d.ts +1 -0
package/dist/schema/index.js +1 -1
package/dist/schema/parse.js +2 -2
package/dist/vite-plugin/index.js +1 -1
package/dist-inline/index.js +1 -1
package/dist-inline-trace/index.js +1 -1
package/package.json +1 -1

package/README.md CHANGED Viewed

@@ -37,6 +37,10 @@ Peer dependencies vary by integration - see sections below for specific requirem
 - ✅ **Event hooks** - React hooks for subscribing to spa-guard events (`useSPAGuardEvents`, `useSPAGuardChunkError`)
 - ✅ **Retry control** - Programmatic control over default retry behavior (`disableDefaultRetry`, `enableDefaultRetry`)
 - ✅ **ESLint plugin** - Enforces usage of spa-guard wrappers instead of direct React imports
+- ✅ **ForceRetryError** - Typed error class that triggers automatic retry without `forceRetry` config
+- ✅ **appName option** - Beacon source identification for monorepo setups
+- ✅ **BeaconError** - Utility class for error tracking service integration (Sentry, Datadog, etc.)
+- ✅ **Configurable unhandled rejection handling** - Control retry and beacon behavior for non-chunk unhandled promise rejections
 ## Quick Start
@@ -52,6 +56,7 @@ export default defineConfig({
   plugins: [
     spaGuardVitePlugin({
       // Production configuration
+      appName: "my-app", // Identifies this app in beacon reports (useful for monorepos)
       reloadDelays: [1000, 2000, 5000], // 3 attempts with increasing delays
       html: {
         fallback: {
@@ -245,6 +250,9 @@ The Vite plugin injects an inline script into your HTML `<head>` that runs **bef
 import { spaGuardVitePlugin } from "@ovineko/spa-guard/vite-plugin";
 spaGuardVitePlugin({
+  // App identification (useful for monorepos)
+  appName: "my-app", // Included in beacon payloads for source identification
   // Retry configuration
   reloadDelays: [1000, 2000, 5000], // Array of delays in milliseconds
   useRetryId: true, // Use query parameters for cache busting (default: true)
@@ -270,6 +278,12 @@ spaGuardVitePlugin({
     forceRetry: [], // Array of error message substrings that trigger retry/reload
   },
+  // Unhandled rejection behavior
+  handleUnhandledRejections: {
+    retry: true, // Attempt page reload on unhandled rejections (default: true)
+    sendBeacon: true, // Send beacon report on unhandled rejections (default: true)
+  },
   // Beacon reporting
   reportBeacon: {
     endpoint: "/api/beacon", // Server endpoint for error reports
@@ -292,6 +306,7 @@ spaGuardVitePlugin({
 ```typescript
 interface Options {
+  appName?: string; // App name for beacon source identification (monorepo setups)
   reloadDelays?: number[]; // Array of retry delays in ms (default: [1000, 2000, 5000])
   useRetryId?: boolean; // Use query params for cache busting (default: true)
   enableRetryReset?: boolean; // Auto-reset retry cycle when enough time passes (default: true)
@@ -311,6 +326,11 @@ interface Options {
     forceRetry?: string[]; // Error message substrings that trigger retry/reload (default: [])
   };
+  handleUnhandledRejections?: {
+    retry?: boolean; // Attempt page reload on unhandled rejections (default: true)
+    sendBeacon?: boolean; // Send beacon report on unhandled rejections (default: true)
+  };
   html?: {
     fallback?: {
       content?: string; // Custom error UI HTML (default: minimal error screen)
@@ -353,6 +373,10 @@ interface VitePluginOptions extends Options {
     ignore: [],
     forceRetry: [],
   },
+  handleUnhandledRejections: {
+    retry: true,
+    sendBeacon: true,
+  },
   html: {
     fallback: {
       content: defaultErrorFallbackHtml, // minimal error screen (auto-generated)
@@ -379,9 +403,10 @@ app.register(fastifySPAGuard, {
   onBeacon: async (beacon, request, reply) => {
     const error = new Error(beacon.errorMessage || "Unknown client error");
-    // Log structured data
+    // Log structured data (appName identifies the source app in monorepos)
     request.log.error(
       {
+        appName: beacon.appName,
         errorMessage: beacon.errorMessage,
         eventName: beacon.eventName,
         eventMessage: beacon.eventMessage,
@@ -405,6 +430,7 @@ app.register(fastifySPAGuard, {
 ```typescript
 interface BeaconSchema {
+  appName?: string; // Source app name (from appName option, useful for monorepos)
   errorMessage?: string; // Error message
   eventMessage?: string; // Event-specific message
   eventName?: string; // Event type (e.g., 'chunk_error_max_reloads', 'error', 'unhandledrejection')
@@ -421,6 +447,83 @@ interface BeaconSchema {
 - `unhandledrejection` - Non-chunk promise rejection
 - `securitypolicyviolation` - CSP violation
+### BeaconError
+`BeaconError` is a utility class that wraps beacon data into a structured `Error` object with typed properties. This makes it easy to integrate with error tracking services like Sentry, Datadog, and others that expect `Error` instances.
+```typescript
+import { BeaconError, fastifySPAGuard } from "@ovineko/spa-guard/fastify";
+// BeaconError is also available from the root entry point:
+// import { BeaconError } from "@ovineko/spa-guard";
+app.register(fastifySPAGuard, {
+  path: "/api/beacon",
+  onBeacon: async (beacon, request) => {
+    const error = new BeaconError(beacon);
+    // Typed properties from the beacon
+    error.appName; // string | undefined
+    error.errorMessage; // string | undefined
+    error.eventName; // string | undefined
+    error.retryAttempt; // number | undefined
+    error.retryId; // string | undefined
+    error.serialized; // string | undefined
+    error.eventMessage; // string | undefined
+    // Standard Error properties
+    error.name; // "BeaconError"
+    error.message; // errorMessage ?? eventMessage ?? "Unknown beacon error"
+    error instanceof Error; // true
+    error instanceof BeaconError; // true
+    // JSON serialization
+    error.toJSON(); // { appName, errorMessage, eventMessage, ... }
+  },
+});
+```
+**Sentry integration:**
+```typescript
+import * as Sentry from "@sentry/node";
+import { BeaconError, fastifySPAGuard } from "@ovineko/spa-guard/fastify";
+app.register(fastifySPAGuard, {
+  path: "/api/beacon",
+  onBeacon: async (beacon) => {
+    const error = new BeaconError(beacon);
+    Sentry.captureException(error, {
+      tags: {
+        appName: error.appName,
+        eventName: error.eventName,
+      },
+      extra: error.toJSON(),
+    });
+    return { skipDefaultLog: true };
+  },
+});
+```
+**Datadog integration:**
+```typescript
+import tracer from "dd-trace";
+import { BeaconError, fastifySPAGuard } from "@ovineko/spa-guard/fastify";
+app.register(fastifySPAGuard, {
+  path: "/api/beacon",
+  onBeacon: async (beacon) => {
+    const error = new BeaconError(beacon);
+    const span = tracer.scope().active();
+    span?.setTag("error", true);
+    span?.setTag("error.message", error.message);
+    span?.setTag("error.type", error.eventName);
+    if (error.appName) span?.setTag("app.name", error.appName);
+    return { skipDefaultLog: true };
+  },
+});
+```
 ### React Integration
 spa-guard provides two React error boundary components with automatic chunk error recovery.
@@ -1019,6 +1122,7 @@ Return `{ skipDefaultLog: true }` from `onBeacon` or `onUnknownBeacon` to suppre
 ```typescript
 interface Options {
+  appName?: string; // App name for beacon source identification (monorepo setups)
   reloadDelays?: number[]; // Retry delays in ms (default: [1000, 2000, 5000])
   useRetryId?: boolean; // Use query params for cache busting (default: true)
   enableRetryReset?: boolean; // Auto-reset retry cycle when enough time passes (default: true)
@@ -1038,6 +1142,11 @@ interface Options {
     forceRetry?: string[]; // Error message substrings that trigger retry/reload (default: [])
   };
+  handleUnhandledRejections?: {
+    retry?: boolean; // Attempt page reload on unhandled rejections (default: true)
+    sendBeacon?: boolean; // Send beacon report on unhandled rejections (default: true)
+  };
   html?: {
     fallback?: {
       content?: string; // Custom error UI HTML
@@ -1071,6 +1180,7 @@ interface VitePluginOptions extends Options {
 ```typescript
 interface BeaconSchema {
+  appName?: string; // Source app name (from appName option)
   errorMessage?: string;
   eventMessage?: string;
   eventName?: string;
@@ -1092,6 +1202,8 @@ From `@ovineko/spa-guard`:
 - `disableDefaultRetry()` - Disable inline script's automatic retry
 - `enableDefaultRetry()` - Re-enable automatic retry
 - `isDefaultRetryEnabled()` - Check if default retry is enabled
+- `ForceRetryError` - Error class that triggers automatic retry when thrown
+- `BeaconError` - Utility class that wraps beacon data into a structured Error
 ### Schema Exports
@@ -1113,6 +1225,7 @@ From `@ovineko/spa-guard/runtime`:
 - `subscribeToState(callback)` - Subscribe to state changes, returns unsubscribe function
 - `startVersionCheck()` - Start periodic version polling
 - `stopVersionCheck()` - Stop version polling
+- `ForceRetryError` - Error class that triggers automatic retry when thrown
 - `SpaGuardState` - TypeScript type for state object
 - `RecommendedSetupOptions` - TypeScript type for recommendedSetup overrides
@@ -1343,14 +1456,14 @@ spa-guard provides 11 export entry points:
 | Export                   | Description                                                                                                                   | Peer Dependencies                                 |
 | ------------------------ | ----------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------- |
-| `.`                      | Core functionality (events, listen, options, retry control)                                                                   | None                                              |
+| `.`                      | Core functionality (events, listen, options, retry control, ForceRetryError, BeaconError)                                     | None                                              |
 | `./schema`               | BeaconSchema type definitions                                                                                                 | `typebox@^1`                                      |
 | `./schema/parse`         | Beacon parsing utilities                                                                                                      | `typebox@^1`                                      |
-| `./runtime`              | Runtime state management and subscriptions                                                                                    | None                                              |
+| `./runtime`              | Runtime state management, subscriptions, and ForceRetryError                                                                  | None                                              |
 | `./react`                | React hooks and components (useSpaGuardState, useSPAGuardEvents, useSPAGuardChunkError, lazyWithRetry, DebugSyncErrorTrigger) | `react@^19`                                       |
 | `./runtime/debug`        | Debug panel factory (`createDebugger`) - framework-agnostic vanilla JS                                                        | None                                              |
 | `./react-router`         | React Router error boundary (ErrorBoundaryReactRouter)                                                                        | `react@^19`, `react-router@^7`                    |
-| `./fastify`              | Fastify server plugin                                                                                                         | `fastify@^5 \|\| ^4`, `fastify-plugin@^5 \|\| ^4` |
+| `./fastify`              | Fastify server plugin and BeaconError                                                                                         | `fastify@^5 \|\| ^4`, `fastify-plugin@^5 \|\| ^4` |
 | `./vite-plugin`          | Vite build plugin                                                                                                             | `vite@^8 \|\| ^7`                                 |
 | `./react-error-boundary` | React error boundary component (ErrorBoundary)                                                                                | `react@^19`                                       |
 | `./eslint`               | ESLint plugin with `configs.recommended` preset (`no-direct-error-boundary`, `no-direct-lazy`)                                | `eslint@^9 \|\| ^10` (optional)                   |
@@ -1358,22 +1471,32 @@ spa-guard provides 11 export entry points:
 **Import examples:**
 ```typescript
-// Core
-import { events, listen, disableDefaultRetry } from "@ovineko/spa-guard";
-// Runtime state + version check
-import { getState, subscribeToState, startVersionCheck } from "@ovineko/spa-guard/runtime";
+// Core (ForceRetryError and BeaconError also available here)
+import {
+  events,
+  listen,
+  disableDefaultRetry,
+  ForceRetryError,
+  BeaconError,
+} from "@ovineko/spa-guard";
+// Runtime state + version check + ForceRetryError
+import {
+  getState,
+  subscribeToState,
+  startVersionCheck,
+  ForceRetryError,
+} from "@ovineko/spa-guard/runtime";
-// React hooks and components
+// React hooks, components, and ForceRetryError
 import {
   useSpaGuardState,
   useSPAGuardEvents,
   useSPAGuardChunkError,
   DebugSyncErrorTrigger,
+  ForceRetryError,
+  lazyWithRetry,
 } from "@ovineko/spa-guard/react";
-// Lazy imports with retry
-import { lazyWithRetry } from "@ovineko/spa-guard/react";
 import type { LazyRetryOptions } from "@ovineko/spa-guard/react";
 // Debug panel (framework-agnostic)
@@ -1389,8 +1512,8 @@ import type { BeaconSchema } from "@ovineko/spa-guard/schema";
 // Vite plugin
 import { spaGuardVitePlugin } from "@ovineko/spa-guard/vite-plugin";
-// Fastify
-import { fastifySPAGuard } from "@ovineko/spa-guard/fastify";
+// Fastify (BeaconError also available here)
+import { fastifySPAGuard, BeaconError } from "@ovineko/spa-guard/fastify";
 // ESLint plugin
 import spaGuardEslint from "@ovineko/spa-guard/eslint";
@@ -1527,6 +1650,87 @@ spaGuardVitePlugin({
 **`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.
+### Configuring Unhandled Rejection Handling
+By default, spa-guard retries **and** sends a beacon for regular unhandled promise rejections (those that are not chunk errors or ForceRetry errors). You can control this behavior with the `handleUnhandledRejections` option:
+```typescript
+spaGuardVitePlugin({
+  handleUnhandledRejections: {
+    retry: true, // Attempt page reload (default: true)
+    sendBeacon: true, // Send error report to server (default: true)
+  },
+});
+```
+**Behavior matrix:**
+| `retry` | `sendBeacon` | Behavior                                         |
+| ------- | ------------ | ------------------------------------------------ |
+| `true`  | `true`       | Send beacon first, then attempt reload (default) |
+| `true`  | `false`      | Attempt reload only                              |
+| `false` | `true`       | Send beacon only (pre-v0.0.1-alpha behavior)     |
+| `false` | `false`      | Do nothing (only the captured error log remains) |
+**Examples:**
+```typescript
+// Restore pre-default behavior: beacon only, no retry
+spaGuardVitePlugin({
+  handleUnhandledRejections: {
+    retry: false,
+  },
+});
+// Silent mode: only log, no retry or beacon
+spaGuardVitePlugin({
+  handleUnhandledRejections: {
+    retry: false,
+    sendBeacon: false,
+  },
+});
+```
+**Note:** Chunk load errors and `ForceRetryError` always bypass this configuration and use their own dedicated handling paths regardless of these settings.
+### ForceRetryError
+`ForceRetryError` is a typed error class that automatically triggers spa-guard's retry mechanism when thrown, without requiring any `errors.forceRetry` configuration. It works by prepending a magic substring to the error message that spa-guard always recognizes.
+```typescript
+import { ForceRetryError } from "@ovineko/spa-guard";
+// or
+import { ForceRetryError } from "@ovineko/spa-guard/react";
+// or
+import { ForceRetryError } from "@ovineko/spa-guard/runtime";
+// Throw in any error handler to trigger automatic retry
+throw new ForceRetryError("stale module detected");
+// Works with no message too
+throw new ForceRetryError();
+```
+**Use cases:**
+- Custom module loaders that detect stale deployments
+- Service workers that need to force a refresh
+- API responses indicating version mismatch
+**How it works:**
+1. `ForceRetryError` prepends a magic substring (`__SPA_GUARD_FORCE_RETRY__`) to the error message
+2. `shouldForceRetry()` always checks for this substring, regardless of `errors.forceRetry` config
+3. When matched, spa-guard triggers the same retry/reload cycle as chunk load errors
+```typescript
+const err = new ForceRetryError("version mismatch");
+err.name; // "ForceRetryError"
+err.message; // "__SPA_GUARD_FORCE_RETRY__version mismatch"
+err instanceof ForceRetryError; // true
+err instanceof Error; // true
+```
 ### Custom Retry Strategy
 Adjust retry delays for different environments:

package/dist/chunk-3SCN2UE4.js ADDED Viewed

@@ -0,0 +1,38 @@
+// src/common/errors/BeaconError.ts
+var BeaconError = class extends Error {
+  appName;
+  errorMessage;
+  eventMessage;
+  eventName;
+  retryAttempt;
+  retryId;
+  serialized;
+  constructor(beacon) {
+    super(beacon.errorMessage ?? beacon.eventMessage ?? "Unknown beacon error");
+    this.name = "BeaconError";
+    this.appName = beacon.appName;
+    this.errorMessage = beacon.errorMessage;
+    this.eventMessage = beacon.eventMessage;
+    this.eventName = beacon.eventName;
+    this.retryAttempt = beacon.retryAttempt;
+    this.retryId = beacon.retryId;
+    this.serialized = beacon.serialized;
+  }
+  toJSON() {
+    return {
+      appName: this.appName,
+      errorMessage: this.errorMessage,
+      eventMessage: this.eventMessage,
+      eventName: this.eventName,
+      message: this.message,
+      name: this.name,
+      retryAttempt: this.retryAttempt,
+      retryId: this.retryId,
+      serialized: this.serialized
+    };
+  }
+};
+export {
+  BeaconError
+};

package/dist/{chunk-DPOQIK4J.js → chunk-G6QM353W.js} RENAMED Viewed

@@ -28,6 +28,10 @@ var defaultOptions = {
     forceRetry: [],
     ignore: []
   },
+  handleUnhandledRejections: {
+    retry: true,
+    sendBeacon: true
+  },
   html: {
     fallback: {
       content: defaultErrorFallbackHtml,
@@ -58,6 +62,10 @@ var getOptions = () => {
       ...defaultOptions.errors,
       ...windowOptions?.errors
     },
+    handleUnhandledRejections: {
+      ...defaultOptions.handleUnhandledRejections,
+      ...windowOptions?.handleUnhandledRejections
+    },
     html: {
       fallback: {
         ...defaultOptions.html?.fallback,

package/dist/{chunk-UMNFZ7IW.js → chunk-IC7SCT5F.js} RENAMED Viewed

@@ -1,7 +1,7 @@
 import {
   attemptReload,
   isChunkError
-} from "./chunk-6XKIZF5S.js";
+} from "./chunk-RFGT43OM.js";
 import {
   getState,
   subscribeToState
@@ -13,7 +13,7 @@ import {
 } from "./chunk-T5RWH2HR.js";
 import {
   getOptions
-} from "./chunk-DPOQIK4J.js";
+} from "./chunk-G6QM353W.js";
 import {
   debugSyncErrorEventType
 } from "./chunk-EDRTFPCN.js";

package/dist/{chunk-7HWVSDJZ.js → chunk-KZEBQNOZ.js} RENAMED Viewed

@@ -2,6 +2,7 @@
 import { Type } from "typebox";
 var beaconSchema = Type.Object(
   {
+    appName: Type.Optional(Type.String()),
     errorMessage: Type.Optional(Type.String()),
     eventMessage: Type.Optional(Type.String()),
     eventName: Type.Optional(Type.String()),

package/dist/chunk-L5UEVGWR.js ADDED Viewed

@@ -0,0 +1,13 @@
+// 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
+};

package/dist/{chunk-FAFKLSME.js → chunk-LGPIRNKE.js} RENAMED Viewed

@@ -3,7 +3,7 @@ import {
 } from "./chunk-T5RWH2HR.js";
 import {
   getOptions
-} from "./chunk-DPOQIK4J.js";
+} from "./chunk-G6QM353W.js";
 // src/common/checkVersion.ts
 var versionCheckInterval = null;
@@ -14,7 +14,7 @@ var visibilityHandler = null;
 var focusHandler = null;
 var blurHandler = null;
 var checkInProgress = false;
-var stopped = false;
+var runEpoch = 0;
 var fetchJsonVersion = async () => {
   const endpoint = getOptions().checkVersion?.endpoint;
   if (!endpoint) {
@@ -30,7 +30,10 @@ var fetchJsonVersion = async () => {
     return null;
   }
   const data = await response.json();
-  return data.version ?? null;
+  if (typeof data !== "object" || data === null) {
+    return null;
+  }
+  return "version" in data && typeof data.version === "string" ? data.version : null;
 };
 var fetchHtmlVersion = async () => {
   const url = new URL(globalThis.location.href);
@@ -73,9 +76,10 @@ var checkVersionOnce = async (mode) => {
     return;
   }
   checkInProgress = true;
+  const epochAtStart = runEpoch;
   try {
     const remoteVersion = await fetchRemoteVersion(mode);
-    if (stopped) {
+    if (epochAtStart !== runEpoch) {
       return;
     }
     if (remoteVersion && remoteVersion !== lastKnownVersion) {
@@ -86,7 +90,9 @@ var checkVersionOnce = async (mode) => {
   } catch (error) {
     getLogger()?.versionCheckFailed(error);
   } finally {
-    checkInProgress = false;
+    if (epochAtStart === runEpoch) {
+      checkInProgress = false;
+    }
   }
 };
 var startPolling = (mode, interval) => {
@@ -144,7 +150,7 @@ var startVersionCheck = () => {
     getLogger()?.versionCheckAlreadyRunning();
     return;
   }
-  stopped = false;
+  runEpoch++;
   lastKnownVersion = options.version;
   const interval = options.checkVersion?.interval ?? 3e5;
   const mode = options.checkVersion?.mode ?? "html";
@@ -176,7 +182,8 @@ var startVersionCheck = () => {
   globalThis.addEventListener("blur", blurHandler);
 };
 var stopVersionCheck = () => {
-  stopped = true;
+  runEpoch++;
+  checkInProgress = false;
   const wasRunning = versionCheckInterval !== null || versionCheckTimeout !== null || visibilityHandler !== null;
   clearTimers();
   if (visibilityHandler !== null) {

package/dist/{chunk-6XKIZF5S.js → chunk-RFGT43OM.js} RENAMED Viewed

@@ -1,3 +1,6 @@
+import {
+  FORCE_RETRY_MAGIC
+} from "./chunk-L5UEVGWR.js";
 import {
   clearLastReloadTime,
   clearRetryAttemptFromUrl,
@@ -15,7 +18,7 @@ import {
 } from "./chunk-T5RWH2HR.js";
 import {
   getOptions
-} from "./chunk-DPOQIK4J.js";
+} from "./chunk-G6QM353W.js";
 import {
   RETRY_ATTEMPT_PARAM,
   RETRY_ID_PARAM
@@ -68,10 +71,7 @@ var shouldIgnoreMessages = (messages) => {
 };
 var shouldForceRetry = (messages) => {
   const options = getOptions();
-  const forceRetryPatterns = options.errors?.forceRetry ?? [];
-  if (forceRetryPatterns.length === 0) {
-    return false;
-  }
+  const forceRetryPatterns = [...options.errors?.forceRetry ?? [], FORCE_RETRY_MAGIC];
   const validMessages = messages.filter((msg) => typeof msg === "string");
   return validMessages.some(
     (message) => forceRetryPatterns.some((pattern) => message.includes(pattern))
@@ -91,8 +91,9 @@ var sendBeacon = (beacon) => {
     getLogger()?.noBeaconEndpoint();
     return;
   }
-  const body = JSON.stringify(beacon);
-  const isSendBeaconAvailable = typeof globalThis.window?.navigator.sendBeacon === "function";
+  const enrichedBeacon = options.appName ? { ...beacon, appName: options.appName } : 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) {
     fetch(options.reportBeacon.endpoint, { body, keepalive: true, method: "POST" }).catch(

package/dist/{chunk-HVBPX75C.js → chunk-RXW44IWI.js} RENAMED Viewed

@@ -6,14 +6,14 @@ import {
   isChunkError,
   sendBeacon,
   shouldForceRetry
-} from "./chunk-6XKIZF5S.js";
+} from "./chunk-RFGT43OM.js";
 import {
   getRetryInfoForBeacon
 } from "./chunk-T5RWH2HR.js";
 import {
   defaultErrorFallbackHtml,
   defaultLoadingFallbackHtml
-} from "./chunk-DPOQIK4J.js";
+} from "./chunk-G6QM353W.js";
 // src/common/DefaultErrorFallback.tsx
 import { useLayoutEffect, useMemo, useRef } from "react";

package/dist/{chunk-AB733L4R.js → chunk-WE7SWL5H.js} RENAMED Viewed

@@ -1,6 +1,6 @@
 import {
   beaconSchema
-} from "./chunk-7HWVSDJZ.js";
+} from "./chunk-KZEBQNOZ.js";
 // src/schema/parse.ts
 import { Value } from "typebox/value";

package/dist/common/errors/BeaconError.d.ts ADDED Viewed

@@ -0,0 +1,12 @@
+import type { BeaconSchema } from "../../schema";
+export declare class BeaconError extends Error {
+    readonly appName: string | undefined;
+    readonly errorMessage: string | undefined;
+    readonly eventMessage: string | undefined;
+    readonly eventName: string | undefined;
+    readonly retryAttempt: number | undefined;
+    readonly retryId: string | undefined;
+    readonly serialized: string | undefined;
+    constructor(beacon: BeaconSchema);
+    toJSON(): Record<string, unknown>;
+}

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

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

package/dist/common/index.d.ts CHANGED Viewed

@@ -1,3 +1,5 @@
+export { BeaconError } from "./errors/BeaconError";
+export { ForceRetryError } from "./errors/ForceRetryError";
 export * as events from "./events";
 export { disableDefaultRetry, enableDefaultRetry, isDefaultRetryEnabled } from "./events/internal";
 export { listen } from "./listen";

package/dist/common/index.js CHANGED Viewed

@@ -1,3 +1,6 @@
+import {
+  BeaconError
+} from "../chunk-3SCN2UE4.js";
 import {
   serializeError
 } from "../chunk-HUAI4DRW.js";
@@ -7,7 +10,10 @@ import {
   sendBeacon,
   shouldForceRetry,
   shouldIgnoreMessages
-} from "../chunk-6XKIZF5S.js";
+} from "../chunk-RFGT43OM.js";
+import {
+  ForceRetryError
+} from "../chunk-L5UEVGWR.js";
 import {
   disableDefaultRetry,
   emitEvent,
@@ -25,7 +31,7 @@ import {
 import {
   getOptions,
   options_exports
-} from "../chunk-DPOQIK4J.js";
+} from "../chunk-G6QM353W.js";
 import "../chunk-EDRTFPCN.js";
 import "../chunk-RP52SPBK.js";
 import {
@@ -246,13 +252,20 @@ var listenInternal = (serializeError2, logger) => {
       attemptReload(event.reason);
       return;
     }
-    const serialized = serializeError2(event);
-    sendBeacon({
-      errorMessage,
-      eventName: "unhandledrejection",
-      serialized,
-      ...getRetryInfoForBeacon()
-    });
+    const rejectionConfig = options.handleUnhandledRejections;
+    if (rejectionConfig?.sendBeacon !== false) {
+      const serialized = serializeError2(event);
+      sendBeacon({
+        errorMessage,
+        eventName: "unhandledrejection",
+        serialized,
+        ...getRetryInfoForBeacon()
+      });
+    }
+    if (rejectionConfig?.retry !== false) {
+      event.preventDefault();
+      attemptReload(event.reason);
+    }
   });
   wa("securitypolicyviolation", (event) => {
     const eventMessage = `${event.violatedDirective}: ${event.blockedURI}`;
@@ -287,6 +300,8 @@ var listen = () => {
   listenInternal(serializeError, createLogger());
 };
 export {
+  BeaconError,
+  ForceRetryError,
   disableDefaultRetry,
   enableDefaultRetry,
   events_exports as events,

package/dist/common/options.d.ts CHANGED Viewed

@@ -1,5 +1,10 @@
 export { optionsWindowKey } from "./constants";
 export interface Options {
+    /**
+     * Application name for beacon source identification.
+     * Useful in monorepo setups to identify which app sent the beacon.
+     */
+    appName?: string;
     /**
      * Configuration for proactive version checking to detect new deployments.
      * When configured with a `version`, periodically polls to detect version changes
@@ -55,6 +60,23 @@ export interface Options {
          */
         ignore?: string[];
     };
+    /**
+     * Controls behavior for regular unhandled promise rejections
+     * (those that are not chunk errors or ForceRetry errors).
+     * @default { retry: true, sendBeacon: true }
+     */
+    handleUnhandledRejections?: {
+        /**
+         * Whether to attempt a page reload on unhandled rejections.
+         * @default true
+         */
+        retry?: boolean;
+        /**
+         * Whether to send a beacon report on unhandled rejections.
+         * @default true
+         */
+        sendBeacon?: boolean;
+    };
     html?: {
         fallback?: {
             /** Custom HTML to display when all reload attempts are exhausted */

package/dist/fastify/index.d.ts CHANGED Viewed

@@ -1,5 +1,6 @@
 import type { FastifyPluginAsync, FastifyReply, FastifyRequest } from "fastify";
 import type { BeaconSchema } from "../schema";
+export { BeaconError } from "../common/errors/BeaconError";
 export interface BeaconHandlerResult {
     /**
      * If true, skips default logging behavior

package/dist/fastify/index.js CHANGED Viewed

@@ -1,7 +1,10 @@
 import {
   parseBeacon
-} from "../chunk-AB733L4R.js";
-import "../chunk-7HWVSDJZ.js";
+} from "../chunk-WE7SWL5H.js";
+import "../chunk-KZEBQNOZ.js";
+import {
+  BeaconError
+} from "../chunk-3SCN2UE4.js";
 import {
   name
 } from "../chunk-RP52SPBK.js";
@@ -37,29 +40,20 @@ var handleBeaconRequest = async (params) => {
     }
     return;
   }
+  const logPayload = {
+    ...beacon.appName && { appName: beacon.appName },
+    errorMessage: beacon.errorMessage,
+    eventMessage: beacon.eventMessage,
+    eventName: beacon.eventName,
+    serialized: beacon.serialized
+  };
   if (options.onBeacon) {
     const result = await options.onBeacon(beacon, request, reply);
     if (!result?.skipDefaultLog) {
-      request.log.info(
-        {
-          errorMessage: beacon.errorMessage,
-          eventMessage: beacon.eventMessage,
-          eventName: beacon.eventName,
-          serialized: beacon.serialized
-        },
-        logMessage("Beacon received")
-      );
+      request.log.info(logPayload, logMessage("Beacon received"));
     }
   } else {
-    request.log.info(
-      {
-        errorMessage: beacon.errorMessage,
-        eventMessage: beacon.eventMessage,
-        eventName: beacon.eventName,
-        serialized: beacon.serialized
-      },
-      logMessage("Beacon received")
-    );
+    request.log.info(logPayload, logMessage("Beacon received"));
   }
 };
 var fastifySPAGuardPlugin = async (fastify, options) => {
@@ -85,5 +79,6 @@ var fastifySPAGuard = fp(fastifySPAGuardPlugin, {
   name: `${name}/fastify`
 });
 export {
+  BeaconError,
   fastifySPAGuard
 };

package/dist/react/index.d.ts CHANGED Viewed

@@ -1,3 +1,4 @@
+export { ForceRetryError } from "../common/errors/ForceRetryError";
 export type { SpaGuardState } from "../runtime";
 export { DebugSyncErrorTrigger } from "./DebugSyncErrorTrigger";
 export { lazyWithRetry } from "./lazyWithRetry";

package/dist/react/index.js CHANGED Viewed

@@ -4,17 +4,21 @@ import {
   useSPAGuardChunkError,
   useSPAGuardEvents,
   useSpaGuardState
-} from "../chunk-UMNFZ7IW.js";
-import "../chunk-6XKIZF5S.js";
-import "../chunk-FAFKLSME.js";
+} from "../chunk-IC7SCT5F.js";
+import "../chunk-RFGT43OM.js";
+import "../chunk-LGPIRNKE.js";
 import "../chunk-2DFYUVHH.js";
+import {
+  ForceRetryError
+} from "../chunk-L5UEVGWR.js";
 import "../chunk-T5RWH2HR.js";
-import "../chunk-DPOQIK4J.js";
+import "../chunk-G6QM353W.js";
 import "../chunk-EDRTFPCN.js";
 import "../chunk-RP52SPBK.js";
 import "../chunk-MLKGABMK.js";
 export {
   DebugSyncErrorTrigger,
+  ForceRetryError,
   lazyWithRetry,
   useSPAGuardChunkError,
   useSPAGuardEvents,

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

@@ -1,18 +1,19 @@
 import {
   DefaultErrorFallback,
   handleErrorWithSpaGuard
-} from "../chunk-HVBPX75C.js";
+} from "../chunk-RXW44IWI.js";
 import "../chunk-HUAI4DRW.js";
 import {
   useSpaGuardState
-} from "../chunk-UMNFZ7IW.js";
+} from "../chunk-IC7SCT5F.js";
 import {
   isChunkError
-} from "../chunk-6XKIZF5S.js";
-import "../chunk-FAFKLSME.js";
+} from "../chunk-RFGT43OM.js";
+import "../chunk-LGPIRNKE.js";
 import "../chunk-2DFYUVHH.js";
+import "../chunk-L5UEVGWR.js";
 import "../chunk-T5RWH2HR.js";
-import "../chunk-DPOQIK4J.js";
+import "../chunk-G6QM353W.js";
 import "../chunk-EDRTFPCN.js";
 import "../chunk-RP52SPBK.js";
 import "../chunk-MLKGABMK.js";

package/dist/react-router/index.js CHANGED Viewed

@@ -1,18 +1,19 @@
 import {
   DefaultErrorFallback,
   handleErrorWithSpaGuard
-} from "../chunk-HVBPX75C.js";
+} from "../chunk-RXW44IWI.js";
 import "../chunk-HUAI4DRW.js";
 import {
   useSpaGuardState
-} from "../chunk-UMNFZ7IW.js";
+} from "../chunk-IC7SCT5F.js";
 import {
   isChunkError
-} from "../chunk-6XKIZF5S.js";
-import "../chunk-FAFKLSME.js";
+} from "../chunk-RFGT43OM.js";
+import "../chunk-LGPIRNKE.js";
 import "../chunk-2DFYUVHH.js";
+import "../chunk-L5UEVGWR.js";
 import "../chunk-T5RWH2HR.js";
-import "../chunk-DPOQIK4J.js";
+import "../chunk-G6QM353W.js";
 import "../chunk-EDRTFPCN.js";
 import "../chunk-RP52SPBK.js";
 import "../chunk-MLKGABMK.js";

package/dist/runtime/debug/index.js CHANGED Viewed

@@ -59,6 +59,11 @@ function createDebugger(options) {
     console.warn("[spa-guard] Debug panel already exists. Returning existing cleanup function.");
     return activeInstance;
   }
+  if (!document.body) {
+    console.warn("[spa-guard] document.body is not available. Debug panel cannot be mounted.");
+    return () => {
+    };
+  }
   let isOpen = options?.defaultOpen ?? true;
   const unsubscribers = [];
   const panel = el(
@@ -151,7 +156,7 @@ function createEventsSection(unsubscribers) {
     "debug-event-list"
   );
   section.append(eventList);
-  wireEventSubscription(countSpan, clearBtn, eventList, unsubscribers);
+  wireEventSubscription({ clearBtn, countSpan, eventList, unsubscribers });
   return section;
 }
 function createHeader(isOpen) {
@@ -239,7 +244,8 @@ function getButtonLabel(label, status) {
     }
   }
 }
-function wireEventSubscription(countSpan, clearBtn, eventList, unsubscribers) {
+function wireEventSubscription(params) {
+  const { clearBtn, countSpan, eventList, unsubscribers } = params;
   let history = [];
   function render() {
     countSpan.textContent = `Event History (${String(history.length)})`;

package/dist/runtime/index.d.ts CHANGED Viewed

@@ -1,4 +1,5 @@
 export { startVersionCheck, stopVersionCheck } from "../common/checkVersion";
+export { ForceRetryError } from "../common/errors/ForceRetryError";
 export { recommendedSetup } from "./recommendedSetup";
 export type { RecommendedSetupOptions } from "./recommendedSetup";
 export { getState, subscribeToState } from "./state";

package/dist/runtime/index.js CHANGED Viewed

@@ -2,17 +2,21 @@ import {
   recommendedSetup,
   startVersionCheck,
   stopVersionCheck
-} from "../chunk-FAFKLSME.js";
+} from "../chunk-LGPIRNKE.js";
 import {
   getState,
   subscribeToState
 } from "../chunk-2DFYUVHH.js";
+import {
+  ForceRetryError
+} from "../chunk-L5UEVGWR.js";
 import "../chunk-T5RWH2HR.js";
-import "../chunk-DPOQIK4J.js";
+import "../chunk-G6QM353W.js";
 import "../chunk-EDRTFPCN.js";
 import "../chunk-RP52SPBK.js";
 import "../chunk-MLKGABMK.js";
 export {
+  ForceRetryError,
   getState,
   recommendedSetup,
   startVersionCheck,

package/dist/schema/index.d.ts CHANGED Viewed

@@ -1,5 +1,6 @@
 import { Type } from "typebox";
 export declare const beaconSchema: Type.TObject<{
+    appName: Type.TOptional<Type.TString>;
     errorMessage: Type.TOptional<Type.TString>;
     eventMessage: Type.TOptional<Type.TString>;
     eventName: Type.TOptional<Type.TString>;

package/dist/schema/index.js CHANGED Viewed

@@ -1,6 +1,6 @@
 import {
   beaconSchema
-} from "../chunk-7HWVSDJZ.js";
+} from "../chunk-KZEBQNOZ.js";
 import "../chunk-MLKGABMK.js";
 export {
   beaconSchema

package/dist/schema/parse.js CHANGED Viewed

@@ -1,7 +1,7 @@
 import {
   parseBeacon
-} from "../chunk-AB733L4R.js";
-import "../chunk-7HWVSDJZ.js";
+} from "../chunk-WE7SWL5H.js";
+import "../chunk-KZEBQNOZ.js";
 import "../chunk-MLKGABMK.js";
 export {
   parseBeacon

package/dist/vite-plugin/index.js CHANGED Viewed

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

package/dist-inline/index.js CHANGED Viewed

	@@ -1 +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=g(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))},g=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?g(e.reason):null,m={checkVersion:{interval:3e5,mode:"html",onUpdate:"reload"},enableRetryReset:!0,errors:{forceRetry:[],ignore:[]},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},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}}},p="__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(p);if(e)return JSON.parse(e)}catch{return f}return f},S=()=>{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{}},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(l),globalThis.window.history.replaceState(null,"",e.toString())}catch{}},k=()=>{let e=S();return e?{retryAttempt:e.retryAttempt,retryId:e.retryId}:{}},_=e=>{let t=u().errors?.ignore??[];return 0!==t.length&&e.filter(e=>"string"==typeof e).some(e=>t.some(t=>e.includes(t)))},A=e=>{let t=u().errors?.forceRetry??[];return ~~0!==t.length&&~~e.filter(e=>"string"==typeof e).some(e=>t.some(t=>e.includes(t)))},N=e=>{if((e=>_([e.errorMessage,e.eventMessage]))(e))return;let t=u();if(!t.reportBeacon?.endpoint)return void d()?.noBeaconEndpoint();let r=JSON.stringify(e);"function"==typeof globalThis.window?.navigator.sendBeacon&&globalThis.window.navigator.sendBeacon(t.reportBeacon.endpoint,r)\|\|fetch(t.reportBeacon.endpoint,{body:r,keepalive:!0,method:"POST"}).catch(e=>{d()?.beaconSendFailed(e)})},D=!1,E=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=S();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:I()}}let g=t?t.retryAttempt:0,m=t?.retryId??I();d()?.retryCycleStarting(m,g);let k=s.defaultRetryEnabled;if(c({error:e,isRetrying:k&&g>=0&&g<a.length,name:"chunk-error"}),!k)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(p)}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])}),g=0,m=I()}if(-1===g)return _([e+""])\|\|d()?.fallbackAlreadyShown(e),void U();if(g>=a.length){let r=e+"";return c({finalAttempt:g,name:"retry-exhausted",retryId:t?.retryId??""},{silent:_([r])}),N({errorMessage:"Exceeded maximum reload attempts",eventName:"chunk_error_max_reloads",retryAttempt:g,retryId:t?.retryId,serialized:JSON.stringify({error:e+"",retryAttempt:g,retryId:t?.retryId})}),n\|\|T(),void U()}let A=g+1,E=a[g]??1e3;c({attempt:A,delay:E,name:"retry-attempt",retryId:m},{silent:_([e+""])}),D=!0,d()?.retrySchedulingReload(m,A,E),setTimeout(()=>{if(n&&i&&((e,t)=>{let r={attemptNumber:t,retryId:e,timestamp:Date.now()};if(b())try{sessionStorage.setItem(p,JSON.stringify(r))}catch{f=r}else f=r})(m,A),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,A);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()})(A)},E)},U=()=>{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,o=S();if(o&&-1===o.retryAttempt?(d()?.clearingRetryState(),R()):!n&&!o&&T(),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()};(()=>{if(s.initialized)return;s.initialized=!0,void 0!==globalThis.window&&(globalThis.window[a]=!0);let e=u().reloadDelays??[],t=S();t&&t.retryAttempt>=e.length&&(d()?.retryLimitExceeded(t.retryAttempt,e.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{}})(t.retryId));let r=globalThis.window.addEventListener.bind(globalThis.window);r("error",e=>(_([e.message])\|\|d()?.capturedError("error",e),y(e)\|\|A([e.message])?(e.preventDefault(),void E(e.error??e)):void N({errorMessage:e.message,eventName:"error",serialized:"",...k()})),!0),r("unhandledrejection",e=>{let t=e.reason+"";~~return _~~([t])\|\|d()?.capturedError("unhandledrejection",e),y(e.reason)~~\|\|A~~([t])~~?(e~~.preventDefault(),void E(e.reason)~~):void~~ N({errorMessage:t,eventName:"unhandledrejection",serialized:"",...k()})}),r("securitypolicyviolation",e=>{let t=`${e.violatedDirective}: ${e.blockedURI}`;_([t])\|\|d()?.capturedError("csp",e.blockedURI,e.violatedDirective),N({eventMessage:t,eventName:"securitypolicyviolation",serialized:"",...k()})}),r("vite:preloadError",e=>{_([e?.payload?.message\|\|e?.message])\|\|d()?.capturedError("vite:preloadError",e),e.preventDefault(),E(e?.payload??e)})})();
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)})})();

package/dist-inline-trace/index.js CHANGED Viewed

	@@ -1 +1 @@
1	- var e="@ovineko/spa-guard",t=Symbol.for(e+":event-subscribers"),r=Symbol.for(e+":internal-config"),a=Symbol.for(e+":initialized"),o=Symbol.for(e+":logger"),n="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?.[o],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:[]},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},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(n),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}},S=()=>{try{let e=new URL(globalThis.window.location.href);e.searchParams.delete(n),e.searchParams.delete(l),globalThis.window.history.replaceState(null,"",e.toString())}catch{}},R=()=>{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??[];return 0!==t.length&&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=JSON.stringify(e);"function"==typeof globalThis.window?.navigator.sendBeacon&&globalThis.window.navigator.sendBeacon(t.reportBeacon.endpoint,r)\|\|fetch(t.reportBeacon.endpoint,{body:r,keepalive:!0,method:"POST"}).catch(e=>{d()?.beaconSendFailed(e)})},A=!1,D=e=>{if(A)return void d()?.reloadAlreadyScheduled(e);let t,r=p(),a=r.reloadDelays??[1e3,2e3,5e3],o=r.useRetryId??!0,i=r.enableRetryReset??!0,y=r.minTimeBetweenResets??5e3;if(o)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:R()}}let u=t?t.retryAttempt:0,m=t?.retryId??R();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 o=(()=>{if(b())try{let e=sessionStorage.getItem(h);if(e)return JSON.parse(e)}catch{return w}return w})();return!(o&&Date.now()-o.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 o=e+"";c({name:"retry-reset",previousAttempt:t.retryAttempt,previousRetryId:t.retryId,timeSinceReload:a},{silent:T([o])}),u=0,m=R()}if(-1===u)return T([e+""])\|\|d()?.fallbackAlreadyShown(e),void U();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})}),o\|\|$(),void U()}let N=u+1,D=a[u]??1e3;c({attempt:N,delay:D,name:"retry-attempt",retryId:m},{silent:T([e+""])}),A=!0,d()?.retrySchedulingReload(m,N,D),setTimeout(()=>{if(o&&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),o){let e=((e,t)=>{let r=new URL(globalThis.window.location.href);return r.searchParams.set(n,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)},D)},U=()=>{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 o=e.useRetryId??!0,n=k();if(n&&-1===n.retryAttempt?(d()?.clearingRetryState(),S()):!o&&!n&&$(),n){let e=document.getElementsByClassName("spa-guard-retry-id");for(let t of e)t.textContent=n.retryId}c({name:"fallback-ui-shown"})}catch(e){d()?.fallbackInjectFailed(e)}else d()?.noFallbackConfigured()},_="[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"},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",...P(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:C(t.target),timeStamp:t.timeStamp,type:"Event"}}return{type:"object",value:L(e)}},P=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,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[o]=e)})(t),s.initialized)return;s.initialized=!0,void 0!==globalThis.window&&(globalThis.window[a]=!0);let r=p().reloadDelays??[],i=k();i&&i.retryAttempt>=r.length&&(d()?.retryLimitExceeded(i.retryAttempt,r.length),(e=>{try{let t=new URL(globalThis.window.location.href);t.searchParams.set(n,e),t.searchParams.set(l,"-1"),globalThis.window.history.replaceState(null,"",t.toString())}catch{}})(i.retryId));let c=globalThis.window.addEventListener.bind(globalThis.window);c("error",t=>{if(T([t.message])\|\|d()?.capturedError("error",t),y(t))return t.preventDefault(),void D(t.error??t);if(N([t.message]))return t.preventDefault(),void D(t.error??t);let r=e(t);E({errorMessage:t.message,eventName:"error",serialized:r,...I()})},!0),c("unhandledrejection",t=>{let r=t.reason+"";if(T([r])\|\|d()?.capturedError("unhandledrejection",t),y(t.reason))return t.preventDefault(),void D(t.reason);if(N([r]))return t.preventDefault(),void D(t.reason);let a=e(t);E({errorMessage:r,eventName:"unhandledrejection",serialized:a,...I()})}),c("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()})}),c("vite:preloadError",e=>{T([e?.payload?.message\|\|e?.message])\|\|d()?.capturedError("vite:preloadError",e),e.preventDefault(),D(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(_+" Failed to send beacon:",e)},capturedError(e,...t){console.error(`${_} ${e}:capture:`,...t)},clearingRetryState(){console.log(_+" Clearing retry state from URL to allow clean reload attempt")},error(e,...t){console.error(`${_} ${e}`,...t)},fallbackAlreadyShown(e){console.error(_+" Fallback UI was already shown. Not retrying to prevent infinite loop.",e)},fallbackInjectFailed(e){console.error(_+" Failed to inject fallback UI",e)},fallbackTargetNotFound(e){console.error(`${_} Target element not found for selector: ${e}`)},log(e,...t){console.log(`${_} ${e}`,...t)},logEvent(e){let t=z[e.name],r=(e=>{switch(e.name){case"chunk-error":return`${_} chunk-error: isRetrying=${e.isRetrying}`;case"fallback-ui-shown":return _+" fallback-ui-shown";case"lazy-retry-attempt":return`${_} lazy-retry-attempt: attempt ${e.attempt}/${e.totalAttempts}, delay ${e.delay}ms`;case"lazy-retry-exhausted":return`${_} lazy-retry-exhausted: ${e.totalAttempts} attempts, willReload=${e.willReload}`;case"lazy-retry-success":return`${_} lazy-retry-success: succeeded on attempt ${e.attempt}`;case"retry-attempt":return`${_} retry-attempt: attempt ${e.attempt} in ${e.delay}ms (retryId: ${e.retryId})`;case"retry-exhausted":return`${_} retry-exhausted: finalAttempt=${e.finalAttempt} (retryId: ${e.retryId})`;case"retry-reset":return`${_} 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(_+" Report endpoint is not configured")},noFallbackConfigured(){console.error(_+" No fallback UI configured")},reloadAlreadyScheduled(e){console.log(_+" Reload already scheduled, ignoring duplicate chunk error:",e)},retryCycleStarting(e,t){console.log(`${_} Retry cycle starting: retryId=${e}, fromAttempt=${t}`)},retryLimitExceeded(e,t){console.log(`${_} Retry limit exceeded (${e}/${t}), marking as fallback shown`)},retrySchedulingReload(e,t,r){console.log(`${_} Scheduling reload: retryId=${e}, attempt=${t}, delay=${r}ms`)},updatedRetryAttempt(e){console.log(`${_} Updated retry attempt to ${e} in URL for fallback UI`)},versionChangeDetected(e,t){console.warn(`${_} New version available (${e??"unknown"} → ${t}). Please refresh to get the latest version.`)},versionCheckAlreadyRunning(){console.warn(_+" Version check already running")},versionCheckDisabled(){console.warn(_+" Version checking disabled: no version configured")},versionCheckFailed(e){console.error(_+" Version check failed",e)},versionCheckHttpError(e){console.warn(`${_} Version check HTTP error: ${e}`)},versionCheckParseError(){console.warn(_+" Failed to parse version from HTML")},versionCheckPaused(){console.log(_+" Version check paused (tab hidden)")},versionCheckRequiresEndpoint(){console.warn(_+" JSON version check mode requires endpoint")},versionCheckResumed(){console.log(_+" Version check resumed (tab visible)")},versionCheckResumedImmediate(){console.log(_+" Version check resumed with immediate check (tab visible, interval elapsed)")},versionCheckStarted(e,t,r){console.log(`${_} Starting version check (mode: ${e}, interval: ${t}ms, current: ${r})`)},versionCheckStopped(){console.log(_+" Version check stopped")},warn(e,...t){console.warn(`${_} ${e}`,...t)}});
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)}});

package/package.json CHANGED Viewed

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