@rehers/rehers-roleplay-sdk 2.5.3 → 2.5.4

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rehers/rehers-roleplay-sdk",
-  "version": "2.5.3",
+  "version": "2.5.4",
   "description": "Seamless Roleplay SDK — embed roleplay call sessions via a modal + iframe",
   "main": "roleplay-sdk.js",
   "types": "index.d.ts",

package/roleplay-sdk.js

@@ -50,6 +50,17 @@
   var dialogAddToScenarioPendingContacts = null;
   var dialogListener = null;
   var dialogCloseTeardownTimer = null;
+  var dialogRevealTimer = null;
+  var mountRevealTimer = null;
+
+  // Max wait before we reveal the iframe even if it never sends ROLEPLAY_READY.
+  // Prevents users from staring at an empty container if the hosted app is slow
+  // or fails to signal. 3s is conservative; the handshake normally lands in < 500ms.
+  var IFRAME_REVEAL_FALLBACK_MS = 3000;
+
+  function revealIframe(iframeEl) {
+    if (iframeEl) iframeEl.style.opacity = "1";
+  }
 
   // ── Safe logging ──────────────────────────────────────────────────
 
@@ -227,6 +238,10 @@
         clearTimeout(dialogCloseTeardownTimer);
         dialogCloseTeardownTimer = null;
       }
