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

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

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

package/dist/common/events/index.d.ts

@@ -1,2 +0,0 @@
-export { emitEvent, subscribe } from "./internal";
-export * from "./types";

package/dist/common/events/internal.d.ts

@@ -1,13 +0,0 @@
-import type { Logger } from "../logger";
-import type { EmitOptions, InternalConfig, SPAGuardEvent, SubscribeFn, UnsubscribeFn } from "./types";
-export declare const subscribers: Set<SubscribeFn>;
-export declare const internalConfig: InternalConfig;
-export declare const setLogger: (logger?: Logger) => void;
-export declare const getLogger: () => Logger | undefined;
-export declare const emitEvent: (event: SPAGuardEvent, options?: EmitOptions) => void;
-export declare const subscribe: (cb: SubscribeFn) => UnsubscribeFn;
-export declare const isInitialized: () => boolean;
-export declare const markInitialized: () => void;
-export declare const disableDefaultRetry: () => void;
-export declare const enableDefaultRetry: () => void;
-export declare const isDefaultRetryEnabled: () => boolean;

package/dist/common/events/types.d.ts

@@ -1,104 +0,0 @@
-export interface EmitOptions {
-    silent?: boolean;
-}
-export interface InternalConfig {
-    defaultRetryEnabled: boolean;
-    initialized: boolean;
-}
-export type SPAGuardEvent = (SPAGuardEventChunkError & {
-    name: "chunk-error";
-}) | (SPAGuardEventFallbackUINotRendered & {
-    name: "fallback-ui-not-rendered";
-}) | (SPAGuardEventFallbackUIShown & {
-    name: "fallback-ui-shown";
-}) | (SPAGuardEventLazyRetryAttempt & {
-    name: "lazy-retry-attempt";
-}) | (SPAGuardEventLazyRetryExhausted & {
-    name: "lazy-retry-exhausted";
-}) | (SPAGuardEventLazyRetryStart & {
-    name: "lazy-retry-start";
-}) | (SPAGuardEventLazyRetrySuccess & {
-    name: "lazy-retry-success";
-}) | (SPAGuardEventRetryAttempt & {
-    name: "retry-attempt";
-}) | (SPAGuardEventRetryExhausted & {
-    name: "retry-exhausted";
-}) | (SPAGuardEventRetryReset & {
-    name: "retry-reset";
-}) | (SPAGuardEventStaticAssetLoadFailed & {
-    name: "static-asset-load-failed";
-});
-export interface SPAGuardEventChunkError {
-    error: unknown;
-    isRetrying: boolean;
-    name: "chunk-error";
-}
-export interface SPAGuardEventFallbackUINotRendered {
-    name: "fallback-ui-not-rendered";
-    reason: "no-html-configured" | "target-not-found";
-    selector?: string;
-}
-export interface SPAGuardEventFallbackUIShown {
-    name: "fallback-ui-shown";
-}
-/** Emitted before each module-level retry attempt initiated by retryImport. */
-export interface SPAGuardEventLazyRetryAttempt {
-    /** 1-based index of the current retry attempt. */
-    attempt: number;
-    /** Delay in milliseconds before this retry attempt. */
-    delay: number;
-    /** The error that caused the previous attempt to fail. */
-    error?: unknown;
-    name: "lazy-retry-attempt";
-    /** Total number of attempts including the initial try (delays.length + 1). */
-    totalAttempts: number;
-}
-/** Emitted when all module-level retry attempts are exhausted. */
-export interface SPAGuardEventLazyRetryExhausted {
-    /** The final error after all attempts failed. */
-    error: unknown;
-    name: "lazy-retry-exhausted";
-    /** Total number of attempts that were made (delays.length + 1). */
-    totalAttempts: number;
-    /** Whether triggerRetry() will be called after this event. */
-    willReload: boolean;
-}
-/** Emitted once before the first import attempt, when retries are configured. */
-export interface SPAGuardEventLazyRetryStart {
-    name: "lazy-retry-start";
-    /** Total number of attempts that will be made (delays.length + 1). */
-    totalAttempts: number;
-}
-/** Emitted when a module loads successfully after one or more retry attempts. */
-export interface SPAGuardEventLazyRetrySuccess {
-    /** 1-based retry number on which the import succeeded (1 = first retry). */
-    attempt: number;
-    name: "lazy-retry-success";
-    /** Total time in milliseconds from first attempt to success. */
-    totalTime?: number;
-}
-export interface SPAGuardEventRetryAttempt {
-    attempt: number;
-    delay: number;
-    name: "retry-attempt";
-    retryId: string;
-}
-export interface SPAGuardEventRetryExhausted {
-    finalAttempt: number;
-    name: "retry-exhausted";
-    retryId: string;
-}
-export interface SPAGuardEventRetryReset {
-    name: "retry-reset";
-    previousAttempt: number;
-    previousRetryId: string;
-    timeSinceReload: number;
-}
-/** Emitted when a hashed static asset (script/link) fails to load, likely due to a stale deployment. */
-export interface SPAGuardEventStaticAssetLoadFailed {
-    name: "static-asset-load-failed";
-    /** The URL of the asset that failed to load. */
-    url: string;
-}
-export type SubscribeFn = (event: SPAGuardEvent) => void;
-export type UnsubscribeFn = () => void;

