@snowcone-app/ui 0.9.4 → 0.9.5

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@snowcone-app/ui",
-  "version": "0.9.4",
+  "version": "0.9.5",
   "description": "React components for merchandise visualization and customization",
   "keywords": [
     "react",

package/src/patterns/RealtimeProvider.tsx

@@ -62,6 +62,9 @@ const DEFAULT_ARTBOARD_SIZE = 2000;
 // Enforce a conservative cap to prevent memory crashes
 const MAX_CONCURRENT_BLOBS = 5;
 
+/** How long a frame whose blob: URL was revoked waits for its newer frame before counting as a real failure. */
+const FRAME_SUPERSEDE_GRACE_MS = 2000;
+
 /** `current` in order, then any of `extra` not already in it. */
 function mergeMockupIds(current: readonly string[], extra: readonly string[]): string[] {
   const out = [...current];
@@ -943,6 +946,32 @@ export function RealtimeProvider({
         ) {
           return;
         }
+        // The FRAME (not the background) failed to load from a revoked blob:
+        // URL. The SDK revokes a mockup's frame only when that mockup's next
+        // frame arrives, so the newer frame exists even if React state hasn't
+        // delivered it here yet (prod 2026-11-11, phone: this race switched
+        // cropped delivery off for the whole session). Wait for it; if none
+        // shows up, it really failed.
+        const message = err instanceof Error ? err.message : String(err);
+        if (
+          result.imageUrl.startsWith("blob:") &&
+          message.startsWith("E_OVERLAY_FRAME_LOAD") &&
+          message.includes(result.imageUrl.slice(0, 160))
+        ) {
+          const failedUrl = result.imageUrl;
+          setTimeout(() => {
+            if (gen !== sceneGenRef.current) return;
+            if (compositeQueueRef.current.has(result.mockupId)) return;
+            if (processedFrameRef.current.get(result.mockupId) !== failedUrl) return;
+            console.error(
+              `[RealtimeProvider] E_OVERLAY_COMPOSITE_FAILED: frame for ${result.mockupId} failed to load and no newer frame arrived within ${FRAME_SUPERSEDE_GRACE_MS} ms — full-frame delivery for the rest of this session.`,
+              err
+            );
+            cropCapableRef.current = false;
+            rerenderFullFrame(result.mockupId);
+          }, FRAME_SUPERSEDE_GRACE_MS);
+          return;
+        }
         console.error(
           "[RealtimeProvider] E_OVERLAY_COMPOSITE_FAILED: cropped-frame composite failed — full-frame delivery for the rest of this session.",
           err

package/src/patterns/__tests__/RealtimeProvider.cropDelivery.test.tsx

@@ -412,5 +412,46 @@ describe("RealtimeProvider cropped delivery", () => {
     expect(h.rerender).not.toHaveBeenCalled();
     errSpy.mockRestore();
   });
+
+  it("a frame whose blob: URL was revoked waits for its newer frame instead of switching the session to full frames (prod, phone, 2026-11-11)", async () => {
+    const { rerender } = render(<Harness version={1} />);
+    await waitFor(() => expect(h.sendConfig).toHaveBeenCalled());
+    await seedAndFlip(rerender);
+    h.sendConfig.mockClear();
+    const errSpy = vi.spyOn(console, "error").mockImplementation(() => {});
+
+    // v3's frame was revoked by the SDK (its v4 already arrived there) before React state delivered v4 here.
+    h.compositeCroppedFrame.mockImplementationOnce(() =>
+      Promise.reject(new Error("E_OVERLAY_FRAME_LOAD: image failed to load: blob:v3-m1"))
+    );
+    h.state.results = [croppedResult("m1", "blob:v3-m1"), fullResult("m2", "https://r/m2-full")];
+    await act(async () => rerender(<Harness version={4} />));
+    // v4 lands within the grace window and composites.
+    h.state.results = [croppedResult("m1", "blob:v4-m1"), fullResult("m2", "https://r/m2-full")];
+    await act(async () => rerender(<Harness version={5} />));
+    await act(async () => { await new Promise((r) => setTimeout(r, 2300)); });
+    expect(h.compositeCroppedFrame).toHaveBeenLastCalledWith(expect.objectContaining({ frameUrl: "blob:v4-m1" }));
+    expect(h.sendConfig).not.toHaveBeenCalled(); // cropped delivery stays on, nothing re-rendered
+    errSpy.mockRestore();
+  });
+
+  it("a revoked frame with no newer frame within the grace window is a real failure: full-frame re-render", async () => {
+    const { rerender } = render(<Harness version={1} />);
+    await waitFor(() => expect(h.sendConfig).toHaveBeenCalled());
+    await seedAndFlip(rerender);
+    h.sendConfig.mockClear();
+    const errSpy = vi.spyOn(console, "error").mockImplementation(() => {});
+    h.compositeCroppedFrame.mockImplementationOnce(() =>
+      Promise.reject(new Error("E_OVERLAY_FRAME_LOAD: image failed to load: blob:v3-m1"))
+    );
+    h.state.results = [croppedResult("m1", "blob:v3-m1"), fullResult("m2", "https://r/m2-full")];
+    await act(async () => rerender(<Harness version={4} />));
+    await act(async () => { await new Promise((r) => setTimeout(r, 200)); });
+    expect(h.sendConfig).not.toHaveBeenCalled(); // still inside the grace window
+    await act(async () => { await new Promise((r) => setTimeout(r, 2100)); });
+    await waitFor(() => expect(sentConfigs().at(-1)?.mockupIds).toEqual(["m1", "m2"]));
+    expect(sentConfigs().every((c) => c.overlayCrop === undefined)).toBe(true);
+    errSpy.mockRestore();
+  });
 });