@ovineko/spa-guard 0.0.2-alpha-1 → 0.0.4

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

@@ -1,63 +0,0 @@
-/**
- * Error dispatchers for the debug panel.
- *
- * Unlike the old errorSimulators (which returned promises that callers could catch),
- * these functions return void. Errors are "fire and forget" — they escape to
- * window event listeners (window.error, window.unhandledrejection) where
- * spa-guard's listenInternal() picks them up.
- */
-/**
- * Dispatches an async runtime error via setTimeout.
- * Triggers the window "error" event because the throw happens outside
- * any call stack that could catch it.
- */
-export declare function dispatchAsyncRuntimeError(): void;
-/**
- * Dispatches an unhandled chunk load error via void Promise.reject().
- * Triggers window "unhandledrejection" with an error matching spa-guard's
- * chunk error detection patterns.
- */
-export declare function dispatchChunkLoadError(): void;
-/**
- * Dispatches an unhandled chunk error via Promise.finally().
- * The throw inside .finally() with no surrounding catch produces
- * 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".
- */
-export declare function dispatchNetworkTimeout(delayMs?: number): void;
-/**
- * Simulates the retry-exhausted state by emitting the "retry-exhausted" event
- * with finalAttempt equal to the configured reloadDelays length, then renders
- * the fallback UI into the DOM.
- */
-export declare function dispatchRetryExhausted(): void;
-/**
- * Simulates a static asset 404 by appending a <script> element with a
- * nonexistent hashed URL to document.head. The browser fires an "error"
- * event on the element, which spa-guard's listenInternal() detects via
- * the Resource Timing API-based isLikely404 check.
- */
-export declare function dispatchStaticAsset404(): void;
-/**
- * Dispatches a sync runtime error via CustomEvent.
- * DebugSyncErrorTrigger (a React component) listens for this event,
- * stores the error in state, and throws it during render so that
- * 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/recommendedSetup.d.ts

@@ -1,36 +0,0 @@
-export interface RecommendedSetupOptions {
-    /**
-     * Healthy boot handling strategy.
-     *
-     * - `"auto"` (default): if retry URL params are present, mark healthy boot
-     *   after a grace period and only when orchestrator is still idle.
-     * - `"manual"`: never auto-mark; call `markRetryHealthyBoot()` yourself.
-     * - `"off"` / `false`: disable healthy boot handling.
-     */
-    healthyBoot?: RecommendedSetupHealthyBoot;
-    /**
-     * Whether to start version checking.
-     * @default true
-     */
-    versionCheck?: boolean;
-}
-interface HealthyBootAutoConfig {
-    /**
-     * Delay before auto-marking healthy boot when retry params are present in URL.
-     * @default dynamic:
-     * max(5000, max(reloadDelays)+1000, sum(lazyRetry.retryDelays)+1000)
-     */
-    graceMs?: number;
-    /**
-     * Explicit mode for object config.
-     * @default "auto"
-     */
-    mode?: "auto";
-}
-type RecommendedSetupHealthyBoot = "auto" | "manual" | "off" | false | HealthyBootAutoConfig;
-/**
- * Enable recommended runtime features with sensible defaults.
- * Returns a cleanup function that tears down all started features.
- */
-export declare const recommendedSetup: (overrides?: RecommendedSetupOptions) => (() => void);
-export {};

package/dist/runtime/state.d.ts

@@ -1,20 +0,0 @@
-import type { UnsubscribeFn } from "../common/events/types";
-export interface SpaGuardState {
-    currentAttempt: number;
-    isFallbackShown: boolean;
-    isWaiting: boolean;
-    /**
-     * ID of the previous retry cycle before reset.
-     * Undefined if no reset has occurred yet.
-     */
-    lastResetRetryId?: string;
-    /**
-     * Timestamp of the last retry cycle reset.
-     * Undefined if no reset has occurred yet.
-     */
-    lastRetryResetTime?: number;
-}
-type StateSubscriber = (state: SpaGuardState) => void;
-export declare const getState: () => SpaGuardState;
-export declare const subscribeToState: (cb: StateSubscriber) => UnsubscribeFn;
-export {};