package/dist/common/fallbackRendering.d.ts

@@ -1,23 +0,0 @@
-/**
- * Renders the loading UI into the DOM during a retry delay before reload.
- *
- * Fail-safe: if loading content is not configured or the target element is not
- * found, returns silently with no log, no event, and no side effects.
- * All DOM access is wrapped in try/catch.
- */
-export declare const showLoadingUI: (attempt: number) => void;
-/**
- * Renders the fallback UI into the DOM.
- *
- * This is a pure rendering helper. It has no lifecycle side effects:
- * it does not set fallback mode, does not check whether fallback mode is
- * already active, and does not modify orchestrator state. The caller is
- * responsible for ensuring the lifecycle transition has already occurred
- * before invoking this function.
- *
- * Fails safely: if fallback HTML is not configured or the target element
- * is not found, logs a warning and returns without side effects or errors.
- */
-export declare const showFallbackUI: (override?: {
-    retryId?: string;
-}) => void;

package/dist/common/fallbackState.d.ts

@@ -1,3 +0,0 @@
-export declare const isInFallbackMode: () => boolean;
-export declare const setFallbackMode: () => void;
-export declare const resetFallbackMode: () => void;

package/dist/common/handleErrorWithSpaGuard.d.ts

@@ -1,18 +0,0 @@
-/** Minimal subset of React.ErrorInfo used for beacon serialization. */
-export interface ErrorInfoLike {
-    componentStack?: null | string;
-    digest?: string;
-}
-export interface HandleErrorOptions {
-    autoRetryChunkErrors?: boolean;
-    errorInfo?: ErrorInfoLike;
-    eventName: string;
-    onError?: (error: unknown) => void;
-    sendBeaconOnError?: boolean;
-}
-/**
- * Shared error handling logic with spa-guard integration.
- *
- * Detects chunk errors and automatically retries, or sends beacon for non-chunk errors.
- */
-export declare const handleErrorWithSpaGuard: (error: unknown, options: HandleErrorOptions) => void;

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

