@ttt-productions/media-viewer 0.8.0 → 0.8.1

package/dist/index.d.ts

@@ -1,2 +1,3 @@
-export type { MediaViewerType, FallbackMode, BaseMediaProps, ImageViewerProps, VideoViewerProps, AudioViewerProps, MediaPreviewProps, MediaViewerProps, } from "./types.js";
+export type { MediaViewerType, FallbackMode, BaseMediaProps, ImageViewerProps, VideoViewerProps, AudioViewerProps, MediaPreviewProps, MediaViewerProps, MediaDiagnosticAdapter, AssetStatusHint, DiagnosisResult, RecoveryState, } from "./types.js";
+export { BACKOFF_SCHEDULE_MS, MAX_RECOVERY_DURATION_MS, applyJitter, backoffForAttempt, withinBudget, } from "./recovery.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,eAAe,EACf,YAAY,EACZ,cAAc,EACd,gBAAgB,EAChB,gBAAgB,EAChB,gBAAgB,EAChB,iBAAiB,EACjB,gBAAgB,GACjB,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,eAAe,EACf,YAAY,EACZ,cAAc,EACd,gBAAgB,EAChB,gBAAgB,EAChB,gBAAgB,EAChB,iBAAiB,EACjB,gBAAgB,EAChB,sBAAsB,EACtB,eAAe,EACf,eAAe,EACf,aAAa,GACd,MAAM,YAAY,CAAC;AAEpB,OAAO,EACL,mBAAmB,EACnB,wBAAwB,EACxB,WAAW,EACX,iBAAiB,EACjB,YAAY,GACb,MAAM,eAAe,CAAC"}

package/dist/index.js

@@ -1,2 +1,2 @@
-export {};
+export { BACKOFF_SCHEDULE_MS, MAX_RECOVERY_DURATION_MS, applyJitter, backoffForAttempt, withinBudget, } from "./recovery.js";
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":""}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAeA,OAAO,EACL,mBAAmB,EACnB,wBAAwB,EACxB,WAAW,EACX,iBAAiB,EACjB,YAAY,GACb,MAAM,eAAe,CAAC"}

package/dist/react/index.d.ts

@@ -3,4 +3,6 @@ export { ImageViewer } from "./image-viewer.js";
 export { VideoViewer } from "./video-viewer.js";
 export { AudioViewer } from "./audio-viewer.js";
 export { MediaFallbackLink, shouldShowFallback, EmptyFallback, ErrorFallback } from "./fallback.js";
+export { useMediaRecovery } from "./use-media-recovery.js";
+export type { UseMediaRecoveryOptions, UseMediaRecoveryResult } from "./use-media-recovery.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/react/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/react/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAC9D,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/react/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAC9D,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AACpG,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,YAAY,EAAE,uBAAuB,EAAE,sBAAsB,EAAE,MAAM,yBAAyB,CAAC"}

package/dist/react/index.js

@@ -4,4 +4,5 @@ export { ImageViewer } from "./image-viewer.js";
 export { VideoViewer } from "./video-viewer.js";
 export { AudioViewer } from "./audio-viewer.js";
 export { MediaFallbackLink, shouldShowFallback, EmptyFallback, ErrorFallback } from "./fallback.js";
+export { useMediaRecovery } from "./use-media-recovery.js";
 //# sourceMappingURL=index.js.map

package/dist/react/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/react/index.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAEb,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAC9D,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/react/index.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAEb,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAC9D,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AACpG,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC"}

