@browserbasehq/orca 3.1.0-patch.0 → 3.1.0-patch.2

package/dist/cjs/tests/snapshot-capture-orchestration.test.js

@@ -0,0 +1,403 @@
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var import_vitest = require("vitest");
+var capture = __toESM(require("../lib/v3/understudy/a11y/snapshot/capture.js"), 1);
+var a11yTree = __toESM(require("../lib/v3/understudy/a11y/snapshot/a11yTree.js"), 1);
+var domTree = __toESM(require("../lib/v3/understudy/a11y/snapshot/domTree.js"), 1);
+var focusSelectors = __toESM(require("../lib/v3/understudy/a11y/snapshot/focusSelectors.js"), 1);
+var import_mockCDPSession = require("./helpers/mockCDPSession.js");
+const makeProtocolFrame = (id) => ({
+  id,
+  loaderId: `${id}-loader`,
+  url: "https://example.com",
+  securityOrigin: "https://example.com",
+  mimeType: "text/html"
+});
+const makeFrameTree = (id, children = []) => ({
+  frame: makeProtocolFrame(id),
+  childFrames: children
+});
+const makePage = (overrides = {}) => {
+  const defaultSession = new import_mockCDPSession.MockCDPSession({}, "default-session");
+  const base = {
+    mainFrameId: () => "frame-1",
+    asProtocolFrameTree: () => makeFrameTree("frame-1"),
+    listAllFrameIds: () => ["frame-1"],
+    getSessionForFrame: () => defaultSession,
+    getOrdinal: () => 0
+  };
+  return { ...base, ...overrides };
+};
+const makeSessionIndex = () => ({
+  rootBackend: 100,
+  absByBe: /* @__PURE__ */ new Map([
+    [100, "/"],
+    [101, "/html[1]"],
+    [102, "/html[1]/body[1]"],
+    [150, "/html[1]/body[1]/iframe[1]"],
+    [200, "/html[1]/body[1]/iframe[1]"],
+    [201, "/html[1]/body[1]/iframe[1]/div[1]"]
+  ]),
+  tagByBe: /* @__PURE__ */ new Map([
+    [100, "#document"],
+    [101, "html"],
+    [102, "body"],
+    [150, "iframe"],
+    [200, "#document"],
+    [201, "div"]
+  ]),
+  scrollByBe: /* @__PURE__ */ new Map([[201, true]]),
+  docRootOf: /* @__PURE__ */ new Map([
+    [100, 100],
+    [101, 100],
+    [102, 100],
+    [150, 100],
+    [200, 200],
+    [201, 200]
+  ]),
+  contentDocRootByIframe: /* @__PURE__ */ new Map([[150, 200]])
+});
+(0, import_vitest.beforeEach)(() => {
+  import_vitest.vi.restoreAllMocks();
+});
+(0, import_vitest.describe)("buildFrameContext", () => {
+  (0, import_vitest.it)("indexes parent relationships from the frame tree", () => {
+    const frameTree = makeFrameTree("frame-1", [
+      makeFrameTree("frame-2", [makeFrameTree("frame-3")]),
+      makeFrameTree("frame-4")
+    ]);
+    const page = makePage({
+      asProtocolFrameTree: () => frameTree,
+      listAllFrameIds: () => ["frame-1", "frame-2", "frame-3", "frame-4"]
+    });
+    const context = capture.buildFrameContext(page);
+    (0, import_vitest.expect)(context.rootId).toBe("frame-1");
+    (0, import_vitest.expect)(context.frames).toEqual([
+      "frame-1",
+      "frame-2",
+      "frame-3",
+      "frame-4"
+    ]);
+    (0, import_vitest.expect)(context.parentByFrame.get("frame-1")).toBeNull();
+    (0, import_vitest.expect)(context.parentByFrame.get("frame-2")).toBe("frame-1");
+    (0, import_vitest.expect)(context.parentByFrame.get("frame-3")).toBe("frame-2");
+    (0, import_vitest.expect)(context.parentByFrame.get("frame-4")).toBe("frame-1");
+  });
+});
+(0, import_vitest.describe)("buildSessionIndexes", () => {
+  (0, import_vitest.it)("deduplicates frames that share the same CDP session id", async () => {
+    const session = new import_mockCDPSession.MockCDPSession({}, "session-a");
+    const page = makePage({
+      // Every frame lookup returns the same session instance, so buildSessionIndexes
+      // should call buildSessionDomIndex only once and reuse the result.
+      getSessionForFrame: () => session
+    });
+    const idx = makeSessionIndex();
+    const spy = import_vitest.vi.spyOn(domTree, "buildSessionDomIndex").mockResolvedValue(idx);
+    const result = await capture.buildSessionIndexes(
+      page,
+      ["frame-1", "frame-2"],
+      true
+    );
+    (0, import_vitest.expect)(spy).toHaveBeenCalledTimes(1);
+    (0, import_vitest.expect)(spy).toHaveBeenCalledWith(session, true);
+    (0, import_vitest.expect)(result.get("session-a")).toBe(idx);
+  });
+  (0, import_vitest.it)("builds indexes for sessions without ids using the 'root' key", async () => {
+    const sessionWithoutId = {
+      id: void 0,
+      async send(_method, _params) {
+        return {};
+      },
+      on() {
+      },
+      off() {
+      },
+      async close() {
+      }
+    };
+    const sessionWithId = new import_mockCDPSession.MockCDPSession({}, "child-session");
+    const page = makePage({
+      getSessionForFrame: (frameId) => frameId === "frame-1" ? sessionWithoutId : sessionWithId
+    });
+    const idxA = makeSessionIndex();
+    const idxB = makeSessionIndex();
+    const spy = import_vitest.vi.spyOn(domTree, "buildSessionDomIndex").mockResolvedValueOnce(idxA).mockResolvedValueOnce(idxB);
+    const result = await capture.buildSessionIndexes(
+      page,
+      ["frame-1", "frame-2"],
+      false
+    );
+    (0, import_vitest.expect)(spy).toHaveBeenNthCalledWith(1, sessionWithoutId, false);
+    (0, import_vitest.expect)(spy).toHaveBeenNthCalledWith(2, sessionWithId, false);
+    (0, import_vitest.expect)(result.get("root")).toBe(idxA);
+    (0, import_vitest.expect)(result.get("child-session")).toBe(idxB);
+  });
+});
+(0, import_vitest.describe)("collectPerFrameMaps", () => {
+  (0, import_vitest.it)("builds per-frame xpath/tag maps and outlines from a shared session index", async () => {
+    const session = new import_mockCDPSession.MockCDPSession(
+      {
+        "DOM.getFrameOwner": async () => ({ backendNodeId: 150 })
+      },
+      "session-a"
+    );
+    const page = makePage({
+      getSessionForFrame: () => session,
+      getOrdinal: (frameId) => frameId === "frame-1" ? 0 : 1
+    });
+    const context = {
+      rootId: "frame-1",
+      frames: ["frame-1", "frame-2"],
+      parentByFrame: /* @__PURE__ */ new Map([
+        ["frame-1", null],
+        ["frame-2", "frame-1"]
+      ])
+    };
+    const sessionIndex = makeSessionIndex();
+    const sessionToIndex = /* @__PURE__ */ new Map([[session.id, sessionIndex]]);
+    import_vitest.vi.spyOn(a11yTree, "a11yForFrame").mockImplementation(
+      async (_sess, frameId) => ({
+        outline: `outline-${frameId}`,
+        urlMap: { [`url-${frameId}`]: `https://${frameId}.test` },
+        scopeApplied: false
+      })
+    );
+    const result = await capture.collectPerFrameMaps(
+      page,
+      context,
+      sessionToIndex,
+      { experimental: true },
+      true,
+      context.frames
+    );
+    (0, import_vitest.expect)(result.perFrameOutlines).toEqual([
+      { frameId: "frame-1", outline: "outline-frame-1" },
+      { frameId: "frame-2", outline: "outline-frame-2" }
+    ]);
+    const rootMaps = result.perFrameMaps.get("frame-1");
+    (0, import_vitest.expect)(rootMaps?.xpathMap["0-100"]).toBe("/");
+    (0, import_vitest.expect)(rootMaps?.xpathMap["0-101"]).toBe("/html[1]");
+    (0, import_vitest.expect)(rootMaps?.xpathMap["0-102"]).toBe("/html[1]/body[1]");
+    const childMaps = result.perFrameMaps.get("frame-2");
+    (0, import_vitest.expect)(childMaps?.xpathMap["1-200"]).toBe("/");
+    (0, import_vitest.expect)(childMaps?.xpathMap["1-201"]).toBe("/div[1]");
+    (0, import_vitest.expect)(childMaps?.scrollableMap["1-201"]).toBe(true);
+    (0, import_vitest.expect)(childMaps?.urlMap).toEqual({
+      "url-frame-2": "https://frame-2.test"
+    });
+    (0, import_vitest.expect)(session.callsFor("DOM.getFrameOwner")).toHaveLength(1);
+  });
+  (0, import_vitest.it)("builds a missing session index on demand and memoizes it", async () => {
+    const session = new import_mockCDPSession.MockCDPSession({}, "new-session");
+    const page = makePage({
+      getSessionForFrame: () => session,
+      getOrdinal: () => 2
+    });
+    const context = {
+      rootId: "frame-9",
+      frames: ["frame-9"],
+      parentByFrame: /* @__PURE__ */ new Map([["frame-9", null]])
+    };
+    const idx = makeSessionIndex();
+    const buildSpy = import_vitest.vi.spyOn(domTree, "buildSessionDomIndex").mockResolvedValue(idx);
+    import_vitest.vi.spyOn(a11yTree, "a11yForFrame").mockResolvedValue({
+      outline: "outline",
+      urlMap: {},
+      scopeApplied: false
+    });
+    const sessionToIndex = /* @__PURE__ */ new Map();
+    const result = await capture.collectPerFrameMaps(
+      page,
+      context,
+      sessionToIndex,
+      void 0,
+      false,
+      context.frames
+    );
+    (0, import_vitest.expect)(buildSpy).toHaveBeenCalledWith(session, false);
+    (0, import_vitest.expect)(sessionToIndex.get("new-session")).toBe(idx);
+    (0, import_vitest.expect)(result.perFrameMaps.get("frame-9")?.xpathMap["2-100"]).toBe("/");
+  });
+  (0, import_vitest.it)("skips frames that are not listed in the frameIds argument", async () => {
+    const session = new import_mockCDPSession.MockCDPSession({}, "session-a");
+    const page = makePage({
+      getSessionForFrame: () => session,
+      getOrdinal: (frameId) => frameId === "frame-1" ? 0 : 1
+    });
+    const context = {
+      rootId: "frame-1",
+      frames: ["frame-1", "frame-2"],
+      parentByFrame: /* @__PURE__ */ new Map([
+        ["frame-1", null],
+        ["frame-2", "frame-1"]
+      ])
+    };
+    const sessionIndex = makeSessionIndex();
+    const sessionToIndex = /* @__PURE__ */ new Map([[session.id, sessionIndex]]);
+    const a11ySpy = import_vitest.vi.spyOn(a11yTree, "a11yForFrame").mockResolvedValue({
+      outline: "outline",
+      urlMap: {},
+      scopeApplied: false
+    });
+    const result = await capture.collectPerFrameMaps(
+      page,
+      context,
+      sessionToIndex,
+      void 0,
+      true,
+      ["frame-1"]
+    );
+    (0, import_vitest.expect)(a11ySpy).toHaveBeenCalledTimes(1);
+    (0, import_vitest.expect)(result.perFrameMaps.has("frame-2")).toBe(false);
+    (0, import_vitest.expect)(result.perFrameOutlines.map((o) => o.frameId)).toEqual(["frame-1"]);
+  });
+});
+(0, import_vitest.describe)("captureHybridSnapshot", () => {
+  (0, import_vitest.it)("returns early when the scoped snapshot path succeeds", async () => {
+    const session = new import_mockCDPSession.MockCDPSession({}, "session-a");
+    const page = makePage({
+      getSessionForFrame: () => session
+    });
+    const options = { focusSelector: "/html" };
+    import_vitest.vi.spyOn(focusSelectors, "resolveFocusFrameAndTail").mockResolvedValue({
+      targetFrameId: "frame-1",
+      tailXPath: "",
+      absPrefix: ""
+    });
+    const domMapsSpy = import_vitest.vi.spyOn(domTree, "domMapsForSession").mockResolvedValue({
+      tagNameMap: { "0-100": "#document" },
+      xpathMap: { "0-100": "/" },
+      scrollableMap: {}
+    });
+    const a11ySpy = import_vitest.vi.spyOn(a11yTree, "a11yForFrame").mockResolvedValue({
+      outline: "scoped outline",
+      urlMap: { "0-100": "https://frame-1.test" },
+      scopeApplied: true
+    });
+    const buildIndexSpy = import_vitest.vi.spyOn(domTree, "buildSessionDomIndex").mockImplementation(() => {
+      throw new Error("should not build session index when scoped");
+    });
+    const result = await capture.captureHybridSnapshot(page, options);
+    (0, import_vitest.expect)(result.combinedTree).toBe("scoped outline");
+    (0, import_vitest.expect)(result.combinedUrlMap["0-100"]).toBe("https://frame-1.test");
+    (0, import_vitest.expect)(domMapsSpy).toHaveBeenCalled();
+    (0, import_vitest.expect)(a11ySpy).toHaveBeenCalled();
+    (0, import_vitest.expect)(buildIndexSpy).not.toHaveBeenCalled();
+  });
+  (0, import_vitest.it)("scoped snapshot still succeeds when iframe inclusion is disabled", async () => {
+    const session = new import_mockCDPSession.MockCDPSession({}, "session-a");
+    const page = makePage({
+      getSessionForFrame: () => session
+    });
+    const options = { focusSelector: "/html", includeIframes: false };
+    import_vitest.vi.spyOn(focusSelectors, "resolveFocusFrameAndTail").mockResolvedValue({
+      targetFrameId: "frame-1",
+      tailXPath: "",
+      absPrefix: ""
+    });
+    const domMapsSpy = import_vitest.vi.spyOn(domTree, "domMapsForSession").mockResolvedValue({
+      tagNameMap: { "0-100": "#document" },
+      xpathMap: { "0-100": "/" },
+      scrollableMap: {}
+    });
+    const a11ySpy = import_vitest.vi.spyOn(a11yTree, "a11yForFrame").mockResolvedValue({
+      outline: "scoped outline",
+      urlMap: { "0-100": "https://frame-1.test" },
+      scopeApplied: true
+    });
+    const buildIndexSpy = import_vitest.vi.spyOn(domTree, "buildSessionDomIndex").mockImplementation(() => {
+      throw new Error("should not build session index when scoped");
+    });
+    const result = await capture.captureHybridSnapshot(page, options);
+    (0, import_vitest.expect)(result.combinedTree).toBe("scoped outline");
+    (0, import_vitest.expect)(result.combinedUrlMap["0-100"]).toBe("https://frame-1.test");
+    (0, import_vitest.expect)(domMapsSpy).toHaveBeenCalled();
+    (0, import_vitest.expect)(a11ySpy).toHaveBeenCalled();
+    (0, import_vitest.expect)(buildIndexSpy).not.toHaveBeenCalled();
+  });
+  (0, import_vitest.it)("collects per-frame data and merges it when no scoped snapshot is available", async () => {
+    const session = new import_mockCDPSession.MockCDPSession(
+      {
+        "DOM.getFrameOwner": async () => ({ backendNodeId: 150 })
+      },
+      "session-a"
+    );
+    const page = makePage({
+      asProtocolFrameTree: () => makeFrameTree("frame-1", [makeFrameTree("frame-2")]),
+      listAllFrameIds: () => ["frame-1", "frame-2"],
+      getSessionForFrame: () => session,
+      getOrdinal: (frameId) => frameId === "frame-1" ? 0 : 1
+    });
+    const idx = makeSessionIndex();
+    import_vitest.vi.spyOn(domTree, "buildSessionDomIndex").mockResolvedValue(idx);
+    import_vitest.vi.spyOn(a11yTree, "a11yForFrame").mockImplementation(
+      async (_sess, frameId) => ({
+        outline: frameId === "frame-1" ? "[0-150] iframe host" : "[1-200] child subtree",
+        urlMap: { [`url-${frameId}`]: `https://${frameId}.test` },
+        scopeApplied: false
+      })
+    );
+    const snapshot = await capture.captureHybridSnapshot(page);
+    (0, import_vitest.expect)(snapshot.combinedTree).toContain("[1-200] child subtree");
+    (0, import_vitest.expect)(snapshot.combinedXpathMap["0-100"]).toBe("/");
+    (0, import_vitest.expect)(snapshot.combinedXpathMap["1-201"]).toBe(
+      "/html[1]/body[1]/iframe[1]/div[1]"
+    );
+    (0, import_vitest.expect)(snapshot.combinedUrlMap["url-frame-2"]).toBe("https://frame-2.test");
+    (0, import_vitest.expect)(snapshot.perFrame?.map((pf) => pf.frameId)).toEqual([
+      "frame-1",
+      "frame-2"
+    ]);
+  });
+  (0, import_vitest.it)("omits iframe frames when includeIframes is false", async () => {
+    const session = new import_mockCDPSession.MockCDPSession(
+      {
+        "DOM.getFrameOwner": async () => ({ backendNodeId: 150 })
+      },
+      "session-a"
+    );
+    const page = makePage({
+      asProtocolFrameTree: () => makeFrameTree("frame-1", [makeFrameTree("frame-2")]),
+      listAllFrameIds: () => ["frame-1", "frame-2"],
+      getSessionForFrame: () => session,
+      getOrdinal: (frameId) => frameId === "frame-1" ? 0 : 1
+    });
+    const idx = makeSessionIndex();
+    import_vitest.vi.spyOn(domTree, "buildSessionDomIndex").mockResolvedValue(idx);
+    const a11ySpy = import_vitest.vi.spyOn(a11yTree, "a11yForFrame").mockImplementation(async (_sess, frameId) => ({
+      outline: frameId === "frame-1" ? "[0-150] iframe host" : "[1-200] child subtree",
+      urlMap: { [`url-${frameId}`]: `https://${frameId}.test` },
+      scopeApplied: false
+    }));
+    const snapshot = await capture.captureHybridSnapshot(page, {
+      includeIframes: false
+    });
+    (0, import_vitest.expect)(a11ySpy).toHaveBeenCalledTimes(1);
+    (0, import_vitest.expect)(session.callsFor("DOM.getFrameOwner")).toHaveLength(0);
+    (0, import_vitest.expect)(snapshot.perFrame?.map((pf) => pf.frameId)).toEqual(["frame-1"]);
+    (0, import_vitest.expect)(snapshot.combinedXpathMap["1-201"]).toBeUndefined();
+    (0, import_vitest.expect)(snapshot.combinedTree).not.toContain("[1-200] child subtree");
+  });
+});
+//# sourceMappingURL=snapshot-capture-orchestration.test.js.map