@@ -1,3 +0,0 @@
-export declare const defaultErrorFallbackHtml = "<style>.spa-guard-error-id:has(.spa-guard-retry-id:empty){display:none}.spa-guard-error-id{font-family:ui-monospace,SFMono-Regular,Consolas,\"Liberation Mono\",Menlo,monospace}.spa-guard-fallback-root{display:flex;align-items:center;justify-content:center;min-height:100vh;padding:2rem;font-family:system-ui,sans-serif;background:#fff;color:#1a1a1a;color-scheme:light dark}.spa-guard-fallback-icon{stroke:#b0b0b0}.spa-guard-fallback-message{color:#666}.spa-guard-fallback-muted{color:#999}.spa-guard-btn-secondary{border:1px solid #d0d0d0;background:#fff;color:#333}.spa-guard-btn-primary{border:1px solid transparent;background:#111;color:#fff}@media (prefers-color-scheme:dark){.spa-guard-fallback-root{background:#111318;color:#e7eaf0}.spa-guard-fallback-icon{stroke:#8b95a7}.spa-guard-fallback-message{color:#b8bfca}.spa-guard-fallback-muted{color:#8b95a7}.spa-guard-btn-secondary{border-color:#3b4351;background:#1a1f28;color:#d8deea}.spa-guard-btn-primary{background:#e7eaf0;color:#151922}}</style><div class=\"spa-guard-fallback-root\"><div style=\"text-align:center;max-width:480px\"><div style=\"margin-bottom:1.5rem\"><svg class=\"spa-guard-fallback-icon\" xmlns=\"http://www.w3.org/2000/svg\" width=\"48\" height=\"48\" fill=\"none\" viewBox=\"0 0 24 24\" stroke-width=\"1.5\" stroke-linecap=\"round\" stroke-linejoin=\"round\"><circle cx=\"12\" cy=\"12\" r=\"10\"/><line x1=\"12\" y1=\"8\" x2=\"12\" y2=\"12\"/><line x1=\"12\" y1=\"16\" x2=\"12.01\" y2=\"16\"/></svg></div><h1 data-spa-guard-content=\"heading\" style=\"font-size:1.375rem;font-weight:600;margin:0 0 .5rem;line-height:1.3\">Something went wrong</h1><p data-spa-guard-content=\"message\" class=\"spa-guard-fallback-message\" style=\"max-width:600px;margin:0 auto 1.5rem;font-size:.9375rem;line-height:1.5\">Please refresh the page to continue.</p><div style=\"display:flex;gap:.5rem;justify-content:center;flex-wrap:wrap\"><button data-spa-guard-action=\"try-again\" type=\"button\" class=\"spa-guard-btn-secondary\" style=\"display:none;padding:.5rem 1.25rem;font-size:.875rem;font-family:inherit;border-radius:6px;cursor:pointer;line-height:1.5\">Try again</button> <button data-spa-guard-action=\"reload\" type=\"button\" class=\"spa-guard-btn-primary\" style=\"padding:.5rem 1.25rem;font-size:.875rem;font-family:inherit;border-radius:6px;cursor:pointer;line-height:1.5\">Reload page</button></div><p class=\"spa-guard-error-id spa-guard-fallback-muted\" style=\"margin-top:1.5rem;font-size:.6875rem\">Error ID: <span class=\"spa-guard-retry-id\"></span></p></div></div>";
-export declare const defaultLoadingFallbackHtml = "<style>.spa-guard-loading-root{display:flex;align-items:center;justify-content:center;min-height:100vh;padding:2rem;font-family:system-ui,sans-serif;background:#fff;color:#1a1a1a;color-scheme:light dark}.spa-guard-loading-muted{color:#999}@media (prefers-color-scheme:dark){.spa-guard-loading-root{background:#111318;color:#e7eaf0}.spa-guard-loading-muted{color:#8b95a7}}</style><div class=\"spa-guard-loading-root\"><div style=\"text-align:center\"><div data-spa-guard-spinner style=\"margin-bottom:1.25rem\"></div><h2 data-spa-guard-content=\"loading\" style=\"font-size:1.125rem;font-weight:600;margin:0 0 .25rem\">Loading...</h2><p data-spa-guard-section=\"retrying\" class=\"spa-guard-loading-muted\" style=\"display:none;font-size:.8125rem;margin:.5rem 0 0\"><span data-spa-guard-content=\"retrying\">Retry attempt</span> <span data-spa-guard-content=\"attempt\"></span></p></div></div>";
-export declare const defaultSpinnerHtml = "<svg width=\"40\" height=\"40\" viewBox=\"0 0 40 40\" style=\"animation:spa-guard-spin .8s linear infinite\"><circle cx=\"20\" cy=\"20\" r=\"16\" fill=\"none\" stroke=\"#e8e8e8\" stroke-width=\"3\"/><circle cx=\"20\" cy=\"20\" r=\"16\" fill=\"none\" stroke=\"#666\" stroke-width=\"3\" stroke-dasharray=\"80\" stroke-dashoffset=\"60\" stroke-linecap=\"round\"/></svg><style>@keyframes spa-guard-spin{to{transform:rotate(360deg)}}</style>";

