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

package/dist/schema/index.d.ts

@@ -1,13 +1,2 @@
-export interface BeaconSchema {
-    appName?: string;
-    errorContext?: string;
-    errorMessage?: string;
-    errorType?: string;
-    eventMessage?: string;
-    eventName?: string;
-    httpStatus?: number;
-    retryAttempt?: number;
-    retryId?: string;
-    serialized?: string;
-    url?: string;
-}
+import { t as BeaconSchema } from "../index-rPxPv6iu.mjs";
+export { BeaconSchema };

package/dist/schema/index.js

@@ -0,0 +1 @@
+export {};

package/dist/schema/parse.d.ts

@@ -1,2 +1,6 @@
-import type { BeaconSchema } from ".";
-export declare function parseBeacon(data: unknown): BeaconSchema;
+import { t as BeaconSchema } from "../index-rPxPv6iu.mjs";
+
+//#region src/schema/parse.d.ts
+declare function parseBeacon(data: unknown): BeaconSchema;
+//#endregion
+export { parseBeacon };

package/dist/schema/parse.js

@@ -1,47 +1,32 @@
-import "../chunk-MLKGABMK.js";
-
-// src/schema/parse.ts
-var STRING_FIELDS = [
-  "appName",
-  "errorContext",
-  "errorMessage",
-  "errorType",
-  "eventMessage",
-  "eventName",
-  "retryId",
-  "serialized",
-  "url"
+//#region src/schema/parse.ts
+const STRING_FIELDS = [
+	"appName",
+	"errorContext",
+	"errorMessage",
+	"errorType",
+	"eventMessage",
+	"eventName",
+	"retryId",
+	"serialized",
+	"url"
 ];
-var MAX_STRING_FIELD_LENGTH = 500;
-var MAX_SERIALIZED_LENGTH = 1e4;
+const MAX_STRING_FIELD_LENGTH = 500;
+const MAX_SERIALIZED_LENGTH = 1e4;
 function parseBeacon(data) {
-  if (!data || typeof data !== "object" || Array.isArray(data)) {
-    throw new Error("Invalid beacon");
-  }
-  const d = data;
-  const result = {};
-  for (const field of STRING_FIELDS) {
-    if (field in d) {
-      if (typeof d[field] !== "string") {
-        throw new TypeError(`Beacon validation failed: ${field} must be a string`);
-      }
-      const maxLen = field === "serialized" ? MAX_SERIALIZED_LENGTH : MAX_STRING_FIELD_LENGTH;
-      if (d[field].length > maxLen) {
-        throw new TypeError(`Beacon validation failed: ${field} exceeds maximum length`);
-      }
-      result[field] = d[field];
-    }
-  }
-  for (const field of ["retryAttempt", "httpStatus"]) {
-    if (field in d) {
-      if (typeof d[field] !== "number" || !Number.isFinite(d[field])) {
-        throw new TypeError(`Beacon validation failed: ${field} must be a finite number`);
-      }
-      result[field] = d[field];
-    }
-  }
-  return result;
+	if (!data || typeof data !== "object" || Array.isArray(data)) throw new Error("Invalid beacon");
+	const d = data;
+	const result = {};
+	for (const field of STRING_FIELDS) if (field in d) {
+		if (typeof d[field] !== "string") throw new TypeError(`Beacon validation failed: ${field} must be a string`);
+		const maxLen = field === "serialized" ? MAX_SERIALIZED_LENGTH : MAX_STRING_FIELD_LENGTH;
+		if (d[field].length > maxLen) throw new TypeError(`Beacon validation failed: ${field} exceeds maximum length`);
+		result[field] = d[field];
+	}
+	for (const field of ["retryAttempt", "httpStatus"]) if (field in d) {
+		if (typeof d[field] !== "number" || !Number.isFinite(d[field])) throw new TypeError(`Beacon validation failed: ${field} must be a finite number`);
+		result[field] = d[field];
+	}
+	return result;
 }
-export {
-  parseBeacon
-};
+//#endregion
+export { parseBeacon };

package/dist/spinner-BbZVKZ-6.mjs

@@ -0,0 +1,60 @@
+import { F as spinnerStateWindowKey, b as defaultSpinnerHtml, g as getOptions } from "./retryOrchestrator-DNGIHV2M.mjs";
+//#region src/common/parseVersion.ts
+/**
+* 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.
+*/
+function extractVersionFromHtml(html) {
+	const collapsed = html.replaceAll(/[\r\n]+/g, "");
+	const versionMatch = collapsed.match(/__SPA_GUARD_VERSION__\s*=\s*"([^"]+)"/);
+	if (versionMatch?.[1]) return versionMatch[1];
+	const markerIdx = collapsed.indexOf("__SPA_GUARD_OPTIONS__");
+	if (markerIdx === -1) return null;
+	return collapsed.slice(markerIdx, markerIdx + 1e3).match(/__SPA_GUARD_OPTIONS__\s*=\s*\{.*?"?version"?\s*:\s*"([^"]+)"/)?.[1] ?? null;
+}
+//#endregion
+//#region src/common/spinner.ts
+const SPINNER_ID = "__spa-guard-spinner";
+const defaultSpinnerSvg = defaultSpinnerHtml;
+const getState = () => {
+	if (!globalThis.window[spinnerStateWindowKey]) globalThis.window[spinnerStateWindowKey] = { savedOverflow: null };
+	return globalThis.window[spinnerStateWindowKey];
+};
+function dismissSpinner() {
+	if (typeof document === "undefined") return;
+	const el = document.getElementById(SPINNER_ID);
+	if (el) el.remove();
+	const state = getState();
+	if (state.savedOverflow !== null) {
+		document.body.style.overflow = state.savedOverflow;
+		state.savedOverflow = null;
+	} else if (el) document.body.style.overflow = "";
+}
+const sanitizeCssValue = (value) => value.replaceAll(/["'<>\\{};\n]/g, "");
+function getSpinnerHtml(backgroundOverride) {
+	const opts = getOptions();
+	if (opts.html?.spinner?.disabled) return "";
+	const spinnerContent = opts.html?.spinner?.content ?? defaultSpinnerSvg;
+	return `<div id="${SPINNER_ID}" style="position:fixed;inset:0;z-index:2147483647;display:flex;align-items:center;justify-content:center;background:var(--spa-guard-spinner-bg,${sanitizeCssValue(backgroundOverride ?? opts.html?.spinner?.background ?? "#fff")})">${spinnerContent}</div>`;
+}
+function showSpinner(options) {
+	if (typeof document === "undefined") return () => {};
+	if (getOptions().html?.spinner?.disabled) return () => {};
+	const existing = document.getElementById(SPINNER_ID);
+	if (existing) existing.remove();
+	const html = getSpinnerHtml(options?.background);
+	if (!html) return () => {};
+	const wrapper = document.createElement("div");
+	wrapper.innerHTML = html;
+	const overlay = wrapper.firstElementChild;
+	if (!existing) getState().savedOverflow = document.body.style.overflow;
+	document.body.style.overflow = "hidden";
+	document.body.append(overlay);
+	return () => dismissSpinner();
+}
+//#endregion
+export { sanitizeCssValue as a, getSpinnerHtml as i, defaultSpinnerSvg as n, showSpinner as o, dismissSpinner as r, extractVersionFromHtml as s, SPINNER_ID as t };

package/dist/spinner-X23gI09z.d.mts

@@ -0,0 +1,37 @@
+import { t as SpaGuardTranslations } from "./index-DL8CfPXg.mjs";
+
+//#region src/common/i18n.d.ts
+/**
+ * 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.
+ */
+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.
+ */
+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.
+ */
+declare function setTranslations(translations: SpaGuardTranslations): void;
+//#endregion
+//#region src/common/spinner.d.ts
+declare const SPINNER_ID = "__spa-guard-spinner";
+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>";
+declare function dismissSpinner(): void;
+declare const sanitizeCssValue: (value: string) => string;
+declare function getSpinnerHtml(backgroundOverride?: string): string;
+declare function showSpinner(options?: {
+  background?: string;
+}): () => void;
+//#endregion
+export { sanitizeCssValue as a, getI18n as c, getSpinnerHtml as i, setTranslations as l, defaultSpinnerSvg as n, showSpinner as o, dismissSpinner as r, applyI18n as s, SPINNER_ID as t };

package/dist/state-I20jENMD.mjs

@@ -0,0 +1,93 @@
+import { M as subscribe, h as getRetryStateFromUrl, p as getRetryAttemptFromUrl, u as getLastRetryResetInfo } from "./retryOrchestrator-DNGIHV2M.mjs";
+//#region src/runtime/state.ts
+const getInitialStateFromUrl = () => {
+	const resetInfo = getLastRetryResetInfo();
+	const resetInfoSpread = {
+		...resetInfo?.previousRetryId !== void 0 && { lastResetRetryId: resetInfo.previousRetryId },
+		...resetInfo?.timestamp !== void 0 && { lastRetryResetTime: resetInfo.timestamp }
+	};
+	if (globalThis.window === void 0) return {
+		currentAttempt: 0,
+		isFallbackShown: false,
+		isWaiting: false,
+		...resetInfoSpread
+	};
+	const retryState = getRetryStateFromUrl();
+	if (!retryState) {
+		const attempt = getRetryAttemptFromUrl();
+		if (attempt !== null) return {
+			currentAttempt: attempt,
+			isFallbackShown: false,
+			isWaiting: false,
+			...resetInfoSpread
+		};
+		return {
+			currentAttempt: 0,
+			isFallbackShown: false,
+			isWaiting: false,
+			...resetInfoSpread
+		};
+	}
+	return {
+		currentAttempt: retryState.retryAttempt,
+		isFallbackShown: false,
+		isWaiting: false,
+		...resetInfoSpread
+	};
+};
+let currentState = getInitialStateFromUrl();
+const stateSubscribers = /* @__PURE__ */ new Set();
+const updateState = (nextState) => {
+	currentState = nextState;
+	stateSubscribers.forEach((cb) => {
+		try {
+			cb(currentState);
+		} catch {}
+	});
+};
+subscribe((event) => {
+	switch (event.name) {
+		case "fallback-ui-shown":
+			updateState({
+				...currentState,
+				isFallbackShown: true
+			});
+			break;
+		case "retry-attempt":
+			updateState({
+				...currentState,
+				currentAttempt: event.attempt,
+				isFallbackShown: false,
+				isWaiting: true
+			});
+			break;
+		case "retry-exhausted":
+			updateState({
+				...currentState,
+				currentAttempt: event.finalAttempt,
+				isFallbackShown: false,
+				isWaiting: false
+			});
+			break;
+		case "retry-reset":
+			updateState({
+				...currentState,
+				currentAttempt: 0,
+				isFallbackShown: false,
+				isWaiting: false,
+				lastResetRetryId: event.previousRetryId,
+				lastRetryResetTime: Date.now()
+			});
+			break;
+	}
+});
+const getState = () => currentState;
+const subscribeToState = (cb) => {
+	cb(currentState);
+	stateSubscribers.add(cb);
+	return () => {
+		stateSubscribers.delete(cb);
+	};
+};
+//#endregion
+export { subscribeToState as n, getState as t };

package/dist/types-DrN8pgyc.d.mts

@@ -0,0 +1,107 @@
+//#region src/common/events/types.d.ts
+interface EmitOptions {
+  silent?: boolean;
+}
+interface InternalConfig {
+  defaultRetryEnabled: boolean;
+  initialized: boolean;
+}
+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";
+});
+interface SPAGuardEventChunkError {
+  error: unknown;
+  isRetrying: boolean;
+  name: "chunk-error";
+}
+interface SPAGuardEventFallbackUINotRendered {
+  name: "fallback-ui-not-rendered";
+  reason: "no-html-configured" | "target-not-found";
+  selector?: string;
+}
+interface SPAGuardEventFallbackUIShown {
+  name: "fallback-ui-shown";
+}
+/** Emitted before each module-level retry attempt initiated by retryImport. */
+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. */
+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. */
+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. */
+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;
+}
+interface SPAGuardEventRetryAttempt {
+  attempt: number;
+  delay: number;
+  name: "retry-attempt";
+  retryId: string;
+}
+interface SPAGuardEventRetryExhausted {
+  finalAttempt: number;
+  name: "retry-exhausted";
+  retryId: string;
+}
+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. */
+interface SPAGuardEventStaticAssetLoadFailed {
+  name: "static-asset-load-failed";
+  /** The URL of the asset that failed to load. */
+  url: string;
+}
+type SubscribeFn = (event: SPAGuardEvent) => void;
+type UnsubscribeFn = () => void;
+//#endregion
+export { SPAGuardEventFallbackUINotRendered as a, SPAGuardEventLazyRetryExhausted as c, SPAGuardEventRetryAttempt as d, SPAGuardEventRetryExhausted as f, UnsubscribeFn as g, SubscribeFn as h, SPAGuardEventChunkError as i, SPAGuardEventLazyRetryStart as l, SPAGuardEventStaticAssetLoadFailed as m, InternalConfig as n, SPAGuardEventFallbackUIShown as o, SPAGuardEventRetryReset as p, SPAGuardEvent as r, SPAGuardEventLazyRetryAttempt as s, EmitOptions as t, SPAGuardEventLazyRetrySuccess as u };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ovineko/spa-guard",
-  "version": "0.0.2-alpha-1",
+  "version": "0.0.4",
   "description": "Chunk load error handling for SPAs — core runtime, error handling, schema, i18n",
   "keywords": [
     "spa",
@@ -61,9 +61,6 @@
   "files": [
     "dist"
   ],
-  "engines": {
-    "node": ">=22.15.0"
-  },
   "publishConfig": {
     "access": "public"
   }

package/dist/chunk-3UJ67DPX.js

@@ -1,98 +0,0 @@
-import {
-  defaultSpinnerHtml,
-  getOptions,
-  spinnerStateWindowKey
-} from "./chunk-GE63YJOT.js";
-
-// src/common/parseVersion.ts
-function extractVersionFromHtml(html) {
-  const collapsed = html.replaceAll(/[\r\n]+/g, "");
-  const versionMatch = collapsed.match(/__SPA_GUARD_VERSION__\s*=\s*"([^"]+)"/);
-  if (versionMatch?.[1]) {
-    return versionMatch[1];
-  }
-  const markerIdx = collapsed.indexOf("__SPA_GUARD_OPTIONS__");
-  if (markerIdx === -1) {
-    return null;
-  }
-  const segment = collapsed.slice(markerIdx, markerIdx + 1e3);
-  const optionsMatch = segment.match(
-    /__SPA_GUARD_OPTIONS__\s*=\s*\{.*?"?version"?\s*:\s*"([^"]+)"/
-  );
-  return optionsMatch?.[1] ?? null;
-}
-
-// src/common/spinner.ts
-var SPINNER_ID = "__spa-guard-spinner";
-var defaultSpinnerSvg = defaultSpinnerHtml;
-var getState = () => {
-  if (!globalThis.window[spinnerStateWindowKey]) {
-    globalThis.window[spinnerStateWindowKey] = { savedOverflow: null };
-  }
-  return globalThis.window[spinnerStateWindowKey];
-};
-function dismissSpinner() {
-  if (typeof document === "undefined") {
-    return;
-  }
-  const el = document.getElementById(SPINNER_ID);
-  if (el) {
-    el.remove();
-  }
-  const state = getState();
-  if (state.savedOverflow !== null) {
-    document.body.style.overflow = state.savedOverflow;
-    state.savedOverflow = null;
-  } else if (el) {
-    document.body.style.overflow = "";
-  }
-}
-var sanitizeCssValue = (value) => value.replaceAll(/["'<>\\{};\n]/g, "");
-function getSpinnerHtml(backgroundOverride) {
-  const opts = getOptions();
-  if (opts.html?.spinner?.disabled) {
-    return "";
-  }
-  const spinnerContent = opts.html?.spinner?.content ?? defaultSpinnerSvg;
-  const bg = sanitizeCssValue(backgroundOverride ?? opts.html?.spinner?.background ?? "#fff");
-  return `<div id="${SPINNER_ID}" style="position:fixed;inset:0;z-index:2147483647;display:flex;align-items:center;justify-content:center;background:var(--spa-guard-spinner-bg,${bg})">${spinnerContent}</div>`;
-}
-function showSpinner(options) {
-  if (typeof document === "undefined") {
-    return () => {
-    };
-  }
-  const opts = getOptions();
-  if (opts.html?.spinner?.disabled) {
-    return () => {
-    };
-  }
-  const existing = document.getElementById(SPINNER_ID);
-  if (existing) {
-    existing.remove();
-  }
-  const html = getSpinnerHtml(options?.background);
-  if (!html) {
-    return () => {
-    };
-  }
-  const wrapper = document.createElement("div");
-  wrapper.innerHTML = html;
-  const overlay = wrapper.firstElementChild;
-  if (!existing) {
-    getState().savedOverflow = document.body.style.overflow;
-  }
-  document.body.style.overflow = "hidden";
-  document.body.append(overlay);
-  return () => dismissSpinner();
-}
-
-export {
-  extractVersionFromHtml,
-  SPINNER_ID,
-  defaultSpinnerSvg,
-  dismissSpinner,
-  sanitizeCssValue,
-  getSpinnerHtml,
-  showSpinner
-};