bunite-core 0.14.0 → 0.17.0

package/src/webview/polyfill.ts

@@ -1,6 +1,6 @@
 // Iframe fallback for web (no-op if native already registered). HTMLElement deref'd lazily so module is import-safe in Node/Bun.
 
-import type { SurfaceEvent } from "../rpc/framework";
+import type { SurfaceEvent, SurfaceEventBase } from "../rpc/framework";
 
 // Default sandbox omits allow-same-origin / allow-top-navigation / allow-modals /
 // allow-popups-to-escape-sandbox — popup escape stays opt-in so a sandboxed page
@@ -31,6 +31,12 @@ function definePolyfillClass(): CustomElementConstructor {
     private _iframe: HTMLIFrameElement | null = null;
     private _titleObserver: MutationObserver | null = null;
     private _lastTitle: string = "";
+    private _epoch: number = 0;
+    private _isLoading: boolean = false;
+    private _currentUrl: string = "";
+    // Local history stack for goBack — cross-origin contentWindow.history is
+    // inaccessible, so we track navigations ourselves.
+    private _history: string[] = [];
 
     private isReachable(): boolean {
       if (!this._iframe) return false;
@@ -50,8 +56,22 @@ function definePolyfillClass(): CustomElementConstructor {
       };
     }
 
-    private emit(event: SurfaceEvent) {
-      this.dispatchEvent(new CustomEvent<SurfaceEvent>("surface-event", { detail: event }));
+    private emit(event: SurfaceEventBase) {
+      if (event.type === "navigate") {
+        this._epoch++;
+        // Avoid pushing duplicate / same-as-top entries (reload doesn't grow history).
+        if (this._currentUrl && this._currentUrl !== event.url &&
+            this._history[this._history.length - 1] !== this._currentUrl) {
+          this._history.push(this._currentUrl);
+        }
+        this._currentUrl = event.url;
+      } else if (event.type === "load-start") {
+        this._isLoading = true;
+      } else if (event.type === "load-finish" || event.type === "load-fail") {
+        this._isLoading = false;
+      }
+      const stamped: SurfaceEvent = { ...event, epoch: this._epoch };
+      this.dispatchEvent(new CustomEvent<SurfaceEvent>("surface-event", { detail: stamped }));
     }
 
     private setupTitleObserver() {
@@ -100,6 +120,7 @@ function definePolyfillClass(): CustomElementConstructor {
           this.dispatchBlocked(src);
         } else {
           iframe.src = src;
+          this._currentUrl = src;
           this.emit({ type: "load-start", url: src });
         }
       }
@@ -112,8 +133,9 @@ function definePolyfillClass(): CustomElementConstructor {
         // Suppress the spurious about:blank load that fires after a blocked
         // navigation (or before any explicit navigate).
         if (isBlockedSrc(url)) return;
-        this.emit({ type: "load-finish", url });
+        // navigate first so load-finish carries the bumped epoch.
         this.emit({ type: "navigate", url });
+        this.emit({ type: "load-finish", url });
         this.setupTitleObserver();
       });
 
@@ -148,19 +170,22 @@ function definePolyfillClass(): CustomElementConstructor {
     }
 
     goBack() {
-      try {
-        this._iframe?.contentWindow?.history.back();
-      } catch {}
+      // Same-origin path uses native history. Cross-origin throws → fall back
+      // to our tracked stack (push on every navigate; pop here).
+      try { this._iframe?.contentWindow?.history.back(); return; } catch {}
+      const prev = this._history.pop();
+      if (prev && this._iframe) this._iframe.src = prev;
     }
 
     reload() {
-      try {
-        this._iframe?.contentWindow?.location.reload();
-      } catch {
-        if (this._iframe) {
-          this._iframe.src = this._iframe.src;
-        }
-      }
+      try { this._iframe?.contentWindow?.location.reload(); return; } catch {}
+      // Cross-origin fallback: reassigning the same src is a no-op in WHATWG;
+      // cycle via about:blank to force a fresh navigation.
+      const iframe = this._iframe;
+      if (!iframe) return;
+      const url = this._currentUrl || iframe.src;
+      iframe.src = "about:blank";
+      requestAnimationFrame(() => { if (this._iframe) this._iframe.src = url; });
     }
 
     setHidden(hidden: boolean) {
@@ -219,6 +244,54 @@ function definePolyfillClass(): CustomElementConstructor {
       target.dispatchEvent(new MouseEvent("click", init));
     }
 
+    async resolveAndClick(_selector: string, _opts?: unknown) {
+      return { ok: false as const, code: "not_supported" as const, message: "polyfill iframe: atomic resolveAndClick not supported" };
+    }
+
+    async getBoundingRect(selector: string, _opts?: unknown) {
+      if (!this.isReachable()) return { ok: false as const, code: "not_supported" as const, message: "iframe not reachable" };
+      try {
+        const el = this._iframe!.contentDocument!.querySelector(selector) as Element | null;
+        if (!el) return { ok: false as const, code: "not_found" as const, message: `selector ${selector} not found` };
+        const r = el.getBoundingClientRect();
+        const win = this._iframe!.contentWindow!;
+        const visible = r.width > 0 && r.height > 0 && r.bottom > 0 && r.right > 0
+                       && r.top < win.innerHeight && r.left < win.innerWidth;
+        return { ok: true as const, rect: { x: r.x, y: r.y, width: r.width, height: r.height }, visible };
+      } catch (e: any) {
+        const code = e?.name === "SecurityError" ? "cross_origin" as const : "runtime_error" as const;
+        return { ok: false as const, code, message: e?.message ?? String(e) };
+      }
+    }
+
+    async listFrames() {
+      return { ok: false as const, code: "not_supported" as const, message: "polyfill: not implemented" };
+    }
+
+    async accessibilitySnapshot(_opts?: unknown) {
+      return { ok: false as const, code: "not_supported" as const, message: "polyfill: not implemented" };
+    }
+
+    async setDownloadPolicy(_policy: unknown, _dir?: unknown) {
+      // No-op — iframe has no download lifecycle hook.
+    }
+
+    async waitForDownload(_opts?: unknown) {
+      return { ok: false as const, code: "not_supported" as const, message: "polyfill: not implemented" };
+    }
+
+    async acceptPopup(_opts?: unknown) {
+      return { ok: false as const, code: "not_found" as const, message: "polyfill: no popup orchestration" };
+    }
+
+    async dismissPopup(_id?: unknown) {
+      // No-op.
+    }
+
+    async extendAdoptionTimeout(_id?: unknown, _ms?: unknown) {
+      return { ok: false as const, code: "not_found" as const, message: "polyfill: no popup orchestration" };
+    }
+
     async sendType(text: string) {
       if (!this.isReachable()) return;
       const doc = this._iframe!.contentDocument!;
@@ -313,6 +386,10 @@ function definePolyfillClass(): CustomElementConstructor {
       return [] as { level: string; args: string[]; ts: number }[];
     }
 
+    async getNavigationState() {
+      return { lastLoadEpoch: this._epoch, isLoading: this._isLoading, currentUrl: this._currentUrl };
+    }
+
     async screenshot(_args?: { format?: "png" | "jpeg"; quality?: number }) {
       return { ok: false as const, code: "not_supported" as const, message: "iframe polyfill does not support screenshot" };
     }