package/dist/common/i18n.d.ts

@@ -1,23 +0,0 @@
-import type { SpaGuardTranslations } from "../i18n";
-/**
- * Apply i18n translations to a virtual container's data-attributed elements.
- * Patches `[data-spa-guard-content]` and `[data-spa-guard-action]` elements,
- * and applies RTL direction if needed.
- *
- * Must be called on a virtual (detached) container BEFORE inserting into DOM
- * to avoid flash of untranslated content.
- */
-export declare function applyI18n(container: HTMLElement, t: SpaGuardTranslations): void;
-/**
- * Read i18n translations from the `<meta name="spa-guard-i18n">` tag.
- * Returns parsed translations or null if the tag is absent or malformed.
- */
-export declare function getI18n(): null | SpaGuardTranslations;
-/**
- * Write i18n translations to the `<meta name="spa-guard-i18n">` tag.
- * Creates the tag if it doesn't exist, or updates it if it does.
- *
- * Use this at runtime to dynamically patch the inline fallback/loading UI
- * translations without server-side rendering.
- */
-export declare function setTranslations(translations: SpaGuardTranslations): void;

package/dist/common/isChunkError.d.ts

@@ -1 +0,0 @@
-export declare const isChunkError: (error: unknown) => boolean;

package/dist/common/isStaticAssetError.d.ts

@@ -1,3 +0,0 @@
-export declare const isStaticAssetError: (event: Event) => boolean;
-export declare const isLikely404: (url?: string, timeSinceNavMs?: number) => boolean;
-export declare const getAssetUrl: (event: Event) => string;

package/dist/common/lastReloadTime.d.ts

@@ -1,17 +0,0 @@
-import type { RetryState } from "./retryState";
-export interface LastReloadData {
-    attemptNumber: number;
-    retryId: string;
-    timestamp: number;
-}
-export interface LastRetryResetInfo {
-    previousRetryId: string;
-    timestamp: number;
-}
-export declare const setLastReloadTime: (retryId: string, attemptNumber: number) => void;
-export declare const getLastReloadTime: () => LastReloadData | null;
-export declare const clearLastReloadTime: () => void;
-export declare const shouldResetRetryCycle: (retryState: RetryState, reloadDelays: number[], minTimeBetweenResets?: number) => boolean;
-export declare const setLastRetryResetInfo: (previousRetryId: string) => void;
-export declare const getLastRetryResetInfo: () => LastRetryResetInfo | null;
-export declare const clearLastRetryResetInfo: () => void;

package/dist/common/listen/index.d.ts

@@ -1 +0,0 @@
-export declare const listen: () => void;

package/dist/common/listen/internal.d.ts

@@ -1,2 +0,0 @@
-import type { Logger } from "../logger";
-export declare const listenInternal: (serializeError: (error: unknown) => string, logger?: Logger) => void;

package/dist/common/log.d.ts

@@ -1 +0,0 @@
-export declare const logMessage: (msg: string) => string;

package/dist/common/logger.d.ts

@@ -1,30 +0,0 @@
-import type { SPAGuardEvent } from "./events/types";
-export interface Logger {
-    beaconSendFailed(error: unknown): void;
-    capturedError(type: string, ...args: unknown[]): void;
-    error(msg: string, ...args: unknown[]): void;
-    fallbackAlreadyShown(error: unknown): void;
-    fallbackInjectFailed(error: unknown): void;
-    fallbackTargetNotFound(selector: string): void;
-    log(msg: string, ...args: unknown[]): void;
-    logEvent(event: SPAGuardEvent): void;
-    noBeaconEndpoint(): void;
-    noFallbackConfigured(): void;
-    reloadAlreadyScheduled(error: unknown): void;
-    retryCycleStarting(retryId: string, fromAttempt: number): void;
-    retrySchedulingReload(retryId: string, attempt: number, delay: number): void;
-    versionChangeDetected(oldVersion: null | string, latestVersion: string): void;
-    versionCheckAlreadyRunning(): void;
-    versionCheckDisabled(): void;
-    versionCheckFailed(error: unknown): void;
-    versionCheckHttpError(status: number): void;
-    versionCheckParseError(): void;
-    versionCheckPaused(): void;
-    versionCheckRequiresEndpoint(): void;
-    versionCheckResumed(): void;
-    versionCheckResumedImmediate(): void;
-    versionCheckStarted(mode: string, interval: number, version: string): void;
-    versionCheckStopped(): void;
-    warn(msg: string, ...args: unknown[]): void;
-}
-export declare const createLogger: () => Logger;

