@ai-matrx/media 0.4.2 → 0.4.3

package/CHANGELOG.md

@@ -1,5 +1,22 @@
 # @ai-matrx/media
 
+## 0.4.3 — 2026-08-31
+
+### Consumer action (C28)
+
+- Upgrade. No API change; private SVG refs now render from the client's
+  authenticated blob lifecycle instead of binding a bearer-less download URL
+  directly to an image element.
+
+### Fixed
+
+- The built-in SVG viewer now resolves refs through `MediaClient.getBlob()`
+  and renders the lifecycle-owned object URL. This makes personal/private SVG
+  files render in ordinary image elements while retaining the existing source
+  view and avoiding any host-side viewer fork.
+- Blob sources remain client-free, and real byte-fetch errors are shown in the
+  viewer instead of being collapsed into a generic render failure.
+
 ## 0.4.2 — 2026-08-31
 
 ### Consumer action (C28)

package/dist/viewers.cjs

@@ -47,7 +47,7 @@ __export(viewers_exports, {
 module.exports = __toCommonJS(viewers_exports);
 
 // src/viewers/media-file-viewer.tsx
-var import_react12 = require("react");
+var import_react11 = require("react");
 
 // src/viewers/registry.ts
 var VIEWER_SLOT = /* @__PURE__ */ Symbol.for("ai-matrx.media.viewer-registry");
@@ -1433,105 +1433,6 @@ function HtmlSourceView({ source, maxBytes = 1024 * 1024 }) {
   return /* @__PURE__ */ (0, import_jsx_runtime8.jsx)("pre", { className: "h-full w-full overflow-auto bg-muted/10 p-4 font-mono text-xs leading-relaxed break-all whitespace-pre-wrap", children: text });
 }
 
-// src/core/use-media-load-recovery.ts
-var import_react11 = require("react");
-
-// src/types.ts
-function mintDurableSrc(url) {
-  return url;
-}
-
-// src/core/use-media-load-recovery.ts
-function normalizeOutcome(outcome) {
-  return typeof outcome === "string" ? { verdict: outcome } : outcome;
-}
-var EPHEMERAL_SECRET_IDENTITY = "server:files-session-secret";
-function useMediaLoadRecovery(src, options) {
-  const client = useMediaClient();
-  const capture = useMediaFailureCapture();
-  const recoverable = options?.recoverable !== false;
-  const onTerminal = options?.onTerminal;
-  const failureRef = options?.failureRef;
-  const [result, setResult] = (0, import_react11.useState)({ source: src, retryKey: 0, failed: false });
-  const attemptRef = (0, import_react11.useRef)(0);
-  const recoveryInFlightRef = (0, import_react11.useRef)(false);
-  (0, import_react11.useEffect)(() => {
-    attemptRef.current = 0;
-    recoveryInFlightRef.current = false;
-  }, [src]);
-  (0, import_react11.useLayoutEffect)(() => {
-    recoveryInFlightRef.current = false;
-  }, [result.retryKey]);
-  const identity = () => failureMediaIdentity(failureRef ?? null, src);
-  const onLoadError = (event) => {
-    if (recoveryInFlightRef.current) return;
-    if (!src || !recoverable) {
-      setResult({ source: src, retryKey: 0, failed: true });
-      if (src) {
-        capture({
-          phase: "element-load",
-          mediaRef: identity(),
-          terminal: true,
-          retryOutcome: "not-attempted",
-          message: "media element failed to load and the source is unrecoverable (foreign/object URL \u2014 a session refresh cannot fix it)"
-        });
-      }
-      onTerminal?.(event);
-      return;
-    }
-    recoveryInFlightRef.current = true;
-    attemptRef.current += 1;
-    const attempt = attemptRef.current;
-    client.recoverLoadError(mintDurableSrc(src), attempt).then(
-      (outcome) => {
-        const report = normalizeOutcome(outcome);
-        if (report.secretSource === "ephemeral") {
-          capture({
-            phase: "session",
-            mediaRef: EPHEMERAL_SECRET_IDENTITY,
-            terminal: false,
-            message: "server cookie secret is ephemeral \u2014 private renders will break across restarts/instances (set a persistent files-session secret on the server)"
-          });
-        }
-        if (report.verdict === "retry") {
-          setResult((current) => ({
-            source: src,
-            retryKey: current.source === src ? current.retryKey + 1 : 1,
-            failed: false
-          }));
-        } else {
-          setResult({ source: src, retryKey: 0, failed: true });
-          capture({
-            phase: attempt > 1 ? "element-load" : "recovery",
-            mediaRef: identity(),
-            terminal: true,
-            retryOutcome: attempt > 1 ? "retried" : "not-attempted",
-            message: attempt > 1 ? "media element failed to load after the session-refresh retry" : "media load recovery declined on the first attempt (session refresh did not produce a usable session)",
-            ...report.status !== void 0 ? { status: report.status } : {}
-          });
-          onTerminal?.(event);
-        }
-      },
-      (err) => {
-        setResult({ source: src, retryKey: 0, failed: true });
-        capture({
-          phase: "session",
-          mediaRef: identity(),
-          terminal: true,
-          retryOutcome: "recovery-failed",
-          message: `session recovery failed: ${err instanceof Error ? err.message : String(err ?? "unknown error")}`
-        });
-        onTerminal?.(event);
-      }
-    );
-  };
-  return {
-    retryKey: result.source === src ? result.retryKey : 0,
-    onLoadError,
-    failed: result.source === src ? result.failed : false
-  };
-}
-
 // src/viewers/transparency-grid.ts
 var TRANSPARENCY_GRID_STYLE = {
   backgroundImage: "linear-gradient(45deg, rgb(0 0 0 / 0.08) 25%, transparent 25%), linear-gradient(-45deg, rgb(0 0 0 / 0.08) 25%, transparent 25%), linear-gradient(45deg, transparent 75%, rgb(0 0 0 / 0.08) 75%), linear-gradient(-45deg, transparent 75%, rgb(0 0 0 / 0.08) 75%)",
@@ -1566,30 +1467,21 @@ function SvgViewer(props) {
   );
 }
 function SvgRenderedView({ source, fileName }) {
-  const { url, recoverable, unavailable } = useViewerDisplayUrl(source);
-  const { retryKey, onLoadError, failed } = useMediaLoadRecovery(url, {
-    recoverable,
-    ...source.kind === "ref" ? { failureRef: source.ref } : {}
-  });
-  if (unavailable) {
-    return /* @__PURE__ */ (0, import_jsx_runtime9.jsx)(
-      ViewerError,
-      {
-        title: "This SVG isn't available",
-        hint: "You may not have access to it, or it may have been deleted."
-      }
-    );
-  }
-  if (!url) return /* @__PURE__ */ (0, import_jsx_runtime9.jsx)(ViewerSkeleton, { className: "flex-1" });
-  if (failed) {
+  const fromClient = useMediaBlob(source.kind === "ref" ? source.ref : null);
+  const url = source.kind === "blob" ? source.url : fromClient.url;
+  const loading = source.kind === "ref" && fromClient.loading;
+  const error = source.kind === "ref" ? fromClient.error : null;
+  if (error) {
     return /* @__PURE__ */ (0, import_jsx_runtime9.jsx)(
       ViewerError,
       {
         title: "SVG could not be rendered",
+        message: error,
         hint: "Switch to the Source view to inspect the markup."
       }
     );
   }
+  if (loading || !url) return /* @__PURE__ */ (0, import_jsx_runtime9.jsx)(ViewerSkeleton, { className: "flex-1" });
   return /* @__PURE__ */ (0, import_jsx_runtime9.jsx)(
     "div",
     {
@@ -1600,10 +1492,8 @@ function SvgRenderedView({ source, fileName }) {
         {
           src: url,
           alt: fileName,
-          className: "max-h-full max-w-full object-contain drop-shadow-sm",
-          onError: onLoadError
-        },
-        retryKey
+          className: "max-h-full max-w-full object-contain drop-shadow-sm"
+        }
       )
     }
   );
@@ -1757,7 +1647,7 @@ function MediaFileViewer({
 }) {
   const kind = previewKind ?? getPreviewKind(props.fileName, props.mimeType ?? null);
   const viewer = getMediaViewer(kind) ?? BUILT_IN[kind];
-  if (viewer) return (0, import_react12.createElement)(viewer, props);
+  if (viewer) return (0, import_react11.createElement)(viewer, props);
   return /* @__PURE__ */ (0, import_jsx_runtime12.jsx)(MediaViewerUnavailable, { ...props, kind });
 }
 //# sourceMappingURL=viewers.cjs.map