@playruo/embed 1.7.0 → 1.8.0

package/dist/index.cjs

@@ -211,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;
@@ -283,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]
@@ -806,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;
@@ -872,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",
@@ -887,8 +895,10 @@ 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");
@@ -1043,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);

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;
 };
 
@@ -162,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;
     /**
@@ -268,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;
@@ -291,8 +304,8 @@ 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;
 

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;
 };
 
@@ -162,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;
     /**
@@ -268,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;
@@ -291,8 +304,8 @@ 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;
 

package/dist/index.js

@@ -167,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;
@@ -239,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]
@@ -762,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;
@@ -828,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",
@@ -843,8 +851,10 @@ 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");
@@ -999,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);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@playruo/embed",
-  "version": "1.7.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"
   }
 }