package/dist/common/options.d.ts

@@ -1,182 +0,0 @@
-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
-     * and dispatches a `spa-guard:version-change` CustomEvent on the window.
-     */
-    checkVersion?: {
-        /**
-         * Cache mode for the fetch request used to check the version.
-         * - "no-store": Bypass the HTTP cache entirely (default).
-         * - "no-cache": Revalidate with the server before using cached response.
-         * @default "no-store"
-         */
-        cache?: "no-cache" | "no-store";
-        /**
-         * Endpoint URL for JSON mode version checking.
-         * Required when mode is "json".
-         */
-        endpoint?: string;
-        /**
-         * Polling interval in milliseconds.
-         * @default 300000
-         */
-        interval?: number;
-        /**
-         * Detection mode.
-         * - "html": Re-fetches the current page and parses the injected version from the HTML.
-         * - "json": Fetches a dedicated JSON endpoint.
-         * @default "html"
-         */
-        mode?: "html" | "json";
-        /**
-         * Behavior when a version change is detected.
-         * - "reload": Automatically calls location.reload() after dispatching the event.
-         * - "event": Only dispatches the spa-guard:version-change CustomEvent (no reload).
-         * @default "reload"
-         */
-        onUpdate?: "event" | "reload";
-    };
-    /**
-     * Enable automatic retry cycle reset when enough time has passed
-     * since the last reload. When true, if the user stays on a page longer
-     * than the retry delay, the next error will start a fresh retry cycle.
-     * @default true
-     */
-    enableRetryReset?: boolean;
-    /**
-     * Error filtering and retry configuration.
-     */
-    errors?: {
-        /**
-         * List of error message substrings that should trigger the retry/reload process,
-         * same as chunk load errors. Useful for custom errors that indicate a stale deployment.
-         * @default []
-         */
-        forceRetry?: string[];
-        /**
-         * List of error message substrings to ignore and not report.
-         * If error message contains any of these strings, it will be filtered out.
-         * @default []
-         */
-        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 */
-            content?: string;
-            /** CSS selector where the fallback HTML should be injected @default "body" */
-            selector?: string;
-        };
-        loading?: {
-            /** Custom HTML to display during the loading/retrying state */
-            content?: string;
-        };
-        /**
-         * Spinner overlay configuration.
-         * Controls the full-page loading spinner injected by the Vite plugin
-         * and available via `showSpinner()`/`dismissSpinner()` at runtime.
-         */
-        spinner?: {
-            /**
-             * Overlay background color.
-             * Used as CSS variable fallback: var(--spa-guard-spinner-bg, <this value>).
-             * @default '#fff'
-             */
-            background?: string;
-            /**
-             * Custom spinner HTML (the spinner element only, no container/overlay).
-             * If not provided, uses the default SVG spinner.
-             */
-            content?: string;
-            /**
-             * Disable spinner entirely.
-             * No injection into body, showSpinner() is a no-op, Spinner returns null.
-             * @default false
-             */
-            disabled?: boolean;
-        };
-    };
-    /**
-     * Options for the lazyWithRetry module-level retry logic.
-     * Controls retry behaviour for dynamic imports before falling back to a full page reload.
-     */
-    lazyRetry?: {
-        /**
-         * Call triggerRetry() after all retry attempts for dynamic imports are exhausted.
-         * If true, triggers page reload logic after all retryDelays fail.
-         * If false, only throws the error to the error boundary without a reload.
-         * @default true
-         */
-        callReloadOnFailure?: boolean;
-        /**
-         * Array of delays in milliseconds for dynamic import retry attempts.
-         * Each element represents one retry attempt with the given delay.
-         * The number of elements determines the total number of retry attempts.
-         * @default [1000, 2000]
-         * @example [500, 1500, 3000] // 3 attempts: 500ms, 1.5s, 3s
-         */
-        retryDelays?: number[];
-    };
-    /**
-     * Minimum time in milliseconds between retry cycle resets.
-     * Prevents infinite reset loops by ensuring a reset can only happen
-     * if the previous reset was at least this many milliseconds ago.
-     * @default 5000 (5 seconds)
-     */
-    minTimeBetweenResets?: number;
-    /** @default [1000, 2000, 5000] */
-    reloadDelays?: number[];
-    reportBeacon?: {
-        endpoint?: string;
-    };
-    /**
-     * Configuration for automatic recovery from static asset 404 errors
-     * caused by deployment version mismatches.
-     */
-    staticAssets?: {
-        /**
-         * Automatically trigger a cache-busting reload when a hashed static asset
-         * fails to load and the page has been open long enough to suggest a stale deployment.
-         * @default true
-         */
-        autoRecover?: boolean;
-        /**
-         * Milliseconds to wait after the first failed asset before triggering the reload.
-         * Allows collecting multiple concurrent failures into a single reload.
-         * @default 500
-         */
-        recoveryDelay?: number;
-    };
-    /** @default true */
-    useRetryId?: boolean;
-    /**
-     * Current application version. Used by the version checker to detect new deployments.
-     * Automatically generated by the Vite plugin using `crypto.randomUUID()` if not explicitly provided.
-     */
-    version?: string;
-}
-export declare const getOptions: () => Options;

