@final-commerce/command-frame 0.1.51 → 0.1.52

package/dist/actions/extension-refund/extension-refund-listener.d.ts

@@ -1,9 +1,9 @@
 import type { ExtensionRefundParams, ExtensionRefundResponse } from "./types";
 /**
  * Install a message listener in the **extension iframe** so the host can request refunds.
- * Validates `event.source === window.parent` before handling.
+ * Validates `event.source === window.top` before handling.
  *
- * Replies with {@link PostMessageResponse}, using `event.origin` as the target origin when posting back to the parent.
+ * Replies with {@link PostMessageResponse}, using `event.origin` as the target origin when posting back to the host.
  *
  * @param handler - Perform the extension-side refund (API call, etc.)
  * @returns Unsubscribe function

package/dist/actions/extension-refund/extension-refund-listener.js

@@ -4,9 +4,9 @@ function isRecord(value) {
 }
 /**
  * Install a message listener in the **extension iframe** so the host can request refunds.
- * Validates `event.source === window.parent` before handling.
+ * Validates `event.source === window.top` before handling.
  *
- * Replies with {@link PostMessageResponse}, using `event.origin` as the target origin when posting back to the parent.
+ * Replies with {@link PostMessageResponse}, using `event.origin` as the target origin when posting back to the host.
  *
  * @param handler - Perform the extension-side refund (API call, etc.)
  * @returns Unsubscribe function
@@ -21,7 +21,7 @@ export function installExtensionRefundListener(handler) {
         if (typeof requestId !== "string") {
             return;
         }
-        if (event.source !== window.parent || !event.source) {
+        if (event.source !== window.top || !event.source) {
             return;
         }
         const source = event.source;

package/dist/client.d.ts

@@ -1,6 +1,6 @@
 /**
  * Command Frame Client for iframe communication
- * Allows the iframe to call functions on the parent window via postMessage
+ * Allows the iframe to call functions on the host (top) window via postMessage
  */
 export interface PostMessageRequest<T = any> {
     action: string;

package/dist/client.js

@@ -1,6 +1,6 @@
 /**
  * Command Frame Client for iframe communication
- * Allows the iframe to call functions on the parent window via postMessage
+ * Allows the iframe to call functions on the host (top) window via postMessage
  */
 export class CommandFrameClient {
     constructor(options = {}) {
@@ -14,7 +14,7 @@ export class CommandFrameClient {
         this.mockRegistry = options.mockRegistry || {};
         // If running standalone (no parent window), force Mock Mode immediately
         // This prevents the 2s delay and ensures immediate response in dev/standalone mode
-        if (typeof window !== 'undefined' && (!window.parent || window.parent === window)) {
+        if (typeof window !== 'undefined' && (!window.top || window.top === window)) {
             if (this.isDebugEnabled()) {
                 console.log("[ActionsClient] Standalone mode detected. Enabling Mock Mode immediately.");
             }
@@ -118,15 +118,15 @@ export class CommandFrameClient {
                     timestamp: new Date().toISOString()
                 });
             }
-            if (typeof window !== 'undefined' && window.parent) {
-                window.parent.postMessage(message, this.origin);
+            if (typeof window !== 'undefined' && window.top) {
+                window.top.postMessage(message, this.origin);
             }
             else {
                 clearTimeout(timeoutHandle);
                 this.pendingRequests.delete(requestId);
-                const error = new Error("No parent window found. This app must run in an iframe.");
+                const error = new Error("No host window found. This app must run in an iframe.");
                 if (this.isDebugEnabled()) {
-                    console.error("[ActionsClient] No parent window", error);
+                    console.error("[ActionsClient] No host window", error);
                 }
                 reject(error);
             }
@@ -135,7 +135,7 @@ export class CommandFrameClient {
     // Private check to determine environment
     detectContext() {
         return new Promise((resolve) => {
-            if (typeof window === 'undefined' || !window.parent || window.parent === window)
+            if (typeof window === 'undefined' || !window.top || window.top === window)
                 return resolve(null);
             const requestId = this.generateRequestId();
             const timeout = setTimeout(() => {
@@ -148,7 +148,7 @@ export class CommandFrameClient {
                 timeout
             });
             try {
-                window.parent.postMessage({ action: "getFinalContext", requestId }, this.origin);
+                window.top.postMessage({ action: "getFinalContext", requestId }, this.origin);
             }
             catch {
                 clearTimeout(timeout);

package/dist/hooks/index.js

@@ -11,8 +11,8 @@ function getOrigin() {
 function register(topic, callback, options) {
     const hookId = options.hookId;
     const functionBody = callback.toString();
-    if (typeof window !== "undefined" && window.parent && window.parent !== window) {
-        window.parent.postMessage({
+    if (typeof window !== "undefined" && window.top && window.top !== window) {
+        window.top.postMessage({
             type: "hook-register",
             topic,
             functionBody,
@@ -26,8 +26,8 @@ function register(topic, callback, options) {
  * Unregister a hook by ID. Sends a message to the host to remove the hook.
  */
 function unregister(hookId) {
-    if (typeof window !== "undefined" && window.parent && window.parent !== window) {
-        window.parent.postMessage({
+    if (typeof window !== "undefined" && window.top && window.top !== window) {
+        window.top.postMessage({
             type: "hook-unregister",
             hookId
         }, getOrigin());

package/dist/pubsub/subscriber.js

@@ -12,8 +12,8 @@ export class TopicSubscriber {
         this.origin = options.origin || "*";
         this.debug = options.debug ?? false;
         this.useGlobalDebug = options.debug === undefined;
-        // Detect standalone mode (no parent iframe)
-        if (typeof window !== 'undefined' && (!window.parent || window.parent === window)) {
+        // Detect standalone mode (not inside any iframe)
+        if (typeof window !== 'undefined' && (!window.top || window.top === window)) {
             this.mockMode = true;
             if (this.isDebugEnabled()) {
                 console.log("[TopicSubscriber] Mock Mode enabled (standalone mode detected)");
@@ -70,7 +70,7 @@ export class TopicSubscriber {
      * Request the list of available topics from the host
      */
     requestTopics() {
-        if (typeof window !== "undefined" && window.parent && window.parent !== window) {
+        if (typeof window !== "undefined" && window.top && window.top !== window) {
             const message = {
                 type: "pubsub-request-topics",
                 requestId: `topics_${Date.now()}_${Math.random().toString(36).substr(2, 9)}`
@@ -78,7 +78,7 @@ export class TopicSubscriber {
             if (this.isDebugEnabled()) {
                 console.log("[TopicSubscriber] Requesting topics list", message);
             }
-            window.parent.postMessage(message, this.origin);
+            window.top.postMessage(message, this.origin);
         }
     }
     /**
@@ -177,7 +177,7 @@ export class TopicSubscriber {
      * Notify host about subscription changes
      */
     notifySubscription(topic, isSubscribed) {
-        if (typeof window !== "undefined" && window.parent && window.parent !== window) {
+        if (typeof window !== "undefined" && window.top && window.top !== window) {
             const message = {
                 type: isSubscribed ? "pubsub-subscribe" : "pubsub-unsubscribe",
                 topic,
@@ -186,7 +186,7 @@ export class TopicSubscriber {
             if (this.isDebugEnabled()) {
                 console.log("[TopicSubscriber] Notifying subscription change", message);
             }
-            window.parent.postMessage(message, this.origin);
+            window.top.postMessage(message, this.origin);
         }
     }
     /**
@@ -203,7 +203,7 @@ export class TopicSubscriber {
             return;
         }
         const data = event.data;
-        // Clear detection timeout on first valid message from parent
+        // Clear detection timeout on first valid message from host
         if (this.detectionTimeout && data && (data.type === "pubsub-event" || data.type === "pubsub-topics-list")) {
             clearTimeout(this.detectionTimeout);
             this.detectionTimeout = undefined;

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@final-commerce/command-frame",
-    "version": "0.1.51",
+    "version": "0.1.52",
     "description": "Commands Frame library",
     "main": "dist/index.js",
     "types": "dist/index.d.ts",