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

package/dist/runtime/debug/index.js

@@ -1,266 +1,246 @@
-import {
-  dispatchAsyncRuntimeError,
-  dispatchChunkLoadError,
-  dispatchFinallyError,
-  dispatchForceRetryError,
-  dispatchNetworkTimeout,
-  dispatchRetryExhausted,
-  dispatchStaticAsset404,
-  dispatchSyncRuntimeError,
-  dispatchUnhandledRejection
-} from "../../chunk-PERG4557.js";
-import {
-  subscribeToState
-} from "../../chunk-VZ2DLGXX.js";
-import {
-  subscribe
-} from "../../chunk-GE63YJOT.js";
-import "../../chunk-MLKGABMK.js";
-
-// src/runtime/debug/index.ts
-var SCENARIOS = [
-  { dispatch: dispatchChunkLoadError, key: "chunk-load-error", label: "ChunkLoadError" },
-  { dispatch: () => dispatchNetworkTimeout(100), key: "network-timeout", label: "Network Timeout" },
-  { dispatch: dispatchSyncRuntimeError, key: "sync-runtime-error", label: "Sync Runtime Error" },
-  { dispatch: dispatchAsyncRuntimeError, key: "async-runtime-error", label: "Async Runtime Error" },
-  { dispatch: dispatchFinallyError, key: "finally-error", label: "Finally Error" },
-  { dispatch: dispatchForceRetryError, key: "force-retry-error", label: "ForceRetry Error" },
-  {
-    dispatch: dispatchUnhandledRejection,
-    key: "unhandled-rejection",
-    label: "Unhandled Rejection"
-  },
-  { dispatch: dispatchRetryExhausted, key: "exhaust-retries", label: "Exhaust Retries" },
-  { dispatch: dispatchStaticAsset404, key: "static-asset-404", label: "Static Asset 404" }
+import { M as subscribe } from "../../retryOrchestrator-DNGIHV2M.mjs";
+import { a as dispatchNetworkTimeout, c as dispatchSyncRuntimeError, i as dispatchForceRetryError, l as dispatchUnhandledRejection, n as dispatchChunkLoadError, o as dispatchRetryExhausted, r as dispatchFinallyError, s as dispatchStaticAsset404, t as dispatchAsyncRuntimeError } from "../../errorDispatchers-Cl_pa0DT.mjs";
+import { n as subscribeToState } from "../../state-I20jENMD.mjs";
+//#region src/runtime/debug/index.ts
+const SCENARIOS = [
+	{
+		dispatch: dispatchChunkLoadError,
+		key: "chunk-load-error",
+		label: "ChunkLoadError"
+	},
+	{
+		dispatch: () => dispatchNetworkTimeout(100),
+		key: "network-timeout",
+		label: "Network Timeout"
+	},
+	{
+		dispatch: dispatchSyncRuntimeError,
+		key: "sync-runtime-error",
+		label: "Sync Runtime Error"
+	},
+	{
+		dispatch: dispatchAsyncRuntimeError,
+		key: "async-runtime-error",
+		label: "Async Runtime Error"
+	},
+	{
+		dispatch: dispatchFinallyError,
+		key: "finally-error",
+		label: "Finally Error"
+	},
+	{
+		dispatch: dispatchForceRetryError,
+		key: "force-retry-error",
+		label: "ForceRetry Error"
+	},
+	{
+		dispatch: dispatchUnhandledRejection,
+		key: "unhandled-rejection",
+		label: "Unhandled Rejection"
+	},
+	{
+		dispatch: dispatchRetryExhausted,
+		key: "exhaust-retries",
+		label: "Exhaust Retries"
+	},
+	{
+		dispatch: dispatchStaticAsset404,
+		key: "static-asset-404",
+		label: "Static Asset 404"
+	}
 ];
-var POSITION_MAP = {
-  "bottom-left": "bottom:16px;left:16px;",
-  "bottom-right": "bottom:16px;right:16px;",
-  "top-left": "top:16px;left:16px;",
-  "top-right": "top:16px;right:16px;"
+const POSITION_MAP = {
+	"bottom-left": "bottom:16px;left:16px;",
+	"bottom-right": "bottom:16px;right:16px;",
+	"top-left": "top:16px;left:16px;",
+	"top-right": "top:16px;right:16px;"
 };
-var MAX_EVENT_HISTORY = 100;
-var activeInstance = null;
+const MAX_EVENT_HISTORY = 100;
+let activeInstance = null;
+/**
+* Creates a debug panel for spa-guard that displays state, events,
+* and provides error simulation buttons.
+*
+* Returns a cleanup function that removes the panel and unsubscribes all listeners.
+*/
 function createDebugger(options) {
-  if (activeInstance) {
-    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(
-    "div",
-    `background:#1e1e2e;border-radius:8px;box-shadow:0 4px 12px rgba(0,0,0,0.3);color:#cdd6f4;font-family:monospace;font-size:13px;max-width:320px;min-width:260px;padding:12px;position:fixed;z-index:99999;${POSITION_MAP[options?.position ?? "bottom-right"]}`,
-    "spa-guard-debug-panel"
-  );
-  const { arrow, header } = createHeader(isOpen);
-  const content = buildContent(unsubscribers);
-  panel.append(header);
-  header.addEventListener("click", () => {
-    isOpen = !isOpen;
-    arrow.textContent = isOpen ? "\u25B2" : "\u25BC";
-    if (isOpen) {
-      panel.append(content);
-    } else {
-      content.remove();
-    }
-  });
-  if (isOpen) {
-    panel.append(content);
-  }
-  document.body.append(panel);
-  const destroy = () => {
-    for (const unsub of unsubscribers) {
-      unsub();
-    }
-    panel.remove();
-    activeInstance = null;
-  };
-  activeInstance = destroy;
-  return destroy;
+	if (activeInstance) {
+		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("div", `background:#1e1e2e;border-radius:8px;box-shadow:0 4px 12px rgba(0,0,0,0.3);color:#cdd6f4;font-family:monospace;font-size:13px;max-width:320px;min-width:260px;padding:12px;position:fixed;z-index:99999;${POSITION_MAP[options?.position ?? "bottom-right"]}`, "spa-guard-debug-panel");
+	const { arrow, header } = createHeader(isOpen);
+	const content = buildContent(unsubscribers);
+	panel.append(header);
+	header.addEventListener("click", () => {
+		isOpen = !isOpen;
+		arrow.textContent = isOpen ? "▲" : "▼";
+		if (isOpen) panel.append(content);
+		else content.remove();
+	});
+	if (isOpen) panel.append(content);
+	document.body.append(panel);
+	const destroy = () => {
+		for (const unsub of unsubscribers) unsub();
+		panel.remove();
+		activeInstance = null;
+	};
+	activeInstance = destroy;
+	return destroy;
 }
 function buildContent(unsubscribers) {
-  const content = el("div", "margin-top:10px;", "debug-panel-content");
-  createButtons(content);
-  content.append(createStateSection(unsubscribers), createEventsSection(unsubscribers));
-  return content;
+	const content = el("div", "margin-top:10px;", "debug-panel-content");
+	createButtons(content);
+	content.append(createStateSection(unsubscribers), createEventsSection(unsubscribers));
+	return content;
 }
 function createButtons(content) {
-  const label = el("div", "color:#a6adc8;font-size:11px;margin-bottom:4px;");
-  label.textContent = "Error Scenarios";
-  content.append(label);
-  for (const scenario of SCENARIOS) {
-    const btn = el("button", getButtonCss("default"), `debug-btn-${scenario.key}`);
-    btn.setAttribute("type", "button");
-    btn.textContent = scenario.label;
-    btn.addEventListener("click", () => {
-      btn.textContent = getButtonLabel(scenario.label, "loading");
-      btn.setAttribute("style", getButtonCss("loading"));
-      btn.disabled = true;
-      scenario.dispatch();
-      void Promise.resolve().then(() => {
-        btn.textContent = getButtonLabel(scenario.label, "triggered");
-        btn.setAttribute("style", getButtonCss("triggered"));
-        btn.disabled = false;
-      });
-    });
-    content.append(btn);
-  }
+	const label = el("div", "color:#a6adc8;font-size:11px;margin-bottom:4px;");
+	label.textContent = "Error Scenarios";
+	content.append(label);
+	for (const scenario of SCENARIOS) {
+		const btn = el("button", getButtonCss("default"), `debug-btn-${scenario.key}`);
+		btn.setAttribute("type", "button");
+		btn.textContent = scenario.label;
+		btn.addEventListener("click", () => {
+			btn.textContent = getButtonLabel(scenario.label, "loading");
+			btn.setAttribute("style", getButtonCss("loading"));
+			btn.disabled = true;
+			scenario.dispatch();
+			Promise.resolve().then(() => {
+				btn.textContent = getButtonLabel(scenario.label, "triggered");
+				btn.setAttribute("style", getButtonCss("triggered"));
+				btn.disabled = false;
+			});
+		});
+		content.append(btn);
+	}
 }
 function createEventListHeader() {
-  const headerContainer = el(
-    "div",
-    "color:#a6adc8;font-size:11px;margin-bottom:4px;align-items:center;display:flex;justify-content:space-between;"
-  );
-  const countSpan = document.createElement("span");
-  countSpan.textContent = "Event History (0)";
-  const clearBtn = el(
-    "button",
-    "background:none;border:none;color:#a6adc8;cursor:pointer;font-family:monospace;font-size:11px;padding:0;",
-    "debug-clear-history"
-  );
-  clearBtn.setAttribute("type", "button");
-  clearBtn.textContent = "clear";
-  headerContainer.append(countSpan, clearBtn);
-  return { clearBtn, countSpan, headerContainer };
+	const headerContainer = el("div", "color:#a6adc8;font-size:11px;margin-bottom:4px;align-items:center;display:flex;justify-content:space-between;");
+	const countSpan = document.createElement("span");
+	countSpan.textContent = "Event History (0)";
+	const clearBtn = el("button", "background:none;border:none;color:#a6adc8;cursor:pointer;font-family:monospace;font-size:11px;padding:0;", "debug-clear-history");
+	clearBtn.setAttribute("type", "button");
+	clearBtn.textContent = "clear";
+	headerContainer.append(countSpan, clearBtn);
+	return {
+		clearBtn,
+		countSpan,
+		headerContainer
+	};
 }
 function createEventsSection(unsubscribers) {
-  const section = el(
-    "div",
-    "border-top:1px solid #45475a;margin-top:10px;padding-top:8px;",
-    "debug-events-section"
-  );
-  const { clearBtn, countSpan, headerContainer } = createEventListHeader();
-  section.append(headerContainer);
-  const eventList = el(
-    "div",
-    "font-size:11px;max-height:120px;overflow-y:auto;",
-    "debug-event-list"
-  );
-  section.append(eventList);
-  wireEventSubscription({ clearBtn, countSpan, eventList, unsubscribers });
-  return section;
+	const section = el("div", "border-top:1px solid #45475a;margin-top:10px;padding-top:8px;", "debug-events-section");
+	const { clearBtn, countSpan, headerContainer } = createEventListHeader();
+	section.append(headerContainer);
+	const eventList = el("div", "font-size:11px;max-height:120px;overflow-y:auto;", "debug-event-list");
+	section.append(eventList);
+	wireEventSubscription({
+		clearBtn,
+		countSpan,
+		eventList,
+		unsubscribers
+	});
+	return section;
 }
 function createHeader(isOpen) {
-  const header = el(
-    "button",
-    "align-items:center;background:none;border:none;color:inherit;cursor:pointer;display:flex;font-family:inherit;font-size:inherit;justify-content:space-between;padding:0;user-select:none;width:100%;",
-    "debug-panel-header"
-  );
-  header.setAttribute("type", "button");
-  const label = document.createElement("span");
-  label.textContent = "spa-guard debug";
-  const arrow = document.createElement("span");
-  arrow.textContent = isOpen ? "\u25B2" : "\u25BC";
-  header.append(label, arrow);
-  return { arrow, header };
+	const header = el("button", "align-items:center;background:none;border:none;color:inherit;cursor:pointer;display:flex;font-family:inherit;font-size:inherit;justify-content:space-between;padding:0;user-select:none;width:100%;", "debug-panel-header");
+	header.setAttribute("type", "button");
+	const label = document.createElement("span");
+	label.textContent = "spa-guard debug";
+	const arrow = document.createElement("span");
+	arrow.textContent = isOpen ? "▲" : "▼";
+	header.append(label, arrow);
+	return {
+		arrow,
+		header
+	};
 }
 function createStateRow(testId, labelText) {
-  const row = el(
-    "div",
-    "display:flex;font-size:11px;justify-content:space-between;margin-top:2px;",
-    testId
-  );
-  const label = document.createElement("span");
-  label.textContent = labelText;
-  const value = el("span", "color:#f9e2af;");
-  row.append(label, value);
-  return { row, value };
+	const row = el("div", "display:flex;font-size:11px;justify-content:space-between;margin-top:2px;", testId);
+	const label = document.createElement("span");
+	label.textContent = labelText;
+	const value = el("span", "color:#f9e2af;");
+	row.append(label, value);
+	return {
+		row,
+		value
+	};
 }
 function createStateSection(unsubscribers) {
-  const section = el(
-    "div",
-    "border-top:1px solid #45475a;margin-top:10px;padding-top:8px;",
-    "debug-state-section"
-  );
-  const label = el("div", "color:#a6adc8;font-size:11px;margin-bottom:4px;");
-  label.textContent = "State";
-  const attempt = createStateRow("debug-state-attempt", "attempt");
-  const waiting = createStateRow("debug-state-waiting", "isWaiting");
-  const fallback = createStateRow("debug-state-fallback", "isFallbackShown");
-  section.append(label, attempt.row, waiting.row, fallback.row);
-  unsubscribers.push(
-    subscribeToState((state) => {
-      attempt.value.textContent = String(state.currentAttempt);
-      waiting.value.textContent = String(state.isWaiting);
-      fallback.value.textContent = String(state.isFallbackShown);
-    })
-  );
-  return section;
+	const section = el("div", "border-top:1px solid #45475a;margin-top:10px;padding-top:8px;", "debug-state-section");
+	const label = el("div", "color:#a6adc8;font-size:11px;margin-bottom:4px;");
+	label.textContent = "State";
+	const attempt = createStateRow("debug-state-attempt", "attempt");
+	const waiting = createStateRow("debug-state-waiting", "isWaiting");
+	const fallback = createStateRow("debug-state-fallback", "isFallbackShown");
+	section.append(label, attempt.row, waiting.row, fallback.row);
+	unsubscribers.push(subscribeToState((state) => {
+		attempt.value.textContent = String(state.currentAttempt);
+		waiting.value.textContent = String(state.isWaiting);
+		fallback.value.textContent = String(state.isFallbackShown);
+	}));
+	return section;
 }
 function el(tag, css, testId) {
-  const e = document.createElement(tag);
-  e.setAttribute("style", css);
-  if (testId) {
-    e.dataset.testid = testId;
-  }
-  return e;
+	const e = document.createElement(tag);
+	e.setAttribute("style", css);
+	if (testId) e.dataset.testid = testId;
+	return e;
 }
 function formatTime(timestamp) {
-  return new Date(timestamp).toLocaleTimeString();
+	return new Date(timestamp).toLocaleTimeString();
 }
 function getButtonCss(status) {
-  const base = "border:1px solid #45475a;border-radius:4px;color:#cdd6f4;cursor:pointer;font-family:monospace;font-size:12px;margin-top:6px;padding:6px 10px;text-align:left;width:100%;";
-  switch (status) {
-    case "loading": {
-      return base + "background:#585b70;opacity:0.7;";
-    }
-    case "triggered": {
-      return base + "background:#a6e3a1;color:#1e1e2e;";
-    }
-    default: {
-      return base + "background:#313244;";
-    }
-  }
+	const base = "border:1px solid #45475a;border-radius:4px;color:#cdd6f4;cursor:pointer;font-family:monospace;font-size:12px;margin-top:6px;padding:6px 10px;text-align:left;width:100%;";
+	switch (status) {
+		case "loading": return base + "background:#585b70;opacity:0.7;";
+		case "triggered": return base + "background:#a6e3a1;color:#1e1e2e;";
+		default: return base + "background:#313244;";
+	}
 }
 function getButtonLabel(label, status) {
-  switch (status) {
-    case "loading": {
-      return `${label}...`;
-    }
-    case "triggered": {
-      return `${label} \u2713`;
-    }
-    default: {
-      return label;
-    }
-  }
+	switch (status) {
+		case "loading": return `${label}...`;
+		case "triggered": return `${label} \u2713`;
+		default: return label;
+	}
 }
 function wireEventSubscription(params) {
-  const { clearBtn, countSpan, eventList, unsubscribers } = params;
-  let history = [];
-  function render() {
-    countSpan.textContent = `Event History (${String(history.length)})`;
-    eventList.innerHTML = "";
-    for (const entry of history) {
-      const row = el("div", "border-bottom:1px solid #313244;padding:3px 0;", "debug-event-entry");
-      const time = el("span", "color:#585b70;margin-right:6px;");
-      time.textContent = formatTime(entry.timestamp);
-      const name = el("span", "color:#89b4fa;");
-      name.textContent = entry.event.name;
-      row.append(time, name);
-      eventList.append(row);
-    }
-  }
-  clearBtn.addEventListener("click", () => {
-    history = [];
-    render();
-  });
-  unsubscribers.push(
-    subscribe((event) => {
-      history = [...history, { event, timestamp: Date.now() }];
-      if (history.length > MAX_EVENT_HISTORY) {
-        history = history.slice(-MAX_EVENT_HISTORY);
-      }
-      render();
-    })
-  );
+	const { clearBtn, countSpan, eventList, unsubscribers } = params;
+	let history = [];
+	function render() {
+		countSpan.textContent = `Event History (${String(history.length)})`;
+		eventList.innerHTML = "";
+		for (const entry of history) {
+			const row = el("div", "border-bottom:1px solid #313244;padding:3px 0;", "debug-event-entry");
+			const time = el("span", "color:#585b70;margin-right:6px;");
+			time.textContent = formatTime(entry.timestamp);
+			const name = el("span", "color:#89b4fa;");
+			name.textContent = entry.event.name;
+			row.append(time, name);
+			eventList.append(row);
+		}
+	}
+	clearBtn.addEventListener("click", () => {
+		history = [];
+		render();
+	});
+	unsubscribers.push(subscribe((event) => {
+		history = [...history, {
+			event,
+			timestamp: Date.now()
+		}];
+		if (history.length > MAX_EVENT_HISTORY) history = history.slice(-MAX_EVENT_HISTORY);
+		render();
+	}));
 }
-export {
-  createDebugger
-};
+//#endregion
+export { createDebugger };

package/dist/runtime/index.d.ts

@@ -1,8 +1,66 @@
-export { startVersionCheck, stopVersionCheck } from "../common/checkVersion";
-export { ForceRetryError } from "../common/errors/ForceRetryError";
-export { setTranslations } from "../common/i18n";
-export { dismissSpinner, getSpinnerHtml, showSpinner } from "../common/spinner";
-export { recommendedSetup } from "./recommendedSetup";
-export type { RecommendedSetupOptions } from "./recommendedSetup";
-export { getState, subscribeToState } from "./state";
-export type { SpaGuardState } from "./state";
+import { g as UnsubscribeFn } from "../types-DrN8pgyc.mjs";
+import { i as getSpinnerHtml, l as setTranslations, o as showSpinner, r as dismissSpinner } from "../spinner-X23gI09z.mjs";
+import { t as ForceRetryError } from "../ForceRetryError-BWLv3UVK.mjs";
+
+//#region src/common/checkVersion.d.ts
+declare const startVersionCheck: () => void;
+declare const stopVersionCheck: () => void;
+//#endregion
+//#region src/runtime/recommendedSetup.d.ts
+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.
+ */
+declare const recommendedSetup: (overrides?: RecommendedSetupOptions) => (() => void);
+//#endregion
+//#region src/runtime/state.d.ts
+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;
+declare const getState: () => SpaGuardState;
+declare const subscribeToState: (cb: StateSubscriber) => UnsubscribeFn;
+//#endregion
+export { ForceRetryError, type RecommendedSetupOptions, type SpaGuardState, dismissSpinner, getSpinnerHtml, getState, recommendedSetup, setTranslations, showSpinner, startVersionCheck, stopVersionCheck, subscribeToState };