@playruo/embed 1.5.0 → 1.7.0

package/dist/index.cjs

@@ -31,18 +31,54 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 var index_exports = {};
 __export(index_exports, {
   EmbedTester: () => EmbedTester,
+  PLAYRUO_IFRAME_ALLOW: () => PLAYRUO_IFRAME_ALLOW,
   PLAYRUO_UUID_STORAGE_KEY: () => PLAYRUO_UUID_STORAGE_KEY,
   PlayruoEmbed: () => PlayruoEmbed,
   buildEmbedUrl: () => buildEmbedUrl,
   isPlayruoEmbedMessage: () => isPlayruoEmbedMessage,
   isPlayruoInternalMessage: () => isPlayruoInternalMessage,
+  normalizePlayruoError: () => normalizePlayruoError,
   resolveVisitorUuid: () => resolveVisitorUuid
 });
 module.exports = __toCommonJS(index_exports);
 
+// src/iframe-allow.ts
+var PLAYRUO_IFRAME_ALLOW = "cross-origin-isolated; fullscreen *; autoplay *; gamepad *; clipboard-write *; web-share *; encrypted-media *; accelerometer *; gyroscope *; screen-wake-lock *";
+
 // 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) => {
@@ -445,7 +481,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,
@@ -502,8 +538,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,
@@ -518,7 +555,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" });
@@ -836,7 +873,7 @@ var PlayruoEmbed = ({
       {
         ref: iframeRef,
         src,
-        allow: "cross-origin-isolated; fullscreen *; autoplay *; gamepad *; clipboard-write *; web-share *; encrypted-media *; accelerometer *; gyroscope *",
+        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",
@@ -856,7 +893,7 @@ var PlayruoEmbed = ({
         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" });
         }
       }
     )
@@ -2129,26 +2166,15 @@ 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,
+  PLAYRUO_IFRAME_ALLOW,
   PLAYRUO_UUID_STORAGE_KEY,
   PlayruoEmbed,
   buildEmbedUrl,
   isPlayruoEmbedMessage,
   isPlayruoInternalMessage,
+  normalizePlayruoError,
   resolveVisitorUuid
 });

package/dist/index.d.cts

@@ -1,6 +1,14 @@
 import { FC, ReactNode } from 'react';
 import * as react_jsx_runtime from 'react/jsx-runtime';
 
+/**
+ * iframe `allow` feature policy delegated to the Playruo player.
+ * Must stay aligned with the webapp embed harness (`front/scripts/embed-host/host.js`)
+ * and `next.config.ts` Permissions-Policy. `screen-wake-lock` is required so the
+ * framed player can hold a Wake Lock while streaming.
+ */
+declare const PLAYRUO_IFRAME_ALLOW = "cross-origin-isolated; fullscreen *; autoplay *; gamepad *; clipboard-write *; web-share *; encrypted-media *; accelerometer *; gyroscope *; screen-wake-lock *";
+
 interface PlayruoEmbedState {
     hasPlayedOnce: boolean;
     tryNow: {
@@ -41,12 +49,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;
@@ -196,7 +227,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. */
@@ -265,4 +296,4 @@ declare const PLAYRUO_UUID_STORAGE_KEY = "playruo_uuid";
  */
 declare const resolveVisitorUuid: (clientFingerprint?: string) => string;
 
-export { type DemoCompletedPayload, EmbedTester, type EmbedTesterProps, 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,6 +1,14 @@
 import { FC, ReactNode } from 'react';
 import * as react_jsx_runtime from 'react/jsx-runtime';
 
+/**
+ * iframe `allow` feature policy delegated to the Playruo player.
+ * Must stay aligned with the webapp embed harness (`front/scripts/embed-host/host.js`)
+ * and `next.config.ts` Permissions-Policy. `screen-wake-lock` is required so the
+ * framed player can hold a Wake Lock while streaming.
+ */
+declare const PLAYRUO_IFRAME_ALLOW = "cross-origin-isolated; fullscreen *; autoplay *; gamepad *; clipboard-write *; web-share *; encrypted-media *; accelerometer *; gyroscope *; screen-wake-lock *";
+
 interface PlayruoEmbedState {
     hasPlayedOnce: boolean;
     tryNow: {
@@ -41,12 +49,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;
@@ -196,7 +227,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. */
@@ -265,4 +296,4 @@ declare const PLAYRUO_UUID_STORAGE_KEY = "playruo_uuid";
  */
 declare const resolveVisitorUuid: (clientFingerprint?: string) => string;
 
-export { type DemoCompletedPayload, EmbedTester, type EmbedTesterProps, 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

@@ -1,6 +1,40 @@
+// src/iframe-allow.ts
+var PLAYRUO_IFRAME_ALLOW = "cross-origin-isolated; fullscreen *; autoplay *; gamepad *; clipboard-write *; web-share *; encrypted-media *; accelerometer *; gyroscope *; screen-wake-lock *";
+
 // 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) => {
@@ -403,7 +437,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,
@@ -460,8 +494,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,
@@ -476,7 +511,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" });
@@ -794,7 +829,7 @@ var PlayruoEmbed = ({
       {
         ref: iframeRef,
         src,
-        allow: "cross-origin-isolated; fullscreen *; autoplay *; gamepad *; clipboard-write *; web-share *; encrypted-media *; accelerometer *; gyroscope *",
+        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",
@@ -814,7 +849,7 @@ var PlayruoEmbed = ({
         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" });
         }
       }
     )
@@ -2087,25 +2122,14 @@ 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,
   PLAYRUO_UUID_STORAGE_KEY,
   PlayruoEmbed,
   buildEmbedUrl,
   isPlayruoEmbedMessage,
   isPlayruoInternalMessage,
+  normalizePlayruoError,
   resolveVisitorUuid
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@playruo/embed",
-  "version": "1.5.0",
+  "version": "1.7.0",
   "description": "React SDK to embed Playruo with postMessage API.",
   "license": "MIT",
   "type": "module",