package/dist/common/parseVersion.d.ts

@@ -1,9 +0,0 @@
-/**
- * Extract the SPA Guard version string from an HTML document.
- *
- * Tries the new `__SPA_GUARD_VERSION__` format first, then falls back
- * to the legacy `__SPA_GUARD_OPTIONS__` object with a `version` key.
- *
- * Returns `null` when neither marker is found.
- */
-export declare function extractVersionFromHtml(html: string): null | string;

package/dist/common/retryImport.d.ts

@@ -1,43 +0,0 @@
-/**
- * Options for configuring the retry behaviour of {@link retryImport}.
- */
-export interface RetryImportOptions {
-    /**
-     * If true and all retries fail with a chunk error, triggers a page reload via the orchestrator before rethrowing.
-     * @default true (when used via lazyWithRetry)
-     */
-    callReloadOnFailure?: boolean;
-    /**
-     * Optional callback invoked before each retry attempt.
-     * Useful for logging or analytics.
-     *
-     * @param attempt - The 1-based attempt number (1 = first retry)
-     * @param delay - The delay in milliseconds before this retry attempt
-     *
-     * @example
-     * onRetry: (attempt, delay) => console.log(`Retry ${attempt} after ${delay}ms`)
-     */
-    onRetry?: (attempt: number, delay: number) => void;
-    /**
-     * AbortSignal to cancel pending retries and clear timers.
-     * When aborted, any in-progress wait is cancelled immediately (preventing memory leaks),
-     * and the retryImport promise rejects with an AbortError.
-     * Useful when the caller no longer needs the import result (e.g. component unmounted).
-     */
-    signal?: AbortSignal;
-}
-/**
- * Retries an import function with configurable delays between attempts.
- *
- * @param importFn - The function that performs the dynamic import
- * @param delays - Array of delays in milliseconds. Each entry represents one retry attempt.
- * @param options - Optional configuration for retry behaviour
- * @returns Promise that resolves with the import result or rejects after all attempts are exhausted
- *
- * @example
- * retryImport(() => import('./MyModule'), [1000, 2000])
- * retryImport(() => import('./MyModule'), [500, 1500], {
- *   onRetry: (attempt, delayMs) => console.log(`Retry ${attempt} after ${delayMs}ms`),
- * })
- */
-export declare const retryImport: <T>(importFn: () => Promise<T>, delays: number[], options?: RetryImportOptions) => Promise<T>;

package/dist/common/retryOrchestrator.d.ts