+      if (dialogRevealTimer) {
+        clearTimeout(dialogRevealTimer);
+        dialogRevealTimer = null;
+      }
 
       if (dialogOverlay && dialogOverlay.parentNode) {
         dialogOverlay.parentNode.removeChild(dialogOverlay);
@@ -251,6 +266,10 @@
 
   function teardownMount() {
     try {
+      if (mountRevealTimer) {
+        clearTimeout(mountRevealTimer);
+        mountRevealTimer = null;
+      }
       if (mountIframe && mountIframe.parentNode) {
         mountIframe.parentNode.removeChild(mountIframe);
       }
@@ -321,6 +340,11 @@
 
       switch (data.type) {
         case "ROLEPLAY_READY":
+          if (mountRevealTimer) {
+            clearTimeout(mountRevealTimer);
+            mountRevealTimer = null;
+          }
+          revealIframe(mountIframe);
           getSessionToken()
             .then(function (token) {
               dispatchInitToTarget(mountIframe, null, null);
@@ -359,6 +383,11 @@
 
       switch (data.type) {
         case "ROLEPLAY_READY":
+          if (dialogRevealTimer) {
+            clearTimeout(dialogRevealTimer);
+            dialogRevealTimer = null;
+          }
+          revealIframe(dialogIframe);
           getSessionToken()
             .then(function (token) {
               dispatchInitToTarget(dialogIframe, dialogContactData, dialogAddToScenarioPendingContacts);
@@ -369,9 +398,9 @@
           break;
 
         case "ROLEPLAY_ERROR":
-          if (dialogCallbacks.onError) {
-            dialogCallbacks.onError({ code: data.code, message: data.message });
-          }
+          var regularOnError = dialogCallbacks.onError;
+          teardownDialog();
+          if (regularOnError) regularOnError({ code: data.code, message: data.message });
           break;
 
         case "ROLEPLAY_CLOSED":
@@ -394,9 +423,9 @@
           break;
 
         case "ADD_TO_SCENARIO_ERROR":
-          if (dialogAddToScenarioCallbacks.onError) {
-            dialogAddToScenarioCallbacks.onError({ code: data.code, message: data.message });
-          }
+          var atsOnError = dialogAddToScenarioCallbacks.onError;
+          teardownDialog();
+          if (atsOnError) atsOnError({ code: data.code, message: data.message });
           break;
 
         case "ADD_TO_SCENARIO_CLOSED":
@@ -416,10 +445,30 @@
     try {
       sendMsg(dialogIframe, { type: "roleplay-close" });
       if (dialogCloseTeardownTimer) clearTimeout(dialogCloseTeardownTimer);
-      dialogCloseTeardownTimer = setTimeout(teardownDialog, 300);
+      dialogCloseTeardownTimer = setTimeout(function () {
+        // Fallback path: iframe didn't respond with ROLEPLAY_CLOSED or
+        // ADD_TO_SCENARIO_CLOSED. Fire the host's onClose ourselves so
+        // React state (or any controlled caller) can re-render cleanly
+        // and reopen the dialog later.
+        var mode = dialogMode;
+        var atsClose = dialogAddToScenarioCallbacks.onClose;
+        var regularClose = dialogCallbacks.onClose;
+        teardownDialog();
+        try {
+          if (mode === "add-to-scenario" && atsClose) atsClose();
+          else if (regularClose) regularClose();
+        } catch (_) {}
+      }, 300);
     } catch (e) {
       logError("close", e);
+      var mode2 = dialogMode;
+      var atsClose2 = dialogAddToScenarioCallbacks.onClose;
+      var regularClose2 = dialogCallbacks.onClose;
       teardownDialog();
+      try {
+        if (mode2 === "add-to-scenario" && atsClose2) atsClose2();
+        else if (regularClose2) regularClose2();
+      } catch (_) {}
     }
   }
 
@@ -433,6 +482,11 @@
     iframeEl.style.height = "100%";
     iframeEl.style.border = "none";
     iframeEl.style.display = "block";
+    // Start invisible. The host app flashes a brief unstyled loader before it's
+    // ready; we reveal the iframe once ROLEPLAY_READY arrives (or after a
+    // fallback timeout). See revealIframe() callers.
+    iframeEl.style.opacity = "0";
+    iframeEl.style.transition = "opacity 120ms ease-out";
     return iframeEl;
   }
 
@@ -595,6 +649,13 @@
         dialogOverlay = el;
         dialogIframe = iframeEl;
         document.body.appendChild(dialogOverlay);
+
+        // Fallback: reveal the iframe even if ROLEPLAY_READY never arrives.
+        if (dialogRevealTimer) clearTimeout(dialogRevealTimer);
+        dialogRevealTimer = setTimeout(function () {
+          revealIframe(dialogIframe);
+          dialogRevealTimer = null;
+        }, IFRAME_REVEAL_FALLBACK_MS);
       } catch (e) {
         logError("open", e);
         teardownDialog();
@@ -631,6 +692,13 @@
         var iframeEl = createIframe("/");
         mountIframe = iframeEl;
         container.appendChild(iframeEl);
+
+        // Fallback: reveal the iframe even if ROLEPLAY_READY never arrives.
+        if (mountRevealTimer) clearTimeout(mountRevealTimer);
+        mountRevealTimer = setTimeout(function () {
+          revealIframe(mountIframe);
+          mountRevealTimer = null;
+        }, IFRAME_REVEAL_FALLBACK_MS);
       } catch (e) {
         logError("mount", e);
         teardownMount();
@@ -721,6 +789,9 @@
         iframeEl.style.top = "0";
         iframeEl.style.left = "0";
         iframeEl.style.zIndex = "1";
+        // Hide until ROLEPLAY_READY so we don't flash the host app's pre-init state.
+        iframeEl.style.opacity = "0";
+        iframeEl.style.transition = "opacity 120ms ease-out";
 
         var closeBtn = document.createElement("button");
         closeBtn.type = "button";
@@ -758,6 +829,13 @@
         dialogOverlay = el;
         dialogIframe = iframeEl;
         document.body.appendChild(dialogOverlay);
+
+        // Fallback: reveal the iframe even if ROLEPLAY_READY never arrives.
+        if (dialogRevealTimer) clearTimeout(dialogRevealTimer);
+        dialogRevealTimer = setTimeout(function () {
+          revealIframe(dialogIframe);
+          dialogRevealTimer = null;
+        }, IFRAME_REVEAL_FALLBACK_MS);
       } catch (e) {
         logError("addToScenario", e);
         teardownDialog();