fix(vom): surface incomplete iframe geometry in observations

apps/extension/src/tools/geometry/coordinate-types.ts

@@ -18,6 +18,24 @@ export interface SnapshotProjection {
   geometry: GeometryProjection;
 }
 
+/** A failed owner read is different from a successfully projected, clipped-out rect. */
+export interface UnavailableFrameProjection {
+  status: "unavailable";
+  source: CoordinateOwner;
+  ownerBackendNodeId: number;
+}
+
+export type SnapshotProjectionResult =
+  | { status: "available"; projection: SnapshotProjection }
+  | UnavailableFrameProjection;
+
+/** Descendants inherit the failed boundary without attempting another owner read. */
+export type FrameProjectionIssue =
+  | UnavailableFrameProjection
+  | { status: "blocked"; source: CoordinateOwner; cause: UnavailableFrameProjection };
+
+export type FrameProjectionState = SnapshotProjectionResult | FrameProjectionIssue;
+
 /** DOMSnapshot bounds are document-relative CSS pixels, independent of raster DPR. */
 export function snapshotViewportRect(
   bounds: number[],

apps/extension/src/tools/geometry/frame-context.ts

@@ -13,7 +13,7 @@ import {
   type Size,
 } from "../geometry";
 import { type CdpRunner, sendToCdpTarget } from "../shared";
-import type { CoordinateOwner, CssViewport, SnapshotProjection } from "./coordinate-types";
+import type { CoordinateOwner, CssViewport, SnapshotProjectionResult } from "./coordinate-types";
 
 export interface LayoutMetrics {
   cssVisualViewport?: { zoom?: number };
@@ -149,30 +149,41 @@ export class GeometryContext {
     ownerBackendNodeId: number,
     ancestorClips: Polygon[],
     viewport: Size,
-  ): Promise<SnapshotProjection | null> {
+  ): Promise<SnapshotProjectionResult> {
     const key = `${cdpTargetKey(source.target)}:${ownerBackendNodeId}`;
     let promise = this.snapshotOwners.get(key);
     if (!promise) {
       promise = this.snapshotOwner(source.target, ownerBackendNodeId);
       this.snapshotOwners.set(key, promise);
     }
-    const owner = await promise;
+    let owner: { quad: Quad; size: Size } | null;
+    try {
+      owner = await promise;
+    } catch (error) {
+      if (error && typeof error === "object" && "name" in error && error.name === "AbortError")
+        throw error;
+      console.debug("[bsk geometry] frame owner unavailable", error);
+      owner = null;
+    }
     return owner
       ? {
-          source,
-          geometry: {
-            sourceClips: [],
-            edges: [
-              {
-                sourceViewport: owner.size,
-                destinationQuad: owner.quad,
-                destinationClips: ancestorClips,
-              },
-            ],
-            topViewport: viewport,
+          status: "available",
+          projection: {
+            source,
+            geometry: {
+              sourceClips: [],
+              edges: [
+                {
+                  sourceViewport: owner.size,
+                  destinationQuad: owner.quad,
+                  destinationClips: ancestorClips,
+                },
+              ],
+              topViewport: viewport,
+            },
           },
         }
-      : null;
+      : { status: "unavailable", source, ownerBackendNodeId };
   }
 
   private async snapshotOwner(