package/dist/react/media-viewer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"media-viewer.d.ts","sourceRoot":"","sources":["../../src/react/media-viewer.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAI/B,OAAO,KAAK,EAAE,iBAAiB,EAAiC,MAAM,aAAa,CAAC;AAoBpF,wBAAgB,WAAW,CAAC,KAAK,EAAE,iBAAiB,4BAyJnD;AAED,wBAAwB;AACxB,eAAO,MAAM,YAAY,oBAAc,CAAC"}
+{"version":3,"file":"media-viewer.d.ts","sourceRoot":"","sources":["../../src/react/media-viewer.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAI/B,OAAO,KAAK,EAAE,iBAAiB,EAAiC,MAAM,aAAa,CAAC;AA6GpF,wBAAgB,WAAW,CAAC,KAAK,EAAE,iBAAiB,4BAiNnD;AAED,wBAAwB;AACxB,eAAO,MAAM,YAAY,oBAAc,CAAC"}

package/dist/react/media-viewer.js

@@ -1,10 +1,11 @@
-import { jsx as _jsx } from "react/jsx-runtime";
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import * as React from "react";
 import { getSimplifiedMediaType } from "@ttt-productions/media-schemas";
 import { MediaFallbackLink, shouldShowFallback, EmptyFallback, ErrorFallback } from "./fallback.js";
 import { ImageViewer } from "./image-viewer.js";
 import { VideoViewer } from "./video-viewer.js";
 import { AudioViewer } from "./audio-viewer.js";
+import { useMediaRecovery } from "./use-media-recovery.js";
 function inferType(props) {
     if (props.type) {
         // Handle MIME strings like "image/png" -> "image"
@@ -20,10 +21,61 @@ function inferType(props) {
     const simplified = getSimplifiedMediaType(hint);
     return simplified;
 }
+// ---------------------------------------------------------------------------
+// Recovery-phase UI helpers
+// ---------------------------------------------------------------------------
+function RecoveryOverlay({ state, onManualRetry, isCircular }) {
+    const wrapStyle = {
+        display: "flex",
+        flexDirection: "column",
+        alignItems: "center",
+        justifyContent: "center",
+        width: "100%",
+        height: "100%",
+        gap: "0.5rem",
+        ...(isCircular ? { borderRadius: "50%" } : {}),
+    };
+    if (state.phase === "processing") {
+        return (_jsx("div", { className: "mv-recovery-processing", style: wrapStyle, children: _jsx("span", { className: "mv-recovery-label", children: "Processing media\u2026" }) }));
+    }
+    if (state.phase === "finalizing") {
+        return (_jsx("div", { className: "mv-recovery-finalizing", style: wrapStyle, children: _jsx("span", { className: "mv-recovery-label", children: "Finishing media\u2026" }) }));
+    }
+    if (state.phase === "transient-retry" || state.phase === "propagating") {
+        return (_jsx("div", { className: "mv-recovery-retrying", style: wrapStyle, children: _jsx("span", { className: "mv-recovery-label", children: "Loading\u2026" }) }));
+    }
+    if (state.phase === "auth-retry") {
+        return (_jsx("div", { className: "mv-recovery-auth", style: wrapStyle, children: _jsx("span", { className: "mv-recovery-label", children: "Refreshing access\u2026" }) }));
+    }
+    if (state.phase === "hard-unavailable") {
+        return (_jsxs("div", { className: "mv-recovery-hard", style: wrapStyle, children: [_jsx(ErrorFallback, { isCircular: isCircular }), state.reason === "auth" ? (_jsx("span", { className: "mv-recovery-label", children: "Access denied." })) : (_jsx("span", { className: "mv-recovery-label", children: "Media unavailable." }))] }));
+    }
+    if (state.phase === "max-wait-fallback") {
+        return (_jsxs("div", { className: "mv-recovery-max-wait", style: wrapStyle, children: [_jsx("span", { className: "mv-recovery-label", children: "This media is taking longer than expected." }), _jsx("button", { type: "button", className: "mv-recovery-retry-btn", onClick: onManualRetry, children: "Retry" })] }));
+    }
+    return null;
+}
+// ---------------------------------------------------------------------------
+// Main component
+// ---------------------------------------------------------------------------
 export function MediaViewer(props) {
-    const { url, alt, type, className, unloadOnExit, isCircular = false, priority, skeleton, lazy, controls, autoPlay, muted, loop, posterUrl, preload, autoPlayOnVisible, onLoad, onError, onLoadChange, fallbackMode = "link", fallbackLabel, filename, mime, name, } = props;
+    const { url, alt, type, className, unloadOnExit, isCircular = false, priority, skeleton, lazy, controls, autoPlay, muted, loop, posterUrl, preload, autoPlayOnVisible, onLoad, onError, onLoadChange, fallbackMode = "link", fallbackLabel, filename, mime, name, recoveryAdapter, assetStatusHint, } = props;
     const [hasError, setHasError] = React.useState(false);
     const [sourceUrl, setSourceUrl] = React.useState(null);
+    // Remount key: incrementing this causes child media elements to unmount and
+    // re-mount from scratch, re-issuing the HTTP request.
+    const [remountKey, setRemountKey] = React.useState(0);
+    const handleRemount = React.useCallback(() => {
+        setHasError(false);
+        setRemountKey((k) => k + 1);
+    }, []);
+    // Recovery hook (no-op when recoveryAdapter is omitted)
+    const { recoveryState, onMediaError, onMediaLoad, manualRetry } = useMediaRecovery({
+        url: typeof url === "string" ? url : null,
+        adapter: recoveryAdapter,
+        statusHint: assetStatusHint,
+        onRemount: handleRemount,
+    });
     React.useEffect(() => {
         setHasError(false);
         let objectUrl = null;
@@ -45,7 +97,19 @@ export function MediaViewer(props) {
     const handleError = React.useCallback(() => {
         setHasError(true);
         onError?.();
-    }, [onError]);
+        // If a recovery adapter is provided, delegate to the recovery hook.
+        if (recoveryAdapter) {
+            onMediaError();
+        }
+    }, [onError, recoveryAdapter, onMediaError]);
+    const handleLoad = React.useCallback(() => {
+        setHasError(false);
+        onLoad?.();
+        // Signal successful load to the recovery state machine.
+        if (recoveryAdapter) {
+            onMediaLoad();
+        }
+    }, [onLoad, recoveryAdapter, onMediaLoad]);
     const circularStyle = isCircular
         ? { borderRadius: "50%", overflow: "hidden" }
         : {};
@@ -55,23 +119,32 @@ export function MediaViewer(props) {
         height: "100%",
         ...circularStyle,
     };
+    // When recovery is active and in a terminal/blocking state, show the overlay.
+    const isInRecovery = recoveryAdapter !== undefined &&
+        recoveryState.phase !== "idle" &&
+        recoveryState.phase !== "loaded" &&
+        recoveryState.phase !== "loading";
     // No URL -> empty fallback
     if (!sourceUrl) {
         return (_jsx("div", { className: className, style: wrapperStyle, children: _jsx(EmptyFallback, { isCircular: isCircular }) }));
     }
-    // Error -> error fallback
-    if (hasError) {
+    // Recovery overlay (for all non-idle/non-loaded recovery states)
+    if (isInRecovery && hasError) {
+        return (_jsx("div", { className: className, style: wrapperStyle, children: _jsx(RecoveryOverlay, { state: recoveryState, onManualRetry: manualRetry, isCircular: isCircular }) }));
+    }
+    // Vanilla error (no recovery adapter) -> error fallback
+    if (hasError && !recoveryAdapter) {
         return (_jsx("div", { className: className, style: wrapperStyle, children: _jsx(ErrorFallback, { isCircular: isCircular }) }));
     }
     const t = inferType({ type, mime, name, url: sourceUrl });
     if (t === "image") {
-        return (_jsx("div", { className: className, style: wrapperStyle, children: _jsx(ImageViewer, { url: sourceUrl, alt: alt, lazy: lazy, priority: priority, skeleton: skeleton, unloadOnExit: unloadOnExit, isCircular: isCircular, onLoad: onLoad, onError: handleError, fallback: _jsx(ErrorFallback, { isCircular: isCircular }) }) }));
+        return (_jsx("div", { className: className, style: wrapperStyle, children: _jsx(ImageViewer, { url: sourceUrl, alt: alt, lazy: lazy, priority: priority, skeleton: skeleton, unloadOnExit: unloadOnExit, isCircular: isCircular, onLoad: handleLoad, onError: handleError, fallback: _jsx(ErrorFallback, { isCircular: isCircular }) }, remountKey) }));
     }
     if (t === "video") {
-        return (_jsx("div", { className: className, style: wrapperStyle, children: _jsx(VideoViewer, { url: sourceUrl, lazy: lazy, priority: priority, skeleton: skeleton, unloadOnExit: unloadOnExit, controls: controls, autoPlay: autoPlay, muted: muted, loop: loop, posterUrl: posterUrl, preload: preload, autoPlayOnVisible: autoPlayOnVisible, onLoad: onLoad, onError: handleError }) }));
+        return (_jsx("div", { className: className, style: wrapperStyle, children: _jsx(VideoViewer, { url: sourceUrl, lazy: lazy, priority: priority, skeleton: skeleton, unloadOnExit: unloadOnExit, controls: controls, autoPlay: autoPlay, muted: muted, loop: loop, posterUrl: posterUrl, preload: preload, autoPlayOnVisible: autoPlayOnVisible, onLoad: handleLoad, onError: handleError }, remountKey) }));
     }
     if (t === "audio") {
-        return (_jsx("div", { className: className, style: wrapperStyle, children: _jsx(AudioViewer, { url: sourceUrl, lazy: lazy, priority: priority, skeleton: skeleton, controls: controls, autoPlay: autoPlay, loop: loop, preload: preload, onLoad: onLoad, onLoadChange: onLoadChange, onError: handleError }) }));
+        return (_jsx("div", { className: className, style: wrapperStyle, children: _jsx(AudioViewer, { url: sourceUrl, lazy: lazy, priority: priority, skeleton: skeleton, controls: controls, autoPlay: autoPlay, loop: loop, preload: preload, onLoad: handleLoad, onLoadChange: onLoadChange, onError: handleError }, remountKey) }));
     }
     // Unknown type -> fallback link
     return shouldShowFallback(fallbackMode) ? (_jsx("div", { className: className, style: wrapperStyle, children: _jsx(MediaFallbackLink, { url: sourceUrl, filename: filename, label: fallbackLabel ?? "Download" }) })) : null;

package/dist/react/media-viewer.js.map

@@ -1 +1 @@
-{"version":3,"file":"media-viewer.js","sourceRoot":"","sources":["../../src/react/media-viewer.tsx"],"names":[],"mappings":";AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAC/B,OAAO,EAAE,sBAAsB,EAAE,MAAM,gCAAgC,CAAC;AAIxE,OAAO,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AACpG,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAEhD,SAAS,SAAS,CAAC,KAAuF;IACxG,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC;QACf,kDAAkD;QAClD,MAAM,OAAO,GAAG,OAAO,KAAK,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC;QACvF,IAAI,OAAO,KAAK,OAAO,IAAI,OAAO,KAAK,OAAO,IAAI,OAAO,KAAK,OAAO;YAAE,OAAO,OAAO,CAAC;QACtF,IAAI,OAAO,KAAK,OAAO;YAAE,OAAO,OAAO,CAAC;IAC1C,CAAC;IAED,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,IAAI,KAAK,CAAC,IAAI,IAAI,KAAK,CAAC,GAAG,CAAC;IACnD,IAAI,CAAC,IAAI;QAAE,OAAO,OAAO,CAAC;IAC1B,MAAM,UAAU,GAAwB,sBAAsB,CAAC,IAAI,CAAC,CAAC;IACrE,OAAO,UAAU,CAAC;AACpB,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,KAAwB;IAClD,MAAM,EACJ,GAAG,EACH,GAAG,EACH,IAAI,EACJ,SAAS,EACT,YAAY,EACZ,UAAU,GAAG,KAAK,EAClB,QAAQ,EACR,QAAQ,EACR,IAAI,EACJ,QAAQ,EACR,QAAQ,EACR,KAAK,EACL,IAAI,EACJ,SAAS,EACT,OAAO,EACP,iBAAiB,EACjB,MAAM,EACN,OAAO,EACP,YAAY,EACZ,YAAY,GAAG,MAAM,EACrB,aAAa,EACb,QAAQ,EACR,IAAI,EACJ,IAAI,GACL,GAAG,KAAK,CAAC;IAEV,MAAM,CAAC,QAAQ,EAAE,WAAW,CAAC,GAAG,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;IACtD,MAAM,CAAC,SAAS,EAAE,YAAY,CAAC,GAAG,KAAK,CAAC,QAAQ,CAAgB,IAAI,CAAC,CAAC;IAEtE,KAAK,CAAC,SAAS,CAAC,GAAG,EAAE;QACnB,WAAW,CAAC,KAAK,CAAC,CAAC;QACnB,IAAI,SAAS,GAAkB,IAAI,CAAC;QAEpC,IAAI,OAAO,GAAG,KAAK,QAAQ,EAAE,CAAC;YAC5B,YAAY,CAAC,GAAG,CAAC,CAAC;QACpB,CAAC;aAAM,IAAI,GAAG,YAAY,IAAI,EAAE,CAAC;YAC/B,SAAS,GAAG,GAAG,CAAC,eAAe,CAAC,GAAG,CAAC,CAAC;YACrC,YAAY,CAAC,SAAS,CAAC,CAAC;QAC1B,CAAC;aAAM,CAAC;YACN,YAAY,CAAC,IAAI,CAAC,CAAC;QACrB,CAAC;QAED,OAAO,GAAG,EAAE;YACV,IAAI,SAAS;gBAAE,GAAG,CAAC,eAAe,CAAC,SAAS,CAAC,CAAC;QAChD,CAAC,CAAC;IACJ,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAEV,MAAM,WAAW,GAAG,KAAK,CAAC,WAAW,CAAC,GAAG,EAAE;QACzC,WAAW,CAAC,IAAI,CAAC,CAAC;QAClB,OAAO,EAAE,EAAE,CAAC;IACd,CAAC,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC;IAEd,MAAM,aAAa,GAAwB,UAAU;QACnD,CAAC,CAAC,EAAE,YAAY,EAAE,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE;QAC7C,CAAC,CAAC,EAAE,CAAC;IAEP,MAAM,YAAY,GAAwB;QACxC,QAAQ,EAAE,UAAU;QACpB,KAAK,EAAE,MAAM;QACb,MAAM,EAAE,MAAM;QACd,GAAG,aAAa;KACjB,CAAC;IAEF,2BAA2B;IAC3B,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,OAAO,CACL,cAAK,SAAS,EAAE,SAAS,EAAE,KAAK,EAAE,YAAY,YAC5C,KAAC,aAAa,IAAC,UAAU,EAAE,UAAU,GAAI,GACrC,CACP,CAAC;IACJ,CAAC;IAED,0BAA0B;IAC1B,IAAI,QAAQ,EAAE,CAAC;QACb,OAAO,CACL,cAAK,SAAS,EAAE,SAAS,EAAE,KAAK,EAAE,YAAY,YAC5C,KAAC,aAAa,IAAC,UAAU,EAAE,UAAU,GAAI,GACrC,CACP,CAAC;IACJ,CAAC;IAED,MAAM,CAAC,GAAG,SAAS,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,GAAG,EAAE,SAAS,EAAE,CAAC,CAAC;IAE1D,IAAI,CAAC,KAAK,OAAO,EAAE,CAAC;QAClB,OAAO,CACL,cAAK,SAAS,EAAE,SAAS,EAAE,KAAK,EAAE,YAAY,YAC5C,KAAC,WAAW,IACV,GAAG,EAAE,SAAS,EACd,GAAG,EAAE,GAAG,EACR,IAAI,EAAE,IAAI,EACV,QAAQ,EAAE,QAAQ,EAClB,QAAQ,EAAE,QAAQ,EAClB,YAAY,EAAE,YAAY,EAC1B,UAAU,EAAE,UAAU,EACtB,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,WAAW,EACpB,QAAQ,EAAE,KAAC,aAAa,IAAC,UAAU,EAAE,UAAU,GAAI,GACnD,GACE,CACP,CAAC;IACJ,CAAC;IAED,IAAI,CAAC,KAAK,OAAO,EAAE,CAAC;QAClB,OAAO,CACL,cAAK,SAAS,EAAE,SAAS,EAAE,KAAK,EAAE,YAAY,YAC5C,KAAC,WAAW,IACV,GAAG,EAAE,SAAS,EACd,IAAI,EAAE,IAAI,EACV,QAAQ,EAAE,QAAQ,EAClB,QAAQ,EAAE,QAAQ,EAClB,YAAY,EAAE,YAAY,EAC1B,QAAQ,EAAE,QAAQ,EAClB,QAAQ,EAAE,QAAQ,EAClB,KAAK,EAAE,KAAK,EACZ,IAAI,EAAE,IAAI,EACV,SAAS,EAAE,SAAS,EACpB,OAAO,EAAE,OAAO,EAChB,iBAAiB,EAAE,iBAAiB,EACpC,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,WAAW,GACpB,GACE,CACP,CAAC;IACJ,CAAC;IAED,IAAI,CAAC,KAAK,OAAO,EAAE,CAAC;QAClB,OAAO,CACL,cAAK,SAAS,EAAE,SAAS,EAAE,KAAK,EAAE,YAAY,YAC5C,KAAC,WAAW,IACV,GAAG,EAAE,SAAS,EACd,IAAI,EAAE,IAAI,EACV,QAAQ,EAAE,QAAQ,EAClB,QAAQ,EAAE,QAAQ,EAClB,QAAQ,EAAE,QAAQ,EAClB,QAAQ,EAAE,QAAQ,EAClB,IAAI,EAAE,IAAI,EACV,OAAO,EAAE,OAAO,EAChB,MAAM,EAAE,MAAM,EACd,YAAY,EAAE,YAAY,EAC1B,OAAO,EAAE,WAAW,GACpB,GACE,CACP,CAAC;IACJ,CAAC;IAED,gCAAgC;IAChC,OAAO,kBAAkB,CAAC,YAA4B,CAAC,CAAC,CAAC,CAAC,CACxD,cAAK,SAAS,EAAE,SAAS,EAAE,KAAK,EAAE,YAAY,YAC5C,KAAC,iBAAiB,IAAC,GAAG,EAAE,SAAS,EAAE,QAAQ,EAAE,QAAQ,EAAE,KAAK,EAAE,aAAa,IAAI,UAAU,GAAI,GACzF,CACP,CAAC,CAAC,CAAC,IAAI,CAAC;AACX,CAAC;AAED,wBAAwB;AACxB,MAAM,CAAC,MAAM,YAAY,GAAG,WAAW,CAAC"}
+{"version":3,"file":"media-viewer.js","sourceRoot":"","sources":["../../src/react/media-viewer.tsx"],"names":[],"mappings":"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"}

package/dist/react/use-media-recovery.d.ts

@@ -0,0 +1,42 @@
+import type { MediaDiagnosticAdapter, RecoveryState, AssetStatusHint } from "../recovery.js";
+export interface UseMediaRecoveryOptions {
+    /** The URL of the media element. Recovery is skipped when falsy. */
+    url: string | null | undefined;
+    /** Injected diagnostic adapter from the app. */
+    adapter?: MediaDiagnosticAdapter;
+    /**
+     * Optional app hint about the server-side lifecycle of the asset.
+     * When "failed" or "rejected" the element error is treated as hard.
+     * When "processing" or "finalizing" a loading skeleton/spinner is shown
+     * without triggering the recovery probe.
+     */
+    statusHint?: AssetStatusHint;
+    /**
+     * Called when the recovery state machine wants to remount/reload the
+     * media element. The parent should increment a remount key or equivalent
+     * so the element re-attempts loading from scratch.
+     */
+    onRemount?: () => void;
+}
+export interface UseMediaRecoveryResult {
+    /** Current recovery phase. */
+    recoveryState: RecoveryState;
+    /**
+     * Call this when the underlying media element fires an error event.
+     * If no adapter is provided, or statusHint is "failed"/"rejected", the
+     * error is treated as hard immediately.
+     */
+    onMediaError: () => void;
+    /**
+     * Call this when the underlying media element fires its successful
+     * load/decode event (onLoad / onLoadedData / onCanPlay).
+     */
+    onMediaLoad: () => void;
+    /**
+     * Manual retry: resets the state machine back to loading and triggers a
+     * fresh remount. Usable from a "Retry" button in max-wait-fallback state.
+     */
+    manualRetry: () => void;
+}
+export declare function useMediaRecovery({ url, adapter, statusHint, onRemount, }: UseMediaRecoveryOptions): UseMediaRecoveryResult;
+//# sourceMappingURL=use-media-recovery.d.ts.map

package/dist/react/use-media-recovery.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-media-recovery.d.ts","sourceRoot":"","sources":["../../src/react/use-media-recovery.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,sBAAsB,EACtB,aAAa,EACb,eAAe,EAChB,MAAM,gBAAgB,CAAC;AA+CxB,MAAM,WAAW,uBAAuB;IACtC,oEAAoE;IACpE,GAAG,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;IAE/B,gDAAgD;IAChD,OAAO,CAAC,EAAE,sBAAsB,CAAC;IAEjC;;;;;OAKG;IACH,UAAU,CAAC,EAAE,eAAe,CAAC;IAE7B;;;;OAIG;IACH,SAAS,CAAC,EAAE,MAAM,IAAI,CAAC;CACxB;AAED,MAAM,WAAW,sBAAsB;IACrC,8BAA8B;IAC9B,aAAa,EAAE,aAAa,CAAC;IAE7B;;;;OAIG;IACH,YAAY,EAAE,MAAM,IAAI,CAAC;IAEzB;;;OAGG;IACH,WAAW,EAAE,MAAM,IAAI,CAAC;IAExB;;;OAGG;IACH,WAAW,EAAE,MAAM,IAAI,CAAC;CACzB;AAOD,wBAAgB,gBAAgB,CAAC,EAC/B,GAAG,EACH,OAAO,EACP,UAAU,EACV,SAAS,GACV,EAAE,uBAAuB,GAAG,sBAAsB,CAmUlD"}

package/dist/react/use-media-recovery.js

@@ -0,0 +1,319 @@
+"use client";
+import * as React from "react";
+import { backoffForAttempt, withinBudget, } from "../recovery.js";
+const activeRecoveries = new Map();
+/** Returns true if this is the leader (first registrant for the URL). */
+function registerForUrl(url, fn) {
+    const existing = activeRecoveries.get(url);
+    if (existing) {
+        existing.add(fn);
+        return false;
+    }
+    const s = new Set();
+    s.add(fn);
+    activeRecoveries.set(url, s);
+    return true;
+}
+function unregisterFromUrl(url, fn) {
+    const s = activeRecoveries.get(url);
+    if (!s)
+        return;
+    s.delete(fn);
+    if (s.size === 0)
+        activeRecoveries.delete(url);
+}
+function broadcastForUrl(url, state) {
+    const s = activeRecoveries.get(url);
+    if (!s)
+        return;
+    for (const fn of s)
+        fn(state);
+}
+function isDocumentVisible() {
+    if (typeof document === "undefined")
+        return true;
+    return document.visibilityState !== "hidden";
+}
+export function useMediaRecovery({ url, adapter, statusHint, onRemount, }) {
+    const [recoveryState, setRecoveryState] = React.useState({
+        phase: "idle",
+    });
+    // Element viewport visibility
+    const [isElementVisible, setIsElementVisible] = React.useState(true);
+    // Document visibility
+    const [isDocVisible, setIsDocVisible] = React.useState(isDocumentVisible());
+    // Stable ref for the registered broadcast function — stays constant for the
+    // lifetime of this hook instance so unregister always matches the register.
+    const broadcastFnRef = React.useRef((state) => setRecoveryState(state));
+    // Stable refs for mutable values used in closures
+    const adapterRef = React.useRef(adapter);
+    adapterRef.current = adapter;
+    const onRemountRef = React.useRef(onRemount);
+    onRemountRef.current = onRemount;
+    const statusHintRef = React.useRef(statusHint);
+    statusHintRef.current = statusHint;
+    // Retry timer
+    const retryTimerRef = React.useRef(null);
+    // Recovery cycle bookkeeping
+    const firstFailureAtRef = React.useRef(null);
+    const authRefreshedRef = React.useRef(false);
+    const attemptRef = React.useRef(0);
+    const isLeaderRef = React.useRef(false);
+    const isRegisteredRef = React.useRef(false);
+    const stableUrl = url ?? null;
+    // -------------------------------------------------------------------------
+    // Document visibility
+    // -------------------------------------------------------------------------
+    React.useEffect(() => {
+        if (typeof document === "undefined")
+            return;
+        const handler = () => setIsDocVisible(document.visibilityState !== "hidden");
+        document.addEventListener("visibilitychange", handler);
+        return () => document.removeEventListener("visibilitychange", handler);
+    }, []);
+    // -------------------------------------------------------------------------
+    // IntersectionObserver for element visibility (container-agnostic)
+    // Uses the mounted DOM node of the component; we observe document.body
+    // as a fallback for tests that don't wire a ref.
+    // -------------------------------------------------------------------------
+    React.useEffect(() => {
+        if (typeof IntersectionObserver === "undefined")
+            return;
+        const target = document.body;
+        const io = new IntersectionObserver(([e]) => setIsElementVisible(e?.isIntersecting ?? true), { threshold: 0.01 });
+        io.observe(target);
+        return () => io.disconnect();
+    }, []);
+    // -------------------------------------------------------------------------
+    // Cleanup on URL change or unmount
+    // -------------------------------------------------------------------------
+    React.useEffect(() => {
+        // Reset when URL changes
+        if (retryTimerRef.current !== null) {
+            clearTimeout(retryTimerRef.current);
+            retryTimerRef.current = null;
+        }
+        firstFailureAtRef.current = null;
+        authRefreshedRef.current = false;
+        attemptRef.current = 0;
+        setRecoveryState({ phase: "idle" });
+        // broadcastFnRef.current is a stable ref (created once, never reassigned),
+        // so capture it for the cleanup closure rather than reading the ref there
+        // (react-hooks/exhaustive-deps flags ref reads in cleanup).
+        const broadcastFn = broadcastFnRef.current;
+        return () => {
+            // Unregister from dedup on unmount or URL change
+            if (stableUrl && isRegisteredRef.current) {
+                unregisterFromUrl(stableUrl, broadcastFn);
+                isRegisteredRef.current = false;
+                isLeaderRef.current = false;
+            }
+            if (retryTimerRef.current !== null) {
+                clearTimeout(retryTimerRef.current);
+                retryTimerRef.current = null;
+            }
+        };
+    }, [stableUrl]);
+    // -------------------------------------------------------------------------
+    // Resume paused retries when visibility restores
+    // -------------------------------------------------------------------------
+    React.useEffect(() => {
+        if (!isElementVisible || !isDocVisible)
+            return;
+        if (recoveryState.phase !== "transient-retry")
+            return;
+        if (retryTimerRef.current !== null)
+            return; // timer already running
+        // Timer was cleared due to hidden state — reschedule.
+        const remaining = Math.max(0, recoveryState.nextRetryMs);
+        retryTimerRef.current = setTimeout(() => {
+            retryTimerRef.current = null;
+            onRemountRef.current?.();
+        }, remaining);
+    }, [isElementVisible, isDocVisible, recoveryState]);
+    // -------------------------------------------------------------------------
+    // Visibility snapshot ref (kept current so timer callbacks read fresh values)
+    // -------------------------------------------------------------------------
+    const visibilityRef = React.useRef({ isElementVisible, isDocVisible });
+    visibilityRef.current = { isElementVisible, isDocVisible };
+    // -------------------------------------------------------------------------
+    // Core recovery probe + state advance
+    // -------------------------------------------------------------------------
+    const runRecovery = React.useCallback(async (attempt) => {
+        if (!stableUrl)
+            return;
+        const currentAdapter = adapterRef.current;
+        const hint = statusHintRef.current;
+        let diagnosis;
+        if (!currentAdapter?.probe) {
+            // No probe: treat as transient for bounded retry purposes
+            diagnosis = { kind: "transient" };
+        }
+        else {
+            try {
+                diagnosis = await currentAdapter.probe(stableUrl);
+            }
+            catch {
+                diagnosis = { kind: "transient" };
+            }
+        }
+        if (diagnosis.kind === "hard") {
+            const hardState = { phase: "hard-unavailable" };
+            setRecoveryState(hardState);
+            broadcastForUrl(stableUrl, hardState);
+            return;
+        }
+        if (diagnosis.kind === "auth") {
+            if (!authRefreshedRef.current) {
+                authRefreshedRef.current = true;
+                const authState = { phase: "auth-retry" };
+                setRecoveryState(authState);
+                broadcastForUrl(stableUrl, authState);
+                try {
+                    if (hint !== "failed" && hint !== "rejected") {
+                        await currentAdapter?.refreshSession?.();
+                        await currentAdapter?.refreshGrant?.(stableUrl);
+                    }
+                }
+                catch {
+                    // swallow — fall through to remount
+                }
+                onRemountRef.current?.();
+                return;
+            }
+            // Already refreshed once → hard auth failure
+            const hardAuthState = {
+                phase: "hard-unavailable",
+                reason: "auth",
+            };
+            setRecoveryState(hardAuthState);
+            broadcastForUrl(stableUrl, hardAuthState);
+            return;
+        }
+        // Transient: schedule next retry with backoff
+        const nextDelay = backoffForAttempt(attempt);
+        const nextRetryAt = Date.now() + nextDelay;
+        if (firstFailureAtRef.current !== null &&
+            !withinBudget(firstFailureAtRef.current, nextRetryAt)) {
+            const fallbackState = { phase: "max-wait-fallback" };
+            setRecoveryState(fallbackState);
+            broadcastForUrl(stableUrl, fallbackState);
+            return;
+        }
+        const retryState = {
+            phase: "transient-retry",
+            attempt,
+            nextRetryMs: nextDelay,
+        };
+        setRecoveryState(retryState);
+        broadcastForUrl(stableUrl, retryState);
+        // Schedule remount — cancel if hidden at fire time
+        retryTimerRef.current = setTimeout(() => {
+            retryTimerRef.current = null;
+            const { isElementVisible: elVis, isDocVisible: docVis } = visibilityRef.current;
+            if (!elVis || !docVis) {
+                // Leave state as transient-retry; visibility effect will reschedule.
+                return;
+            }
+            onRemountRef.current?.();
+        }, nextDelay);
+    }, [stableUrl]);
+    // -------------------------------------------------------------------------
+    // Public: onMediaError
+    // -------------------------------------------------------------------------
+    const onMediaError = React.useCallback(() => {
+        if (!stableUrl)
+            return;
+        const hint = statusHintRef.current;
+        // Terminal app-hint states — no probe, immediate hard error
+        if (hint === "failed" || hint === "rejected") {
+            const s = { phase: "hard-unavailable", reason: hint };
+            setRecoveryState(s);
+            broadcastForUrl(stableUrl, s);
+            return;
+        }
+        // Processing/finalizing hints — show phase overlay, no probe
+        if (hint === "processing") {
+            const s = { phase: "processing" };
+            setRecoveryState(s);
+            broadcastForUrl(stableUrl, s);
+            return;
+        }
+        if (hint === "finalizing") {
+            const s = { phase: "finalizing" };
+            setRecoveryState(s);
+            broadcastForUrl(stableUrl, s);
+            return;
+        }
+        // Record first failure time
+        if (firstFailureAtRef.current === null) {
+            firstFailureAtRef.current = Date.now();
+        }
+        const attempt = attemptRef.current;
+        attemptRef.current += 1;
+        // Dedup registration
+        if (!isRegisteredRef.current) {
+            isLeaderRef.current = registerForUrl(stableUrl, broadcastFnRef.current);
+            isRegisteredRef.current = true;
+        }
+        // Only the leader drives recovery probes
+        if (!isLeaderRef.current) {
+            return;
+        }
+        void runRecovery(attempt);
+    }, [stableUrl, runRecovery]);
+    // -------------------------------------------------------------------------
+    // Public: onMediaLoad
+    // -------------------------------------------------------------------------
+    const onMediaLoad = React.useCallback(() => {
+        if (retryTimerRef.current !== null) {
+            clearTimeout(retryTimerRef.current);
+            retryTimerRef.current = null;
+        }
+        if (stableUrl && isRegisteredRef.current) {
+            unregisterFromUrl(stableUrl, broadcastFnRef.current);
+            isRegisteredRef.current = false;
+            isLeaderRef.current = false;
+        }
+        firstFailureAtRef.current = null;
+        authRefreshedRef.current = false;
+        attemptRef.current = 0;
+        const loadedState = { phase: "loaded" };
+        setRecoveryState(loadedState);
+        if (stableUrl)
+            broadcastForUrl(stableUrl, loadedState);
+    }, [stableUrl]);
+    // -------------------------------------------------------------------------
+    // Public: manualRetry
+    // -------------------------------------------------------------------------
+    const manualRetry = React.useCallback(() => {
+        if (!stableUrl)
+            return;
+        if (retryTimerRef.current !== null) {
+            clearTimeout(retryTimerRef.current);
+            retryTimerRef.current = null;
+        }
+        // Reset cycle
+        firstFailureAtRef.current = null;
+        authRefreshedRef.current = false;
+        attemptRef.current = 0;
+        // Re-establish as leader
+        if (isRegisteredRef.current) {
+            unregisterFromUrl(stableUrl, broadcastFnRef.current);
+            isRegisteredRef.current = false;
+        }
+        isLeaderRef.current = registerForUrl(stableUrl, broadcastFnRef.current);
+        isRegisteredRef.current = true;
+        const loadingState = { phase: "loading" };
+        setRecoveryState(loadingState);
+        broadcastForUrl(stableUrl, loadingState);
+        onRemountRef.current?.();
+    }, [stableUrl]);
+    return {
+        recoveryState,
+        onMediaError,
+        onMediaLoad,
+        manualRetry,
+    };
+}
+//# sourceMappingURL=use-media-recovery.js.map

package/dist/react/use-media-recovery.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-media-recovery.js","sourceRoot":"","sources":["../../src/react/use-media-recovery.ts"],"names":[],"mappings":"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"}

package/dist/recovery.d.ts

@@ -0,0 +1,94 @@
+/**
+ * Generic bounded media-recovery state machine.
+ *
+ * Owns: backoff schedule, state transition logic, dedup key shape.
+ * Does NOT own: probe implementation, session/grant refresh, telemetry.
+ * Those are injected via MediaDiagnosticAdapter.
+ */
+/**
+ * Opaque diagnosis result returned by the app's probe(). The package treats
+ * this value OPAQUELY — it only checks the `kind` discriminant; all
+ * domain-specific interpretation (x-ttt-deny, HTTP status codes, etc.) lives
+ * in the app adapter.
+ */
+export type DiagnosisResult = {
+    kind: "transient";
+} | {
+    kind: "auth";
+} | {
+    kind: "hard";
+};
+/**
+ * Optional hint from the app about the asset's known server-side lifecycle
+ * state. When provided it informs which recovery states are applicable.
+ * The package treats these opaquely — it does not interpret TTT-specific
+ * pendingMedia.publicationState fields directly.
+ */
+export type AssetStatusHint = "processing" | "finalizing" | "live" | "failed" | "rejected";
+/**
+ * Injected adapter interface. The TTT app implements this; generic consumers
+ * may supply a no-op or partial adapter.
+ *
+ * Every method is optional — callers guard before invoking.
+ */
+export interface MediaDiagnosticAdapter {
+    /**
+     * Issue a credentialed HEAD probe against the given URL and return a
+     * diagnosis. Should resolve quickly (e.g. 5 s timeout). Must never throw
+     * — return { kind: "transient" } on network errors.
+     */
+    probe?: (url: string) => Promise<DiagnosisResult>;
+    /**
+     * Attempt to refresh the media session (re-mint the HttpOnly cookie).
+     * Called at most once per auth-recovery cycle. Must never throw.
+     */
+    refreshSession?: () => Promise<void>;
+    /**
+     * Attempt to refresh a scoped grant for the given URL.
+     * Called at most once per auth-recovery cycle. Must never throw.
+     */
+    refreshGrant?: (url: string) => Promise<void>;
+}
+export type RecoveryState = {
+    phase: "idle";
+} | {
+    phase: "loading";
+} | {
+    phase: "processing";
+} | {
+    phase: "finalizing";
+} | {
+    phase: "loaded";
+} | {
+    phase: "transient-retry";
+    attempt: number;
+    nextRetryMs: number;
+} | {
+    phase: "propagating";
+} | {
+    phase: "auth-retry";
+} | {
+    phase: "hard-unavailable";
+    reason?: string;
+} | {
+    phase: "max-wait-fallback";
+};
+export declare const BACKOFF_SCHEDULE_MS: readonly [2000, 5000, 10000, 20000, 30000, 30000];
+/** Maximum total time from first failure before giving up, in ms. */
+export declare const MAX_RECOVERY_DURATION_MS = 120000;
+/**
+ * Apply ±20% jitter to a backoff delay. Deterministic seed not required —
+ * slight randomness prevents thundering herds across many assets.
+ */
+export declare function applyJitter(delayMs: number): number;
+/**
+ * Return the backoff delay for a given attempt index (0-based).
+ * Clamps to the last schedule entry beyond the end.
+ */
+export declare function backoffForAttempt(attempt: number): number;
+/**
+ * True when the total elapsed time since first failure would still be within
+ * the MAX_RECOVERY_DURATION_MS budget after the next retry.
+ */
+export declare function withinBudget(firstFailureAt: number, nextRetryAt: number): boolean;
+//# sourceMappingURL=recovery.d.ts.map

package/dist/recovery.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"recovery.d.ts","sourceRoot":"","sources":["../src/recovery.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAMH;;;;;GAKG;AACH,MAAM,MAAM,eAAe,GACvB;IAAE,IAAI,EAAE,WAAW,CAAA;CAAE,GACrB;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,GAChB;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC;AAErB;;;;;GAKG;AACH,MAAM,MAAM,eAAe,GACvB,YAAY,GACZ,YAAY,GACZ,MAAM,GACN,QAAQ,GACR,UAAU,CAAC;AAEf;;;;;GAKG;AACH,MAAM,WAAW,sBAAsB;IACrC;;;;OAIG;IACH,KAAK,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,eAAe,CAAC,CAAC;IAElD;;;OAGG;IACH,cAAc,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAErC;;;OAGG;IACH,YAAY,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CAC/C;AAMD,MAAM,MAAM,aAAa,GACrB;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,GACjB;IAAE,KAAK,EAAE,SAAS,CAAA;CAAE,GACpB;IAAE,KAAK,EAAE,YAAY,CAAA;CAAE,GACvB;IAAE,KAAK,EAAE,YAAY,CAAA;CAAE,GACvB;IAAE,KAAK,EAAE,QAAQ,CAAA;CAAE,GACnB;IAAE,KAAK,EAAE,iBAAiB,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,GAClE;IAAE,KAAK,EAAE,aAAa,CAAA;CAAE,GACxB;IAAE,KAAK,EAAE,YAAY,CAAA;CAAE,GACvB;IAAE,KAAK,EAAE,kBAAkB,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,GAC9C;IAAE,KAAK,EAAE,mBAAmB,CAAA;CAAE,CAAC;AAGnC,eAAO,MAAM,mBAAmB,mDAAoD,CAAC;AAErF,qEAAqE;AACrE,eAAO,MAAM,wBAAwB,SAAU,CAAC;AAKhD;;;GAGG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAGnD;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAGzD;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,cAAc,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAEjF"}

package/dist/recovery.js

@@ -0,0 +1,37 @@
+/**
+ * Generic bounded media-recovery state machine.
+ *
+ * Owns: backoff schedule, state transition logic, dedup key shape.
+ * Does NOT own: probe implementation, session/grant refresh, telemetry.
+ * Those are injected via MediaDiagnosticAdapter.
+ */
+// Backoff schedule in ms: 2s → 5s → 10s → 20s → 30s → 30s (then cap at 30s)
+export const BACKOFF_SCHEDULE_MS = [2000, 5000, 10000, 20000, 30000, 30000];
+/** Maximum total time from first failure before giving up, in ms. */
+export const MAX_RECOVERY_DURATION_MS = 120_000;
+/** Jitter factor (±20%). */
+const JITTER_FACTOR = 0.2;
+/**
+ * Apply ±20% jitter to a backoff delay. Deterministic seed not required —
+ * slight randomness prevents thundering herds across many assets.
+ */
+export function applyJitter(delayMs) {
+    const delta = delayMs * JITTER_FACTOR;
+    return Math.round(delayMs - delta + Math.random() * delta * 2);
+}
+/**
+ * Return the backoff delay for a given attempt index (0-based).
+ * Clamps to the last schedule entry beyond the end.
+ */
+export function backoffForAttempt(attempt) {
+    const raw = BACKOFF_SCHEDULE_MS[Math.min(attempt, BACKOFF_SCHEDULE_MS.length - 1)];
+    return applyJitter(raw);
+}
+/**
+ * True when the total elapsed time since first failure would still be within
+ * the MAX_RECOVERY_DURATION_MS budget after the next retry.
+ */
+export function withinBudget(firstFailureAt, nextRetryAt) {
+    return nextRetryAt - firstFailureAt <= MAX_RECOVERY_DURATION_MS;
+}
+//# sourceMappingURL=recovery.js.map

package/dist/recovery.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"recovery.js","sourceRoot":"","sources":["../src/recovery.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAyEH,4EAA4E;AAC5E,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,CAAU,CAAC;AAErF,qEAAqE;AACrE,MAAM,CAAC,MAAM,wBAAwB,GAAG,OAAO,CAAC;AAEhD,4BAA4B;AAC5B,MAAM,aAAa,GAAG,GAAG,CAAC;AAE1B;;;GAGG;AACH,MAAM,UAAU,WAAW,CAAC,OAAe;IACzC,MAAM,KAAK,GAAG,OAAO,GAAG,aAAa,CAAC;IACtC,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,GAAG,KAAK,GAAG,IAAI,CAAC,MAAM,EAAE,GAAG,KAAK,GAAG,CAAC,CAAC,CAAC;AACjE,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,iBAAiB,CAAC,OAAe;IAC/C,MAAM,GAAG,GAAG,mBAAmB,CAAC,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,mBAAmB,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC;IACnF,OAAO,WAAW,CAAC,GAAG,CAAC,CAAC;AAC1B,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,YAAY,CAAC,cAAsB,EAAE,WAAmB;IACtE,OAAO,WAAW,GAAG,cAAc,IAAI,wBAAwB,CAAC;AAClE,CAAC"}

package/dist/types.d.ts

@@ -1,4 +1,6 @@
 import type * as React from "react";
+import type { MediaDiagnosticAdapter, AssetStatusHint } from "./recovery.js";
+export type { MediaDiagnosticAdapter, AssetStatusHint, DiagnosisResult, RecoveryState } from "./recovery.js";
 export type MediaViewerType = "image" | "video" | "audio" | "other";
 export type FallbackMode = "none" | "link";
 export type BaseMediaProps = {
@@ -62,6 +64,18 @@ export type MediaPreviewProps = {
     filename?: string;
     mime?: string;
     name?: string;
+    /**
+     * Injected diagnostic adapter. When provided, element load errors for
+     * assets the app believes are live will trigger the bounded recovery state
+     * machine. When omitted, the existing error fallback behavior is unchanged.
+     */
+    recoveryAdapter?: MediaDiagnosticAdapter;
+    /**
+     * Optional app hint about the server-side lifecycle state of the asset.
+     * Drives which recovery phase is shown (e.g. processing → skeleton,
+     * finalizing → spinner, failed/rejected → hard error immediately).
+     */
+    assetStatusHint?: AssetStatusHint;
 };
 /** Back-compat alias */
 export type MediaViewerProps = MediaPreviewProps;

package/dist/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ttt-productions/media-viewer",
-  "version": "0.8.0",
+  "version": "0.8.1",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/ttt-productions/ttt-packages.git",
@@ -33,7 +33,7 @@
     "prepublishOnly": "npm run clean && npm run build"
   },
   "dependencies": {
-    "@ttt-productions/media-schemas": "^0.11.0",
+    "@ttt-productions/media-schemas": "^0.11.1",
     "@ttt-productions/ui-core": "^0.11.0"
   },
   "peerDependencies": {