package/dist/cjs/tests/snapshot-capture-orchestration.test.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../tests/snapshot-capture-orchestration.test.ts"],
+  "sourcesContent": ["import type { Protocol } from \"devtools-protocol\";\nimport { beforeEach, describe, expect, it, vi } from \"vitest\";\nimport type { CDPSessionLike } from \"../lib/v3/understudy/cdp.js\";\nimport type { Page } from \"../lib/v3/understudy/page.js\";\nimport type {\n  FrameContext,\n  SessionDomIndex,\n} from \"../lib/v3/types/private/index.js\";\nimport * as capture from \"../lib/v3/understudy/a11y/snapshot/capture.js\";\nimport * as a11yTree from \"../lib/v3/understudy/a11y/snapshot/a11yTree.js\";\nimport * as domTree from \"../lib/v3/understudy/a11y/snapshot/domTree.js\";\nimport * as focusSelectors from \"../lib/v3/understudy/a11y/snapshot/focusSelectors.js\";\nimport { MockCDPSession } from \"./helpers/mockCDPSession.js\";\n\nconst makeProtocolFrame = (id: string): Protocol.Page.Frame =>\n  ({\n    id,\n    loaderId: `${id}-loader`,\n    url: \"https://example.com\",\n    securityOrigin: \"https://example.com\",\n    mimeType: \"text/html\",\n  }) as unknown as Protocol.Page.Frame;\n\nconst makeFrameTree = (\n  id: string,\n  children: Protocol.Page.FrameTree[] = [],\n): Protocol.Page.FrameTree => ({\n  frame: makeProtocolFrame(id),\n  childFrames: children,\n});\n\ntype PageStub = Pick<\n  Page,\n  | \"mainFrameId\"\n  | \"asProtocolFrameTree\"\n  | \"listAllFrameIds\"\n  | \"getSessionForFrame\"\n  | \"getOrdinal\"\n>;\n\nconst makePage = (overrides: Partial<PageStub> = {}): Page => {\n  const defaultSession = new MockCDPSession({}, \"default-session\");\n  const base: PageStub = {\n    mainFrameId: () => \"frame-1\",\n    asProtocolFrameTree: () => makeFrameTree(\"frame-1\"),\n    listAllFrameIds: () => [\"frame-1\"],\n    getSessionForFrame: () => defaultSession,\n    getOrdinal: () => 0,\n  };\n  return { ...base, ...overrides } as unknown as Page;\n};\n\nconst makeSessionIndex = (): SessionDomIndex => ({\n  rootBackend: 100,\n  absByBe: new Map([\n    [100, \"/\"],\n    [101, \"/html[1]\"],\n    [102, \"/html[1]/body[1]\"],\n    [150, \"/html[1]/body[1]/iframe[1]\"],\n    [200, \"/html[1]/body[1]/iframe[1]\"],\n    [201, \"/html[1]/body[1]/iframe[1]/div[1]\"],\n  ]),\n  tagByBe: new Map([\n    [100, \"#document\"],\n    [101, \"html\"],\n    [102, \"body\"],\n    [150, \"iframe\"],\n    [200, \"#document\"],\n    [201, \"div\"],\n  ]),\n  scrollByBe: new Map([[201, true]]),\n  docRootOf: new Map([\n    [100, 100],\n    [101, 100],\n    [102, 100],\n    [150, 100],\n    [200, 200],\n    [201, 200],\n  ]),\n  contentDocRootByIframe: new Map([[150, 200]]),\n});\n\nbeforeEach(() => {\n  vi.restoreAllMocks();\n});\n\ndescribe(\"buildFrameContext\", () => {\n  it(\"indexes parent relationships from the frame tree\", () => {\n    const frameTree = makeFrameTree(\"frame-1\", [\n      makeFrameTree(\"frame-2\", [makeFrameTree(\"frame-3\")]),\n      makeFrameTree(\"frame-4\"),\n    ]);\n    const page = makePage({\n      asProtocolFrameTree: () => frameTree,\n      listAllFrameIds: () => [\"frame-1\", \"frame-2\", \"frame-3\", \"frame-4\"],\n    });\n\n    const context = capture.buildFrameContext(page);\n\n    expect(context.rootId).toBe(\"frame-1\");\n    expect(context.frames).toEqual([\n      \"frame-1\",\n      \"frame-2\",\n      \"frame-3\",\n      \"frame-4\",\n    ]);\n    expect(context.parentByFrame.get(\"frame-1\")).toBeNull();\n    expect(context.parentByFrame.get(\"frame-2\")).toBe(\"frame-1\");\n    expect(context.parentByFrame.get(\"frame-3\")).toBe(\"frame-2\");\n    expect(context.parentByFrame.get(\"frame-4\")).toBe(\"frame-1\");\n  });\n});\n\ndescribe(\"buildSessionIndexes\", () => {\n  it(\"deduplicates frames that share the same CDP session id\", async () => {\n    const session = new MockCDPSession({}, \"session-a\");\n    const page = makePage({\n      // Every frame lookup returns the same session instance, so buildSessionIndexes\n      // should call buildSessionDomIndex only once and reuse the result.\n      getSessionForFrame: () => session,\n    });\n    const idx = makeSessionIndex();\n    const spy = vi\n      .spyOn(domTree, \"buildSessionDomIndex\")\n      .mockResolvedValue(idx);\n\n    const result = await capture.buildSessionIndexes(\n      page,\n      [\"frame-1\", \"frame-2\"],\n      true,\n    );\n\n    expect(spy).toHaveBeenCalledTimes(1); // only one DOM.getDocument per session id\n    expect(spy).toHaveBeenCalledWith(session, true);\n    expect(result.get(\"session-a\")).toBe(idx);\n  });\n\n  it(\"builds indexes for sessions without ids using the 'root' key\", async () => {\n    const sessionWithoutId: CDPSessionLike = {\n      id: undefined,\n      async send<R = unknown>(\n        _method: string,\n        _params?: Record<string, unknown>,\n      ): Promise<R> {\n        void _method;\n        void _params;\n        return {} as R;\n      },\n      on() {},\n      off() {},\n      async close() {},\n    };\n    const sessionWithId = new MockCDPSession({}, \"child-session\");\n    const page = makePage({\n      getSessionForFrame: (frameId: string) =>\n        frameId === \"frame-1\" ? sessionWithoutId : sessionWithId,\n    });\n\n    const idxA = makeSessionIndex();\n    const idxB = makeSessionIndex();\n    const spy = vi\n      .spyOn(domTree, \"buildSessionDomIndex\")\n      .mockResolvedValueOnce(idxA)\n      .mockResolvedValueOnce(idxB);\n\n    const result = await capture.buildSessionIndexes(\n      page,\n      [\"frame-1\", \"frame-2\"],\n      false,\n    );\n\n    // Verifies the helper invokes buildSessionDomIndex once for each unique session,\n    // keying anonymous sessions as \"root\" so downstream lookups remain stable.\n    expect(spy).toHaveBeenNthCalledWith(1, sessionWithoutId, false);\n    expect(spy).toHaveBeenNthCalledWith(2, sessionWithId, false);\n    expect(result.get(\"root\")).toBe(idxA);\n    expect(result.get(\"child-session\")).toBe(idxB);\n  });\n});\n\ndescribe(\"collectPerFrameMaps\", () => {\n  it(\"builds per-frame xpath/tag maps and outlines from a shared session index\", async () => {\n    const session = new MockCDPSession(\n      {\n        \"DOM.getFrameOwner\": async () => ({ backendNodeId: 150 }),\n      },\n      \"session-a\",\n    );\n    const page = makePage({\n      getSessionForFrame: () => session,\n      getOrdinal: (frameId: string) => (frameId === \"frame-1\" ? 0 : 1),\n    });\n    const context: FrameContext = {\n      rootId: \"frame-1\",\n      frames: [\"frame-1\", \"frame-2\"],\n      parentByFrame: new Map([\n        [\"frame-1\", null],\n        [\"frame-2\", \"frame-1\"],\n      ]),\n    };\n    const sessionIndex = makeSessionIndex();\n    const sessionToIndex = new Map([[session.id, sessionIndex]]);\n\n    vi.spyOn(a11yTree, \"a11yForFrame\").mockImplementation(\n      async (_sess, frameId) => ({\n        outline: `outline-${frameId}`,\n        urlMap: { [`url-${frameId}`]: `https://${frameId}.test` },\n        scopeApplied: false,\n      }),\n    );\n\n    const result = await capture.collectPerFrameMaps(\n      page,\n      context,\n      sessionToIndex,\n      { experimental: true },\n      true,\n      context.frames,\n    );\n\n    expect(result.perFrameOutlines).toEqual([\n      { frameId: \"frame-1\", outline: \"outline-frame-1\" },\n      { frameId: \"frame-2\", outline: \"outline-frame-2\" },\n    ]);\n    const rootMaps = result.perFrameMaps.get(\"frame-1\");\n    expect(rootMaps?.xpathMap[\"0-100\"]).toBe(\"/\");\n    expect(rootMaps?.xpathMap[\"0-101\"]).toBe(\"/html[1]\");\n    expect(rootMaps?.xpathMap[\"0-102\"]).toBe(\"/html[1]/body[1]\");\n    const childMaps = result.perFrameMaps.get(\"frame-2\");\n    expect(childMaps?.xpathMap[\"1-200\"]).toBe(\"/\");\n    expect(childMaps?.xpathMap[\"1-201\"]).toBe(\"/div[1]\");\n    expect(childMaps?.scrollableMap[\"1-201\"]).toBe(true);\n    expect(childMaps?.urlMap).toEqual({\n      \"url-frame-2\": \"https://frame-2.test\",\n    });\n    expect(session.callsFor(\"DOM.getFrameOwner\")).toHaveLength(1);\n  });\n\n  it(\"builds a missing session index on demand and memoizes it\", async () => {\n    const session = new MockCDPSession({}, \"new-session\");\n    const page = makePage({\n      getSessionForFrame: () => session,\n      getOrdinal: () => 2,\n    });\n    const context: FrameContext = {\n      rootId: \"frame-9\",\n      frames: [\"frame-9\"],\n      parentByFrame: new Map([[\"frame-9\", null]]),\n    };\n    const idx = makeSessionIndex();\n    const buildSpy = vi\n      .spyOn(domTree, \"buildSessionDomIndex\")\n      .mockResolvedValue(idx);\n    vi.spyOn(a11yTree, \"a11yForFrame\").mockResolvedValue({\n      outline: \"outline\",\n      urlMap: {},\n      scopeApplied: false,\n    });\n\n    const sessionToIndex = new Map<string, SessionDomIndex>();\n    const result = await capture.collectPerFrameMaps(\n      page,\n      context,\n      sessionToIndex,\n      undefined,\n      false,\n      context.frames,\n    );\n\n    expect(buildSpy).toHaveBeenCalledWith(session, false);\n    expect(sessionToIndex.get(\"new-session\")).toBe(idx);\n    expect(result.perFrameMaps.get(\"frame-9\")?.xpathMap[\"2-100\"]).toBe(\"/\");\n  });\n\n  it(\"skips frames that are not listed in the frameIds argument\", async () => {\n    const session = new MockCDPSession({}, \"session-a\");\n    const page = makePage({\n      getSessionForFrame: () => session,\n      getOrdinal: (frameId: string) => (frameId === \"frame-1\" ? 0 : 1),\n    });\n    const context: FrameContext = {\n      rootId: \"frame-1\",\n      frames: [\"frame-1\", \"frame-2\"],\n      parentByFrame: new Map([\n        [\"frame-1\", null],\n        [\"frame-2\", \"frame-1\"],\n      ]),\n    };\n    const sessionIndex = makeSessionIndex();\n    const sessionToIndex = new Map([[session.id, sessionIndex]]);\n\n    const a11ySpy = vi.spyOn(a11yTree, \"a11yForFrame\").mockResolvedValue({\n      outline: \"outline\",\n      urlMap: {},\n      scopeApplied: false,\n    });\n\n    const result = await capture.collectPerFrameMaps(\n      page,\n      context,\n      sessionToIndex,\n      undefined,\n      true,\n      [\"frame-1\"],\n    );\n\n    expect(a11ySpy).toHaveBeenCalledTimes(1);\n    expect(result.perFrameMaps.has(\"frame-2\")).toBe(false);\n    expect(result.perFrameOutlines.map((o) => o.frameId)).toEqual([\"frame-1\"]);\n  });\n});\n\ndescribe(\"captureHybridSnapshot\", () => {\n  it(\"returns early when the scoped snapshot path succeeds\", async () => {\n    const session = new MockCDPSession({}, \"session-a\");\n    const page = makePage({\n      getSessionForFrame: () => session,\n    });\n    const options = { focusSelector: \"/html\" };\n\n    vi.spyOn(focusSelectors, \"resolveFocusFrameAndTail\").mockResolvedValue({\n      targetFrameId: \"frame-1\",\n      tailXPath: \"\",\n      absPrefix: \"\",\n    });\n    const domMapsSpy = vi\n      .spyOn(domTree, \"domMapsForSession\")\n      .mockResolvedValue({\n        tagNameMap: { \"0-100\": \"#document\" },\n        xpathMap: { \"0-100\": \"/\" },\n        scrollableMap: {},\n      });\n    const a11ySpy = vi.spyOn(a11yTree, \"a11yForFrame\").mockResolvedValue({\n      outline: \"scoped outline\",\n      urlMap: { \"0-100\": \"https://frame-1.test\" },\n      scopeApplied: true,\n    });\n    const buildIndexSpy = vi\n      .spyOn(domTree, \"buildSessionDomIndex\")\n      .mockImplementation(() => {\n        throw new Error(\"should not build session index when scoped\");\n      });\n\n    const result = await capture.captureHybridSnapshot(page, options);\n\n    expect(result.combinedTree).toBe(\"scoped outline\");\n    expect(result.combinedUrlMap[\"0-100\"]).toBe(\"https://frame-1.test\");\n    expect(domMapsSpy).toHaveBeenCalled();\n    expect(a11ySpy).toHaveBeenCalled();\n    expect(buildIndexSpy).not.toHaveBeenCalled();\n  });\n\n  it(\"scoped snapshot still succeeds when iframe inclusion is disabled\", async () => {\n    const session = new MockCDPSession({}, \"session-a\");\n    const page = makePage({\n      getSessionForFrame: () => session,\n    });\n    const options = { focusSelector: \"/html\", includeIframes: false };\n\n    vi.spyOn(focusSelectors, \"resolveFocusFrameAndTail\").mockResolvedValue({\n      targetFrameId: \"frame-1\",\n      tailXPath: \"\",\n      absPrefix: \"\",\n    });\n    const domMapsSpy = vi\n      .spyOn(domTree, \"domMapsForSession\")\n      .mockResolvedValue({\n        tagNameMap: { \"0-100\": \"#document\" },\n        xpathMap: { \"0-100\": \"/\" },\n        scrollableMap: {},\n      });\n    const a11ySpy = vi.spyOn(a11yTree, \"a11yForFrame\").mockResolvedValue({\n      outline: \"scoped outline\",\n      urlMap: { \"0-100\": \"https://frame-1.test\" },\n      scopeApplied: true,\n    });\n    const buildIndexSpy = vi\n      .spyOn(domTree, \"buildSessionDomIndex\")\n      .mockImplementation(() => {\n        throw new Error(\"should not build session index when scoped\");\n      });\n\n    const result = await capture.captureHybridSnapshot(page, options);\n\n    expect(result.combinedTree).toBe(\"scoped outline\");\n    expect(result.combinedUrlMap[\"0-100\"]).toBe(\"https://frame-1.test\");\n    expect(domMapsSpy).toHaveBeenCalled();\n    expect(a11ySpy).toHaveBeenCalled();\n    expect(buildIndexSpy).not.toHaveBeenCalled();\n  });\n\n  it(\"collects per-frame data and merges it when no scoped snapshot is available\", async () => {\n    const session = new MockCDPSession(\n      {\n        \"DOM.getFrameOwner\": async () => ({ backendNodeId: 150 }),\n      },\n      \"session-a\",\n    );\n    const page = makePage({\n      asProtocolFrameTree: () =>\n        makeFrameTree(\"frame-1\", [makeFrameTree(\"frame-2\")]),\n      listAllFrameIds: () => [\"frame-1\", \"frame-2\"],\n      getSessionForFrame: () => session,\n      getOrdinal: (frameId: string) => (frameId === \"frame-1\" ? 0 : 1),\n    });\n\n    const idx = makeSessionIndex();\n    vi.spyOn(domTree, \"buildSessionDomIndex\").mockResolvedValue(idx);\n    vi.spyOn(a11yTree, \"a11yForFrame\").mockImplementation(\n      async (_sess, frameId) => ({\n        outline:\n          frameId === \"frame-1\"\n            ? \"[0-150] iframe host\"\n            : \"[1-200] child subtree\",\n        urlMap: { [`url-${frameId}`]: `https://${frameId}.test` },\n        scopeApplied: false,\n      }),\n    );\n\n    const snapshot = await capture.captureHybridSnapshot(page);\n\n    expect(snapshot.combinedTree).toContain(\"[1-200] child subtree\");\n    expect(snapshot.combinedXpathMap[\"0-100\"]).toBe(\"/\");\n    expect(snapshot.combinedXpathMap[\"1-201\"]).toBe(\n      \"/html[1]/body[1]/iframe[1]/div[1]\",\n    );\n    expect(snapshot.combinedUrlMap[\"url-frame-2\"]).toBe(\"https://frame-2.test\");\n    expect(snapshot.perFrame?.map((pf) => pf.frameId)).toEqual([\n      \"frame-1\",\n      \"frame-2\",\n    ]);\n  });\n\n  it(\"omits iframe frames when includeIframes is false\", async () => {\n    const session = new MockCDPSession(\n      {\n        \"DOM.getFrameOwner\": async () => ({ backendNodeId: 150 }),\n      },\n      \"session-a\",\n    );\n    const page = makePage({\n      asProtocolFrameTree: () =>\n        makeFrameTree(\"frame-1\", [makeFrameTree(\"frame-2\")]),\n      listAllFrameIds: () => [\"frame-1\", \"frame-2\"],\n      getSessionForFrame: () => session,\n      getOrdinal: (frameId: string) => (frameId === \"frame-1\" ? 0 : 1),\n    });\n\n    const idx = makeSessionIndex();\n    vi.spyOn(domTree, \"buildSessionDomIndex\").mockResolvedValue(idx);\n    const a11ySpy = vi\n      .spyOn(a11yTree, \"a11yForFrame\")\n      .mockImplementation(async (_sess, frameId) => ({\n        outline:\n          frameId === \"frame-1\"\n            ? \"[0-150] iframe host\"\n            : \"[1-200] child subtree\",\n        urlMap: { [`url-${frameId}`]: `https://${frameId}.test` },\n        scopeApplied: false,\n      }));\n\n    const snapshot = await capture.captureHybridSnapshot(page, {\n      includeIframes: false,\n    });\n\n    expect(a11ySpy).toHaveBeenCalledTimes(1);\n    expect(session.callsFor(\"DOM.getFrameOwner\")).toHaveLength(0);\n    expect(snapshot.perFrame?.map((pf) => pf.frameId)).toEqual([\"frame-1\"]);\n    expect(snapshot.combinedXpathMap[\"1-201\"]).toBeUndefined();\n    expect(snapshot.combinedTree).not.toContain(\"[1-200] child subtree\");\n  });\n});\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/cjs/tests/snapshot-cbor.test.js

@@ -0,0 +1,197 @@
+var import_vitest = require("vitest");
+var import_snapshot = require("../lib/v3/understudy/a11y/snapshot/index.js");
+var import_mockCDPSession = require("./helpers/mockCDPSession.js");
+var import_sdkErrors = require("../lib/v3/types/public/sdkErrors.js");
+function createFakePage(session) {
+  const frameTree = {
+    frame: {
+      id: "root",
+      loaderId: "root-loader",
+      url: "http://fake",
+      domainAndRegistry: "fake",
+      securityOrigin: "http://fake",
+      mimeType: "text/html",
+      secureContextType: "Secure",
+      crossOriginIsolatedContextType: "NotIsolated",
+      gatedAPIFeatures: []
+    },
+    childFrames: []
+  };
+  return {
+    mainFrameId: () => "root",
+    asProtocolFrameTree: () => frameTree,
+    listAllFrameIds: () => ["root"],
+    getSessionForFrame: () => session,
+    getOrdinal: () => 0
+  };
+}
+function completeDomTree() {
+  return {
+    nodeId: 1,
+    backendNodeId: 1,
+    nodeType: 9,
+    nodeName: "#document",
+    childNodeCount: 1,
+    children: [
+      {
+        nodeId: 2,
+        backendNodeId: 2,
+        nodeType: 1,
+        nodeName: "HTML",
+        childNodeCount: 1,
+        children: [
+          {
+            nodeId: 3,
+            backendNodeId: 3,
+            nodeType: 1,
+            nodeName: "BODY",
+            childNodeCount: 1,
+            children: [
+              {
+                nodeId: 4,
+                backendNodeId: 4,
+                nodeType: 1,
+                nodeName: "DIV",
+                childNodeCount: 0,
+                children: []
+              }
+            ]
+          }
+        ]
+      }
+    ]
+  };
+}
+function truncatedDomTree() {
+  return {
+    nodeId: 1,
+    backendNodeId: 1,
+    nodeType: 9,
+    nodeName: "#document",
+    childNodeCount: 1,
+    children: [
+      {
+        nodeId: 2,
+        backendNodeId: 2,
+        nodeType: 1,
+        nodeName: "HTML",
+        childNodeCount: 1,
+        children: []
+      }
+    ]
+  };
+}
+function htmlWithChildren() {
+  return {
+    nodeId: 2,
+    backendNodeId: 2,
+    nodeType: 1,
+    nodeName: "HTML",
+    childNodeCount: 1,
+    children: [
+      {
+        nodeId: 3,
+        backendNodeId: 3,
+        nodeType: 1,
+        nodeName: "BODY",
+        childNodeCount: 1,
+        children: [
+          {
+            nodeId: 4,
+            backendNodeId: 4,
+            nodeType: 1,
+            nodeName: "DIV",
+            childNodeCount: 0,
+            children: []
+          }
+        ]
+      }
+    ]
+  };
+}
+function simpleAxNodes() {
+  const stringType = "string";
+  return [
+    {
+      nodeId: "1",
+      role: { type: stringType, value: "RootWebArea" },
+      backendDOMNodeId: 2,
+      childIds: ["2"],
+      ignored: false
+    },
+    {
+      nodeId: "2",
+      role: { type: stringType, value: "generic" },
+      name: { type: stringType, value: "Content" },
+      backendDOMNodeId: 4,
+      parentId: "1",
+      childIds: [],
+      ignored: false
+    }
+  ];
+}
+const baseHandlers = {
+  "DOM.enable": async () => ({}),
+  "Runtime.enable": async () => ({}),
+  "Accessibility.enable": async () => ({}),
+  "Accessibility.getFullAXTree": async () => ({ nodes: simpleAxNodes() })
+};
+function makeCborError() {
+  return new Error("CBOR: stack limit exceeded");
+}
+(0, import_vitest.describe)("captureHybridSnapshot CBOR fallbacks", () => {
+  (0, import_vitest.it)("retries DOM.getDocument with reduced depths before succeeding", async () => {
+    let domCalls = 0;
+    const session = new import_mockCDPSession.MockCDPSession({
+      ...baseHandlers,
+      "DOM.getDocument": async (params) => {
+        domCalls += 1;
+        if (domCalls === 1) throw makeCborError();
+        (0, import_vitest.expect)(params?.depth).toBe(256);
+        return { root: completeDomTree() };
+      }
+    });
+    const page = createFakePage(session);
+    const snapshot = await (0, import_snapshot.captureHybridSnapshot)(page);
+    (0, import_vitest.expect)(snapshot.combinedTree).toContain("html");
+    const depths = session.callsFor("DOM.getDocument").map((c) => c.params?.depth);
+    (0, import_vitest.expect)(depths).toEqual([-1, 256]);
+  });
+  (0, import_vitest.it)("throws StagehandDomProcessError after all DOM.getDocument attempts fail", async () => {
+    const session = new import_mockCDPSession.MockCDPSession({
+      ...baseHandlers,
+      "DOM.getDocument": async () => {
+        throw makeCborError();
+      }
+    });
+    const page = createFakePage(session);
+    await (0, import_vitest.expect)((0, import_snapshot.captureHybridSnapshot)(page)).rejects.toThrow(
+      import_sdkErrors.StagehandDomProcessError
+    );
+  });
+  (0, import_vitest.it)("hydrates truncated nodes by retrying DOM.describeNode depths", async () => {
+    let domAttempts = 0;
+    let describeAttempts = 0;
+    const session = new import_mockCDPSession.MockCDPSession({
+      ...baseHandlers,
+      "DOM.getDocument": async (params) => {
+        domAttempts += 1;
+        if (domAttempts === 1) throw makeCborError();
+        (0, import_vitest.expect)(params?.depth).toBe(256);
+        return { root: truncatedDomTree() };
+      },
+      "DOM.describeNode": async (params) => {
+        describeAttempts += 1;
+        if (describeAttempts === 1) throw makeCborError();
+        (0, import_vitest.expect)(params?.depth).toBe(64);
+        return { node: htmlWithChildren() };
+      }
+    });
+    const page = createFakePage(session);
+    const snapshot = await (0, import_snapshot.captureHybridSnapshot)(page);
+    const describeDepths = session.callsFor("DOM.describeNode").map((c) => c.params?.depth);
+    (0, import_vitest.expect)(describeDepths).toEqual([-1, 64]);
+    (0, import_vitest.expect)(snapshot.combinedXpathMap["0-4"]).toBe("/html[1]/body[1]/div[1]");
+  });
+});
+//# sourceMappingURL=snapshot-cbor.test.js.map