@@ -1,35 +0,0 @@
-export type RetryPhase = "fallback" | "idle" | "scheduled";
-export interface RetrySnapshot {
-    attempt: number;
-    lastSource?: string;
-    lastTriggerTime?: number;
-    phase: RetryPhase;
-    retryId: null | string;
-}
-export interface TriggerInput {
-    cacheBust?: boolean;
-    error?: unknown;
-    source?: string;
-}
-export type TriggerResult = {
-    reason: string;
-    status: "deduped";
-} | {
-    status: "accepted";
-} | {
-    status: "fallback";
-} | {
-    status: "internal-error";
-} | {
-    status: "retry-disabled";
-};
-export declare const triggerRetry: (input?: TriggerInput) => TriggerResult;
-export declare const markRetryHealthyBoot: () => void;
-export declare const getRetrySnapshot: () => RetrySnapshot;
-/**
- * Sets orchestrator state to fallback and renders the fallback UI.
- * For use in debug/simulation contexts only — bypasses retry scheduling
- * while keeping the orchestrator snapshot consistent with fallback mode.
- */
-export declare const setFallbackStateForDebug: () => void;
-export declare const resetRetryOrchestratorForTests: () => void;

package/dist/common/retryState.d.ts

@@ -1,11 +0,0 @@
-export interface RetryState {
-    retryAttempt: number;
-    retryId: string;
-}
-export declare const getRetryStateFromUrl: () => null | RetryState;
-export declare const generateRetryId: () => string;
-export declare const getRetryAttemptFromUrl: () => null | number;
-export declare const getRetryInfoForBeacon: () => {
-    retryAttempt?: number;
-    retryId?: string;
-};

package/dist/common/sendBeacon.d.ts

@@ -1,2 +0,0 @@
-import type { BeaconSchema } from "../schema";
-export declare const sendBeacon: (beacon: BeaconSchema) => void;

package/dist/common/serializeError.d.ts

@@ -1 +0,0 @@
-export declare const serializeError: (error: unknown) => string;

package/dist/common/shouldIgnore.d.ts

@@ -1,13 +0,0 @@
-import type { BeaconSchema } from "../schema";
-/**
- * Checks if any of the provided messages should be ignored based on errors.ignore option.
- */
-export declare const shouldIgnoreMessages: (messages: (string | undefined)[]) => boolean;
-/**
- * Checks if any of the provided messages match a forceRetry pattern.
- */
-export declare const shouldForceRetry: (messages: (string | undefined)[]) => boolean;
-/**
- * Checks if a beacon should be ignored based on errors.ignore option.
- */
-export declare const shouldIgnoreBeacon: (beacon: BeaconSchema) => boolean;

package/dist/common/spinner.d.ts

@@ -1,8 +0,0 @@
-export declare const SPINNER_ID = "__spa-guard-spinner";
-export declare const defaultSpinnerSvg = "<svg width=\"40\" height=\"40\" viewBox=\"0 0 40 40\" style=\"animation:spa-guard-spin .8s linear infinite\"><circle cx=\"20\" cy=\"20\" r=\"16\" fill=\"none\" stroke=\"#e8e8e8\" stroke-width=\"3\"/><circle cx=\"20\" cy=\"20\" r=\"16\" fill=\"none\" stroke=\"#666\" stroke-width=\"3\" stroke-dasharray=\"80\" stroke-dashoffset=\"60\" stroke-linecap=\"round\"/></svg><style>@keyframes spa-guard-spin{to{transform:rotate(360deg)}}</style>";
-export declare function dismissSpinner(): void;
-export declare const sanitizeCssValue: (value: string) => string;
-export declare function getSpinnerHtml(backgroundOverride?: string): string;
-export declare function showSpinner(options?: {
-    background?: string;
-}): () => void;

package/dist/common/staticAssetRecovery.d.ts

@@ -1,2 +0,0 @@
-export declare const handleStaticAssetFailure: (url: string) => void;
-export declare const resetStaticAssetRecovery: () => void;

package/dist/i18n/translations.d.ts

@@ -1,2 +0,0 @@
-import type { SpaGuardTranslations } from "./index";
-export declare const translations: Record<string, SpaGuardTranslations>;