@snowcone-app/ui 0.3.1 → 0.4.0

package/CHANGELOG.md

@@ -1,5 +1,18 @@
 # Changelog
 
+## 0.4.0
+
+### Minor Changes
+
+- [#765](https://github.com/snowcone-app/snowcone-monorepo/pull/765) [`1d73014`](https://github.com/snowcone-app/snowcone-monorepo/commit/1d73014fef7c9eadb499c14677f85620df5f80c4) Thanks [@kevinsproles](https://github.com/kevinsproles)! - Surface realtime render errors as structured, machine-readable state instead of swallowing them.
+  - sdk: new `RealtimeRenderError` (`{code, message}`) mirrors the server's `{type:'error', code}` frame. Exposed as `renderError` on `RealtimeMockupState` / the `useRealtimeMockup` hook return, passed as a second `detail` argument to `onError` callbacks (hook, service callbacks, and `RenderSession.onError`), and cleared automatically once a later render succeeds. `mockupResults` intentionally keeps the last good renders on error so hosts can show "stale + error badge" instead of a blank panel.
+  - ui: `RealtimeProvider` exposes `renderError` on its context, and `HeroProductImage` renders a visible error badge with a stable `data-render-error="<code>"` attribute over the (kept) stale mockup when the realtime renderer rejects a render (e.g. `asset_not_allowed`).
+
+### Patch Changes
+
+- Updated dependencies [[`1d73014`](https://github.com/snowcone-app/snowcone-monorepo/commit/1d73014fef7c9eadb499c14677f85620df5f80c4)]:
+  - @snowcone-app/sdk@0.17.0
+
 ## 0.3.1
 
 ### Patch Changes

package/dist/index.cjs

@@ -5979,8 +5979,8 @@ function RealtimeProvider({
     },
     onAllMockupsRendered: (results) => {
     },
-    onError: (error) => {
-      console.error("[RealtimeProvider] Error:", error);
+    onError: (error, detail) => {
+      console.error(`[RealtimeProvider] Render error [${detail.code}]:`, error);
     }
   });
   const subscribeRTCTiming = (0, import_react24.useCallback)((_callback) => {
@@ -5990,6 +5990,7 @@ function RealtimeProvider({
   const {
     isConnected,
     isConfigured,
+    renderError,
     mockupResults: rawMockupResults,
     sendCanvasBlob: sendCanvasBlobRaw,
     sendCanvasState: sendCanvasStateRaw,
@@ -6509,6 +6510,7 @@ function RealtimeProvider({
       isEnabled,
       isConnected,
       isConfigured,
+      renderError,
       // Read from ref - this is a snapshot at render time, NOT reactive
       // For reactive updates, use getMockupResultsImmediate() or subscribe functions
       get mockupResults() {
@@ -6552,6 +6554,7 @@ function RealtimeProvider({
       isEnabled,
       isConnected,
       isConfigured,
+      renderError,
       // mockupResults removed from deps - it's a getter that reads from ref
       canvasExportSize,
       mockupWidth,
@@ -10524,6 +10527,15 @@ var HeroProductImage = (0, import_react45.memo)(function HeroProductImage2({
             }
           }
         ),
+        realtimeContext?.renderError && /* @__PURE__ */ (0, import_jsx_runtime60.jsx)(
+          "div",
+          {
+            role: "alert",
+            "data-render-error": realtimeContext.renderError.code,
+            className: "absolute inset-x-0 bottom-0 z-20 bg-red-600/90 text-white text-xs font-medium px-3 py-2 pointer-events-none",
+            children: `Render blocked: ${realtimeContext.renderError.code} \u2014 ${realtimeContext.renderError.message}`
+          }
+        ),
         prevUrl && /* @__PURE__ */ (0, import_jsx_runtime60.jsx)(
           "img",
           {