@playruo/embed 1.6.0 → 1.8.0

package/dist/index.cjs

@@ -37,6 +37,7 @@ __export(index_exports, {
   buildEmbedUrl: () => buildEmbedUrl,
   isPlayruoEmbedMessage: () => isPlayruoEmbedMessage,
   isPlayruoInternalMessage: () => isPlayruoInternalMessage,
+  normalizePlayruoError: () => normalizePlayruoError,
   resolveVisitorUuid: () => resolveVisitorUuid
 });
 module.exports = __toCommonJS(index_exports);
@@ -47,6 +48,37 @@ var PLAYRUO_IFRAME_ALLOW = "cross-origin-isolated; fullscreen *; autoplay *; gam
 // src/react/playruo-embed.tsx
 var import_react = require("react");
 
+// src/post-message-types.ts
+var normalizePlayruoError = (data) => {
+  if (typeof data === "string") {
+    return { message: data || "Unknown error" };
+  }
+  if (!data || typeof data !== "object") {
+    return { message: "Unknown error" };
+  }
+  const record = data;
+  const message = typeof record.message === "string" && record.message ? record.message : "Unknown error";
+  const details = { message };
+  if (typeof record.code === "string") {
+    details.code = record.code;
+  }
+  if (typeof record.event === "string") {
+    details.event = record.event;
+  }
+  return details;
+};
+var isPlayruoEmbedMessage = (data) => {
+  if (!data || typeof data !== "object") return false;
+  const msg = data;
+  if (typeof msg.type !== "string") return false;
+  return msg.type === "playruo_ready" || msg.type === "playruo_state_update" || msg.type === "playruo_purchase_request" || msg.type === "playruo_demo_completed" || msg.type === "playruo_error" || msg.type === "playruo_session_over" || msg.type === "playruo_stream_start" || msg.type === "playruo_stream_stop" || msg.type === "REQUEST_EXIT_FULLSCREEN" || msg.type === "playruo_event" || msg.type === "playruo_password_required" || msg.type === "playruo_password_not_required" || msg.type === "playruo_password_result";
+};
+var isPlayruoInternalMessage = (data) => {
+  if (!data || typeof data !== "object") return false;
+  const msg = data;
+  return msg.type === "playruo" && typeof msg.action === "string" && (msg.action === "tryNowClick" || msg.action === "exitFullscreen" || msg.action === "mute" || msg.action === "unmute" || msg.action === "submitPassword" || msg.action === "requestPassword") && msg.fromEmbed === true;
+};
+
 // src/url.ts
 var PLAYRUO_ORIGIN = "https://playruo.live";
 var normalizeOperation = (operation) => {
@@ -179,6 +211,14 @@ var PlayruoEmbed = ({
   }, []);
   const isCompatible = !isMobile && isValidChromium;
   const isReady = isCompatible ? isIframeLoaded : true;
+  (0, import_react.useEffect)(() => {
+    const iframe = iframeRef.current;
+    if (!iframe || iframe.getAttribute("src") === src) {
+      return;
+    }
+    iframe.setAttribute("credentialless", "");
+    iframe.src = src;
+  }, [iframeRef, isCompatible, src]);
   const currentState = (0, import_react.useMemo)(() => {
     if (iframeState) {
       return iframeState;
@@ -251,7 +291,7 @@ var PlayruoEmbed = ({
           embedOrigin
         );
       } catch {
-        console.error("[PlayruoEmbed] Failed to send the password action");
+        console.error("[PlayruoEmbed] Failed to send iframe action");
       }
     },
     [embedOrigin, iframeRef]
@@ -449,7 +489,7 @@ var PlayruoEmbed = ({
       console.error("[PlayruoEmbed] Failed to start game:", error);
       setShowGameIframe(false);
       setErrorMessage("Failed to start game");
-      onError?.("Failed to start game");
+      onError?.("Failed to start game", { message: "Failed to start game" });
     }
   }, [
     enableWindowedLaunch,
@@ -506,8 +546,9 @@ var PlayruoEmbed = ({
         console.log("\u{1F537} [Embed] playruo_demo_completed received:", data);
         cleanupEmbedSession({ payload: data });
       } else if (type === "playruo_error") {
-        const errorMessage2 = typeof data === "string" ? data : data?.message || "Unknown error";
-        console.log("\u{1F537} [Embed] playruo_error received:", errorMessage2);
+        const details = normalizePlayruoError(data);
+        const errorMessage2 = details.message;
+        console.log("\u{1F537} [Embed] playruo_error received:", errorMessage2, details);
         setErrorMessage(errorMessage2);
         const errorState = {
           hasPlayedOnce,
@@ -522,7 +563,7 @@ var PlayruoEmbed = ({
         };
         setIframeState(errorState);
         onStateChange?.(errorState);
-        onError?.(errorMessage2);
+        onError?.(errorMessage2, details);
       } else if (type === "playruo_session_over" && data) {
         console.log("\u{1F537} [Embed] playruo_session_over received:", data);
         void exitEmbedFullscreen({ reason: "playruo_session_over" });
@@ -773,7 +814,9 @@ var PlayruoEmbed = ({
       tryNow: handleTryNow,
       buyNow: handleBuyNow,
       canTryNow,
-      canBuyNow: Boolean(isReady),
+      canBuyNow: Boolean(isReady && storeUrl),
+      mute: () => postPasswordAction({ action: "mute" }),
+      unmute: () => postPasswordAction({ action: "unmute" }),
       submitPassword: (password2) => {
         if (!password2) {
           return;
@@ -839,10 +882,8 @@ var PlayruoEmbed = ({
       "iframe",
       {
         ref: iframeRef,
-        src,
         allow: PLAYRUO_IFRAME_ALLOW,
         className: "w-full h-[70vh] rounded-lg border",
-        ...{ credentialless: "true" },
         sandbox: "allow-same-origin allow-scripts allow-popups allow-forms allow-presentation allow-top-navigation allow-modals allow-pointer-lock",
         title: "Playruo",
         referrerPolicy: "strict-origin-when-cross-origin",
@@ -854,13 +895,15 @@ var PlayruoEmbed = ({
           height: "100%",
           border: 0
         },
-        onLoad: () => {
-          setIsIframeLoaded(true);
+        onLoad: (event) => {
+          if (event.currentTarget.getAttribute("src")) {
+            setIsIframeLoaded(true);
+          }
         },
         onError: () => {
           console.error("[PlayruoEmbed] Iframe failed to load");
           setErrorMessage("Failed to load game");
-          onError?.("Failed to load game");
+          onError?.("Failed to load game", { message: "Failed to load game" });
         }
       }
     )
@@ -1010,7 +1053,7 @@ var EmbedTester = (props = {}) => {
     }
   }, [addEvent, enableConsoleLog]);
   const handleEvent = (0, import_react2.useCallback)((data) => {
-    const eventName = typeof data.event === "string" ? data.event : typeof data.name === "string" ? data.name : "unknown";
+    const eventName = typeof data.name === "string" ? data.name : typeof data.event === "string" ? data.event : "unknown";
     addEvent(`Event received: ${eventName}`);
     if (enableConsoleLog) {
       console.log("Embed event:", data);
@@ -2133,19 +2176,6 @@ var EmbedTester = (props = {}) => {
     }
   );
 };
-
-// src/post-message-types.ts
-var isPlayruoEmbedMessage = (data) => {
-  if (!data || typeof data !== "object") return false;
-  const msg = data;
-  if (typeof msg.type !== "string") return false;
-  return msg.type === "playruo_ready" || msg.type === "playruo_state_update" || msg.type === "playruo_purchase_request" || msg.type === "playruo_demo_completed" || msg.type === "playruo_error" || msg.type === "playruo_session_over" || msg.type === "playruo_stream_start" || msg.type === "playruo_stream_stop" || msg.type === "REQUEST_EXIT_FULLSCREEN" || msg.type === "playruo_event" || msg.type === "playruo_password_required" || msg.type === "playruo_password_not_required" || msg.type === "playruo_password_result";
-};
-var isPlayruoInternalMessage = (data) => {
-  if (!data || typeof data !== "object") return false;
-  const msg = data;
-  return msg.type === "playruo" && typeof msg.action === "string" && (msg.action === "tryNowClick" || msg.action === "exitFullscreen" || msg.action === "mute" || msg.action === "unmute" || msg.action === "submitPassword" || msg.action === "requestPassword") && msg.fromEmbed === true;
-};
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   EmbedTester,
@@ -2155,5 +2185,6 @@ var isPlayruoInternalMessage = (data) => {
   buildEmbedUrl,
   isPlayruoEmbedMessage,
   isPlayruoInternalMessage,
+  normalizePlayruoError,
   resolveVisitorUuid
 });

package/dist/index.d.cts

@@ -1,5 +1,4 @@
-import { FC, ReactNode } from 'react';
-import * as react_jsx_runtime from 'react/jsx-runtime';
+import React$1, { FC, ReactNode } from 'react';
 
 /**
  * iframe `allow` feature policy delegated to the Playruo player.
@@ -28,7 +27,13 @@ interface DemoCompletedPayload {
 type PlayruoEventPayload = Record<string, unknown> & {
     action?: string;
     category?: string;
+    /**
+     * @deprecated The webapp puts the event identifier on `name`. Nothing it
+     * posts carries `event`, so a host switching on it never matches. Kept so
+     * older hosts still compile.
+     */
     event?: string;
+    /** Event identifier, snake_case (`auth_ok`, `streaming`, `vmnok`). */
     name?: string;
 };
 
@@ -49,12 +54,35 @@ interface PlayruoDemoCompletedMessage {
     type: "playruo_demo_completed";
     data: DemoCompletedPayload;
 }
+/**
+ * What React `onError` sees after normalisation. `code` and `event` come from
+ * structured hard errors; extras such as `visibility` are dropped on purpose.
+ */
+type PlayruoErrorDetails = {
+    message: string;
+    code?: string;
+    event?: string;
+};
 interface PlayruoErrorMessage {
     type: "playruo_error";
+    /**
+     * Production hard errors carry `code` and `event`. Soft capacity blocks and
+     * legacy paths may send only `{ message }` or a bare string. Extra keys may
+     * appear on the wire; hosts that go through `normalizePlayruoError` never see
+     * them.
+     */
     data: {
         message: string;
+        code?: string;
+        event?: string;
     } | string;
 }
+/**
+ * Reduce a `playruo_error.data` value (or a host-local string) to the shape
+ * React `onError` receives. Only string `code` / `event` survive; everything
+ * else is dropped so a host cannot grow a dependency on accidental extras.
+ */
+declare const normalizePlayruoError: (data: unknown) => PlayruoErrorDetails;
 interface PlayruoSessionOverMessage {
     type: "playruo_session_over";
     data: PlayruoEmbedState;
@@ -139,8 +167,16 @@ interface PlayruoEmbedActions {
     buyNow: () => void;
     /** Whether try now is currently available */
     canTryNow: boolean;
-    /** Whether buy now is currently available */
+    /**
+     * Whether buy now can call `onPurchaseRequest`. True only when the SDK is
+     * ready and a `storeUrl` prop is set. Compatible with mobile/unavailable
+     * hosts that still want a store CTA.
+     */
     canBuyNow: boolean;
+    /** Mute active stream audio. No acknowledgement is returned. */
+    mute: () => void;
+    /** Resume and unmute stream audio. No acknowledgement is returned. */
+    unmute: () => void;
     /** Send the password collected by the host to a protected operation. */
     submitPassword: (password: string) => void;
     /**
@@ -204,7 +240,7 @@ interface PlayruoEmbedProps {
     onPurchaseRequest?: (data: {
         storeUrl: string;
     }) => void;
-    onError?: (error: string) => void;
+    onError?: (error: string, details: PlayruoErrorDetails) => void;
     /** The operation is password protected and waits for one. */
     onPasswordRequired?: () => void;
     /** Answer to a submitted password. */
@@ -245,7 +281,7 @@ interface EmbedTesterProps {
     enableWindowedLaunch?: boolean;
     className?: string;
 }
-declare const EmbedTester: (props?: EmbedTesterProps) => react_jsx_runtime.JSX.Element;
+declare const EmbedTester: (props?: EmbedTesterProps) => React$1.JSX.Element;
 
 interface BuildUrlParams {
     operation: string;
@@ -268,9 +304,9 @@ declare const buildEmbedUrl: ({ operation, operationKey, storeUrl, }: BuildUrlPa
 declare const PLAYRUO_UUID_STORAGE_KEY = "playruo_uuid";
 /**
  * Visitor identity the host answers on `playruo_uuid_request`.
- * Same rule as PlayruoEmbed `clientFingerprint`: a non-empty value is used as-is
- * and is not written to localStorage. Otherwise the SDK-managed UUID is used.
+ * Same rule as PlayruoEmbed `clientFingerprint`: a non-empty trimmed value is
+ * used and is not written to localStorage. Otherwise the SDK-managed UUID is used.
  */
 declare const resolveVisitorUuid: (clientFingerprint?: string) => string;
 
-export { type DemoCompletedPayload, EmbedTester, type EmbedTesterProps, PLAYRUO_IFRAME_ALLOW, PLAYRUO_UUID_STORAGE_KEY, type PlayruoDemoCompletedMessage, PlayruoEmbed, type PlayruoEmbedActions, type PlayruoEmbedMessage, type PlayruoEmbedPasswordState, type PlayruoEmbedProps, type PlayruoEmbedRenderState, type PlayruoEmbedState, type PlayruoErrorMessage, type PlayruoEventMessage, type PlayruoEventPayload, type PlayruoInternalMessage, type PlayruoPasswordError, type PlayruoPasswordErrorCode, type PlayruoPasswordNotRequiredMessage, type PlayruoPasswordRequiredMessage, type PlayruoPasswordResultMessage, type PlayruoPurchaseRequestMessage, type PlayruoReadyMessage, type PlayruoRequestExitFullscreenMessage, type PlayruoSessionOverMessage, type PlayruoStateUpdateMessage, type PlayruoStreamStartMessage, type PlayruoStreamStopMessage, buildEmbedUrl, isPlayruoEmbedMessage, isPlayruoInternalMessage, resolveVisitorUuid };
+export { type DemoCompletedPayload, EmbedTester, type EmbedTesterProps, PLAYRUO_IFRAME_ALLOW, PLAYRUO_UUID_STORAGE_KEY, type PlayruoDemoCompletedMessage, PlayruoEmbed, type PlayruoEmbedActions, type PlayruoEmbedMessage, type PlayruoEmbedPasswordState, type PlayruoEmbedProps, type PlayruoEmbedRenderState, type PlayruoEmbedState, type PlayruoErrorDetails, type PlayruoErrorMessage, type PlayruoEventMessage, type PlayruoEventPayload, type PlayruoInternalMessage, type PlayruoPasswordError, type PlayruoPasswordErrorCode, type PlayruoPasswordNotRequiredMessage, type PlayruoPasswordRequiredMessage, type PlayruoPasswordResultMessage, type PlayruoPurchaseRequestMessage, type PlayruoReadyMessage, type PlayruoRequestExitFullscreenMessage, type PlayruoSessionOverMessage, type PlayruoStateUpdateMessage, type PlayruoStreamStartMessage, type PlayruoStreamStopMessage, buildEmbedUrl, isPlayruoEmbedMessage, isPlayruoInternalMessage, normalizePlayruoError, resolveVisitorUuid };

package/dist/index.d.ts

@@ -1,5 +1,4 @@
-import { FC, ReactNode } from 'react';
-import * as react_jsx_runtime from 'react/jsx-runtime';
+import React$1, { FC, ReactNode } from 'react';
 
 /**
  * iframe `allow` feature policy delegated to the Playruo player.
@@ -28,7 +27,13 @@ interface DemoCompletedPayload {
 type PlayruoEventPayload = Record<string, unknown> & {
     action?: string;
     category?: string;
+    /**
+     * @deprecated The webapp puts the event identifier on `name`. Nothing it
+     * posts carries `event`, so a host switching on it never matches. Kept so
+     * older hosts still compile.
+     */
     event?: string;
+    /** Event identifier, snake_case (`auth_ok`, `streaming`, `vmnok`). */
     name?: string;
 };
 
@@ -49,12 +54,35 @@ interface PlayruoDemoCompletedMessage {
     type: "playruo_demo_completed";
     data: DemoCompletedPayload;
 }
+/**
+ * What React `onError` sees after normalisation. `code` and `event` come from
+ * structured hard errors; extras such as `visibility` are dropped on purpose.
+ */
+type PlayruoErrorDetails = {
+    message: string;
+    code?: string;
+    event?: string;
+};
 interface PlayruoErrorMessage {
     type: "playruo_error";
+    /**
+     * Production hard errors carry `code` and `event`. Soft capacity blocks and
+     * legacy paths may send only `{ message }` or a bare string. Extra keys may
+     * appear on the wire; hosts that go through `normalizePlayruoError` never see
+     * them.
+     */
     data: {
         message: string;
+        code?: string;
+        event?: string;
     } | string;
 }
+/**
+ * Reduce a `playruo_error.data` value (or a host-local string) to the shape
+ * React `onError` receives. Only string `code` / `event` survive; everything
+ * else is dropped so a host cannot grow a dependency on accidental extras.
+ */
+declare const normalizePlayruoError: (data: unknown) => PlayruoErrorDetails;
 interface PlayruoSessionOverMessage {
     type: "playruo_session_over";
     data: PlayruoEmbedState;
@@ -139,8 +167,16 @@ interface PlayruoEmbedActions {
     buyNow: () => void;
     /** Whether try now is currently available */
     canTryNow: boolean;
-    /** Whether buy now is currently available */
+    /**
+     * Whether buy now can call `onPurchaseRequest`. True only when the SDK is
+     * ready and a `storeUrl` prop is set. Compatible with mobile/unavailable
+     * hosts that still want a store CTA.
+     */
     canBuyNow: boolean;
+    /** Mute active stream audio. No acknowledgement is returned. */
+    mute: () => void;
+    /** Resume and unmute stream audio. No acknowledgement is returned. */
+    unmute: () => void;
     /** Send the password collected by the host to a protected operation. */
     submitPassword: (password: string) => void;
     /**
@@ -204,7 +240,7 @@ interface PlayruoEmbedProps {
     onPurchaseRequest?: (data: {
         storeUrl: string;
     }) => void;
-    onError?: (error: string) => void;
+    onError?: (error: string, details: PlayruoErrorDetails) => void;
     /** The operation is password protected and waits for one. */
     onPasswordRequired?: () => void;
     /** Answer to a submitted password. */
@@ -245,7 +281,7 @@ interface EmbedTesterProps {
     enableWindowedLaunch?: boolean;
     className?: string;
 }
-declare const EmbedTester: (props?: EmbedTesterProps) => react_jsx_runtime.JSX.Element;
+declare const EmbedTester: (props?: EmbedTesterProps) => React$1.JSX.Element;
 
 interface BuildUrlParams {
     operation: string;
@@ -268,9 +304,9 @@ declare const buildEmbedUrl: ({ operation, operationKey, storeUrl, }: BuildUrlPa
 declare const PLAYRUO_UUID_STORAGE_KEY = "playruo_uuid";
 /**
  * Visitor identity the host answers on `playruo_uuid_request`.
- * Same rule as PlayruoEmbed `clientFingerprint`: a non-empty value is used as-is
- * and is not written to localStorage. Otherwise the SDK-managed UUID is used.
+ * Same rule as PlayruoEmbed `clientFingerprint`: a non-empty trimmed value is
+ * used and is not written to localStorage. Otherwise the SDK-managed UUID is used.
  */
 declare const resolveVisitorUuid: (clientFingerprint?: string) => string;
 
-export { type DemoCompletedPayload, EmbedTester, type EmbedTesterProps, PLAYRUO_IFRAME_ALLOW, PLAYRUO_UUID_STORAGE_KEY, type PlayruoDemoCompletedMessage, PlayruoEmbed, type PlayruoEmbedActions, type PlayruoEmbedMessage, type PlayruoEmbedPasswordState, type PlayruoEmbedProps, type PlayruoEmbedRenderState, type PlayruoEmbedState, type PlayruoErrorMessage, type PlayruoEventMessage, type PlayruoEventPayload, type PlayruoInternalMessage, type PlayruoPasswordError, type PlayruoPasswordErrorCode, type PlayruoPasswordNotRequiredMessage, type PlayruoPasswordRequiredMessage, type PlayruoPasswordResultMessage, type PlayruoPurchaseRequestMessage, type PlayruoReadyMessage, type PlayruoRequestExitFullscreenMessage, type PlayruoSessionOverMessage, type PlayruoStateUpdateMessage, type PlayruoStreamStartMessage, type PlayruoStreamStopMessage, buildEmbedUrl, isPlayruoEmbedMessage, isPlayruoInternalMessage, resolveVisitorUuid };
+export { type DemoCompletedPayload, EmbedTester, type EmbedTesterProps, PLAYRUO_IFRAME_ALLOW, PLAYRUO_UUID_STORAGE_KEY, type PlayruoDemoCompletedMessage, PlayruoEmbed, type PlayruoEmbedActions, type PlayruoEmbedMessage, type PlayruoEmbedPasswordState, type PlayruoEmbedProps, type PlayruoEmbedRenderState, type PlayruoEmbedState, type PlayruoErrorDetails, type PlayruoErrorMessage, type PlayruoEventMessage, type PlayruoEventPayload, type PlayruoInternalMessage, type PlayruoPasswordError, type PlayruoPasswordErrorCode, type PlayruoPasswordNotRequiredMessage, type PlayruoPasswordRequiredMessage, type PlayruoPasswordResultMessage, type PlayruoPurchaseRequestMessage, type PlayruoReadyMessage, type PlayruoRequestExitFullscreenMessage, type PlayruoSessionOverMessage, type PlayruoStateUpdateMessage, type PlayruoStreamStartMessage, type PlayruoStreamStopMessage, buildEmbedUrl, isPlayruoEmbedMessage, isPlayruoInternalMessage, normalizePlayruoError, resolveVisitorUuid };

package/dist/index.js

@@ -4,6 +4,37 @@ var PLAYRUO_IFRAME_ALLOW = "cross-origin-isolated; fullscreen *; autoplay *; gam
 // src/react/playruo-embed.tsx
 import { useEffect, useMemo, useRef, useState, useCallback } from "react";
 
+// src/post-message-types.ts
+var normalizePlayruoError = (data) => {
+  if (typeof data === "string") {
+    return { message: data || "Unknown error" };
+  }
+  if (!data || typeof data !== "object") {
+    return { message: "Unknown error" };
+  }
+  const record = data;
+  const message = typeof record.message === "string" && record.message ? record.message : "Unknown error";
+  const details = { message };
+  if (typeof record.code === "string") {
+    details.code = record.code;
+  }
+  if (typeof record.event === "string") {
+    details.event = record.event;
+  }
+  return details;
+};
+var isPlayruoEmbedMessage = (data) => {
+  if (!data || typeof data !== "object") return false;
+  const msg = data;
+  if (typeof msg.type !== "string") return false;
+  return msg.type === "playruo_ready" || msg.type === "playruo_state_update" || msg.type === "playruo_purchase_request" || msg.type === "playruo_demo_completed" || msg.type === "playruo_error" || msg.type === "playruo_session_over" || msg.type === "playruo_stream_start" || msg.type === "playruo_stream_stop" || msg.type === "REQUEST_EXIT_FULLSCREEN" || msg.type === "playruo_event" || msg.type === "playruo_password_required" || msg.type === "playruo_password_not_required" || msg.type === "playruo_password_result";
+};
+var isPlayruoInternalMessage = (data) => {
+  if (!data || typeof data !== "object") return false;
+  const msg = data;
+  return msg.type === "playruo" && typeof msg.action === "string" && (msg.action === "tryNowClick" || msg.action === "exitFullscreen" || msg.action === "mute" || msg.action === "unmute" || msg.action === "submitPassword" || msg.action === "requestPassword") && msg.fromEmbed === true;
+};
+
 // src/url.ts
 var PLAYRUO_ORIGIN = "https://playruo.live";
 var normalizeOperation = (operation) => {
@@ -136,6 +167,14 @@ var PlayruoEmbed = ({
   }, []);
   const isCompatible = !isMobile && isValidChromium;
   const isReady = isCompatible ? isIframeLoaded : true;
+  useEffect(() => {
+    const iframe = iframeRef.current;
+    if (!iframe || iframe.getAttribute("src") === src) {
+      return;
+    }
+    iframe.setAttribute("credentialless", "");
+    iframe.src = src;
+  }, [iframeRef, isCompatible, src]);
   const currentState = useMemo(() => {
     if (iframeState) {
       return iframeState;
@@ -208,7 +247,7 @@ var PlayruoEmbed = ({
           embedOrigin
         );
       } catch {
-        console.error("[PlayruoEmbed] Failed to send the password action");
+        console.error("[PlayruoEmbed] Failed to send iframe action");
       }
     },
     [embedOrigin, iframeRef]
@@ -406,7 +445,7 @@ var PlayruoEmbed = ({
       console.error("[PlayruoEmbed] Failed to start game:", error);
       setShowGameIframe(false);
       setErrorMessage("Failed to start game");
-      onError?.("Failed to start game");
+      onError?.("Failed to start game", { message: "Failed to start game" });
     }
   }, [
     enableWindowedLaunch,
@@ -463,8 +502,9 @@ var PlayruoEmbed = ({
         console.log("\u{1F537} [Embed] playruo_demo_completed received:", data);
         cleanupEmbedSession({ payload: data });
       } else if (type === "playruo_error") {
-        const errorMessage2 = typeof data === "string" ? data : data?.message || "Unknown error";
-        console.log("\u{1F537} [Embed] playruo_error received:", errorMessage2);
+        const details = normalizePlayruoError(data);
+        const errorMessage2 = details.message;
+        console.log("\u{1F537} [Embed] playruo_error received:", errorMessage2, details);
         setErrorMessage(errorMessage2);
         const errorState = {
           hasPlayedOnce,
@@ -479,7 +519,7 @@ var PlayruoEmbed = ({
         };
         setIframeState(errorState);
         onStateChange?.(errorState);
-        onError?.(errorMessage2);
+        onError?.(errorMessage2, details);
       } else if (type === "playruo_session_over" && data) {
         console.log("\u{1F537} [Embed] playruo_session_over received:", data);
         void exitEmbedFullscreen({ reason: "playruo_session_over" });
@@ -730,7 +770,9 @@ var PlayruoEmbed = ({
       tryNow: handleTryNow,
       buyNow: handleBuyNow,
       canTryNow,
-      canBuyNow: Boolean(isReady),
+      canBuyNow: Boolean(isReady && storeUrl),
+      mute: () => postPasswordAction({ action: "mute" }),
+      unmute: () => postPasswordAction({ action: "unmute" }),
       submitPassword: (password2) => {
         if (!password2) {
           return;
@@ -796,10 +838,8 @@ var PlayruoEmbed = ({
       "iframe",
       {
         ref: iframeRef,
-        src,
         allow: PLAYRUO_IFRAME_ALLOW,
         className: "w-full h-[70vh] rounded-lg border",
-        ...{ credentialless: "true" },
         sandbox: "allow-same-origin allow-scripts allow-popups allow-forms allow-presentation allow-top-navigation allow-modals allow-pointer-lock",
         title: "Playruo",
         referrerPolicy: "strict-origin-when-cross-origin",
@@ -811,13 +851,15 @@ var PlayruoEmbed = ({
           height: "100%",
           border: 0
         },
-        onLoad: () => {
-          setIsIframeLoaded(true);
+        onLoad: (event) => {
+          if (event.currentTarget.getAttribute("src")) {
+            setIsIframeLoaded(true);
+          }
         },
         onError: () => {
           console.error("[PlayruoEmbed] Iframe failed to load");
           setErrorMessage("Failed to load game");
-          onError?.("Failed to load game");
+          onError?.("Failed to load game", { message: "Failed to load game" });
         }
       }
     )
@@ -967,7 +1009,7 @@ var EmbedTester = (props = {}) => {
     }
   }, [addEvent, enableConsoleLog]);
   const handleEvent = useCallback2((data) => {
-    const eventName = typeof data.event === "string" ? data.event : typeof data.name === "string" ? data.name : "unknown";
+    const eventName = typeof data.name === "string" ? data.name : typeof data.event === "string" ? data.event : "unknown";
     addEvent(`Event received: ${eventName}`);
     if (enableConsoleLog) {
       console.log("Embed event:", data);
@@ -2090,19 +2132,6 @@ var EmbedTester = (props = {}) => {
     }
   );
 };
-
-// src/post-message-types.ts
-var isPlayruoEmbedMessage = (data) => {
-  if (!data || typeof data !== "object") return false;
-  const msg = data;
-  if (typeof msg.type !== "string") return false;
-  return msg.type === "playruo_ready" || msg.type === "playruo_state_update" || msg.type === "playruo_purchase_request" || msg.type === "playruo_demo_completed" || msg.type === "playruo_error" || msg.type === "playruo_session_over" || msg.type === "playruo_stream_start" || msg.type === "playruo_stream_stop" || msg.type === "REQUEST_EXIT_FULLSCREEN" || msg.type === "playruo_event" || msg.type === "playruo_password_required" || msg.type === "playruo_password_not_required" || msg.type === "playruo_password_result";
-};
-var isPlayruoInternalMessage = (data) => {
-  if (!data || typeof data !== "object") return false;
-  const msg = data;
-  return msg.type === "playruo" && typeof msg.action === "string" && (msg.action === "tryNowClick" || msg.action === "exitFullscreen" || msg.action === "mute" || msg.action === "unmute" || msg.action === "submitPassword" || msg.action === "requestPassword") && msg.fromEmbed === true;
-};
 export {
   EmbedTester,
   PLAYRUO_IFRAME_ALLOW,
@@ -2111,5 +2140,6 @@ export {
   buildEmbedUrl,
   isPlayruoEmbedMessage,
   isPlayruoInternalMessage,
+  normalizePlayruoError,
   resolveVisitorUuid
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@playruo/embed",
-  "version": "1.6.0",
+  "version": "1.8.0",
   "description": "React SDK to embed Playruo with postMessage API.",
   "license": "MIT",
   "type": "module",
@@ -35,15 +35,21 @@
     "@types/node": "^26.2.0",
     "@types/react": "^19",
     "@types/react-dom": "^19",
-    "@vitest/browser": "^3.2.7",
-    "@vitest/coverage-v8": "^3.2.4",
+    "@vitest/browser": "^5.0.2",
+    "@vitest/browser-playwright": "^5.0.2",
+    "@vitest/coverage-v8": "^5.0.2",
     "jsdom": "^26.1.0",
-    "playwright": "^1.62.1",
+    "playwright": "1.62.1",
     "react": "^19.1.0",
     "react-dom": "^19.1.0",
     "tsup": "^8.0.0",
     "typescript": "^5.4.0",
-    "vitest": "^3.2.4"
+    "vitest": "^5.0.2"
+  },
+  "overrides": {
+    "esbuild": "^0.28.1",
+    "picomatch": "^4.0.4",
+    "rollup": "^4.59.0"
   },
   "scripts": {
     "build": "tsup src/index.ts --format esm,cjs --dts --clean",
@@ -52,9 +58,11 @@
     "typecheck": "tsc -p tsconfig.test.json",
     "check:exports": "attw --pack .",
     "test": "npm run build && vitest run --coverage",
+    "test:smoke": "vitest run tests/smoke",
     "test:browser": "vitest run --config vitest.browser.config.ts",
     "test:watch": "npm run build && vitest",
     "docs:notion:dry-run": "node scripts/sync-notion-docs.mjs",
-    "docs:notion:publish": "node scripts/sync-notion-docs.mjs --publish"
+    "docs:notion:publish": "node scripts/sync-notion-docs.mjs --publish",
+    "docs:catalog:check": "node scripts/check-embed-event-catalog.mjs && node scripts/check-embed-error-catalog.mjs"
   }
 }