@ai-matrx/capture 0.5.3 → 0.5.4

package/CHANGELOG.md

@@ -1,5 +1,10 @@
 # Changelog — @ai-matrx/capture
 
+## 0.5.4 — 2026-09-01
+
+- Persisted-media editing now has an explicit fresh-byte port (`resolveEditBlob`). The package creates and owns an editor-private object URL instead of reusing a viewer URL that the host byte cache may evict and revoke while the decoded viewer frame remains visible.
+- Both camera chromes revoke the editor-private URL on every close/save/unmount path and surface a visible retry remedy when byte preparation fails. Exact fail-first coverage reproduces a stale viewer URL and proves the editor consumes fresh bytes.
+
 ## 0.5.3 — 2026-09-01
 
 - `ImageEditSheet` now keeps Save, crop presets, rotate, and flip unavailable while a newly baked bitmap is decoding, then enables them from the image's real `load` event. A transformed image can no longer hit the zero-dimension silent-return race and leave the editor stuck with no persistence or error.

package/dist/react.cjs

@@ -727,6 +727,16 @@ function invalidateMedia(key) {
   if (entry?.revoke && entry.url) URL.revokeObjectURL(entry.url);
   notify(key);
 }
+async function prepareMediaForEdit(item) {
+  if (item.resolveEditBlob) {
+    const blob = await item.resolveEditBlob();
+    if (blob.size === 0) throw new Error("media snapshot was empty");
+    return { url: URL.createObjectURL(blob), revoke: true };
+  }
+  const url = item.src ?? getMediaUrl(item);
+  if (!url) throw new Error("media item has no editable source");
+  return { url, revoke: false };
+}
 function useMediaUrl(item) {
   const [, bump] = (0, import_react2.useState)(0);
   const key = item?.key ?? null;
@@ -1604,6 +1614,10 @@ function CameraCapture({
   const [optionsOpen, setOptionsOpen] = (0, import_react5.useState)(false);
   const [viewerKey, setViewerKey] = (0, import_react5.useState)(null);
   const [editTarget, setEditTarget] = (0, import_react5.useState)(null);
+  const [editPreparing, setEditPreparing] = (0, import_react5.useState)(false);
+  const [editPreparationError, setEditPreparationError] = (0, import_react5.useState)(
+    null
+  );
   const [gridOn, setGridOn] = (0, import_react5.useState)(false);
   const [timerSetting, setTimerSetting] = (0, import_react5.useState)(0);
   const [aspect, setAspect] = (0, import_react5.useState)("full");
@@ -1628,6 +1642,12 @@ function CameraCapture({
   (0, import_react5.useEffect)(() => {
     onReviewOpenChange?.(reviewOpen);
   }, [reviewOpen, onReviewOpenChange]);
+  (0, import_react5.useEffect)(
+    () => () => {
+      if (editTarget?.revoke) URL.revokeObjectURL(editTarget.url);
+    },
+    [editTarget]
+  );
   const clearCountdown = (0, import_react5.useCallback)(() => {
     if (countdownRef.current) clearInterval(countdownRef.current);
     countdownRef.current = null;
@@ -1941,8 +1961,16 @@ function CameraCapture({
           invalidateMedia(item.key);
         } : void 0,
         onEdit: media.onReplacePhoto ? (item) => {
-          const url = getMediaUrl(item);
-          if (url) setEditTarget({ key: item.key, url });
+          if (editPreparing) return;
+          setEditPreparing(true);
+          setEditPreparationError(null);
+          void prepareMediaForEdit(item).then(
+            (prepared) => setEditTarget({ key: item.key, ...prepared })
+          ).catch(
+            () => setEditPreparationError(
+              "This photo could not be prepared for editing. Try again."
+            )
+          ).finally(() => setEditPreparing(false));
         } : void 0
       }
     ),
@@ -1963,6 +1991,14 @@ function CameraCapture({
         }
       }
     ),
+    editPreparationError && /* @__PURE__ */ (0, import_jsx_runtime12.jsx)(
+      "p",
+      {
+        role: "alert",
+        className: "fixed inset-x-4 bottom-24 z-[70] rounded-xl bg-black/85 px-4 py-3 text-center text-sm text-[#FF6961]",
+        children: editPreparationError
+      }
+    ),
     slots.overlays
   ] });
 }
@@ -2261,7 +2297,9 @@ function CameraCaptureV3({
   slots = {}
 }) {
   const [viewerKey, setViewerKey] = (0, import_react8.useState)(null);
-  const [editTarget, setEditTarget] = (0, import_react8.useState)(
+  const [editTarget, setEditTarget] = (0, import_react8.useState)(null);
+  const [editPreparing, setEditPreparing] = (0, import_react8.useState)(false);
+  const [editPreparationError, setEditPreparationError] = (0, import_react8.useState)(
     null
   );
   const [gridOn, setGridOn] = (0, import_react8.useState)(false);
@@ -2275,6 +2313,12 @@ function CameraCaptureV3({
   (0, import_react8.useEffect)(() => {
     onReviewOpenChange?.(reviewOpen);
   }, [reviewOpen, onReviewOpenChange]);
+  (0, import_react8.useEffect)(
+    () => () => {
+      if (editTarget?.revoke) URL.revokeObjectURL(editTarget.url);
+    },
+    [editTarget]
+  );
   const clearCountdown = (0, import_react8.useCallback)(() => {
     if (countdownRef.current) clearInterval(countdownRef.current);
     countdownRef.current = null;
@@ -2493,8 +2537,16 @@ function CameraCaptureV3({
           invalidateMedia(item.key);
         } : void 0,
         onEdit: media.onReplacePhoto ? (item) => {
-          const url = getMediaUrl(item);
-          if (url) setEditTarget({ key: item.key, url });
+          if (editPreparing) return;
+          setEditPreparing(true);
+          setEditPreparationError(null);
+          void prepareMediaForEdit(item).then(
+            (prepared) => setEditTarget({ key: item.key, ...prepared })
+          ).catch(
+            () => setEditPreparationError(
+              "This photo could not be prepared for editing. Try again."
+            )
+          ).finally(() => setEditPreparing(false));
         } : void 0
       }
     ),
@@ -2515,6 +2567,14 @@ function CameraCaptureV3({
         }
       }
     ),
+    editPreparationError && /* @__PURE__ */ (0, import_jsx_runtime15.jsx)(
+      "p",
+      {
+        role: "alert",
+        className: "fixed inset-x-4 bottom-24 z-[70] rounded-xl bg-black/85 px-4 py-3 text-center text-sm text-[#FF6961]",
+        children: editPreparationError
+      }
+    ),
     slots.overlays
   ] });
 }