npm - @browserbasehq/orca - Versions diffs - 3.0.9-alpha-3 → 3.1.0-patch.0 - Mend

@browserbasehq/orca 3.0.9-alpha-3 → 3.1.0-patch.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (655) hide show

package/dist/esm/lib/v3/tests/context-addInitScript.spec.js ADDED Viewed

@@ -0,0 +1,176 @@
+import { test, expect } from "@playwright/test";
+import { V3 } from "../v3.js";
+import { v3TestConfig } from "./v3.config.js";
+const toDataUrl = (html) => `data:text/html,${encodeURIComponent(html)}`;
+test.describe("context.addInitScript", () => {
+  let v3;
+  let ctx;
+  test.beforeEach(async () => {
+    v3 = new V3(v3TestConfig);
+    await v3.init();
+    ctx = v3.context;
+  });
+  test.afterEach(async () => {
+    await v3?.close?.().catch(() => {
+    });
+  });
+  test("runs before inline document scripts on navigation", async () => {
+    const page = await ctx.awaitActivePage();
+    await ctx.addInitScript(() => {
+      window.__fromContextInit = "injected-value";
+    });
+    const html = `<!DOCTYPE html>
+      <html>
+        <body>
+          <script>
+            var value = (window && window.__fromContextInit) || 'missing';
+            document.body.dataset.initWitness = value;
+          </script>
+        </body>
+      </html>`;
+    await page.goto(toDataUrl(html), { waitUntil: "load" });
+    const observed = await page.evaluate(() => {
+      return document.body.dataset.initWitness;
+    });
+    expect(observed).toBe("injected-value");
+  });
+  test("re-applies the script on every navigation for the same page", async () => {
+    const page = await ctx.awaitActivePage();
+    await ctx.addInitScript(`
+      (function () {
+        function markVisit() {
+          var root = document.documentElement;
+          if (!root) return;
+          var current = Number(window.name || "0");
+          var next = current + 1;
+          window.name = String(next);
+          root.dataset.visitCount = String(next);
+        }
+        if (document.readyState === "loading") {
+          document.addEventListener("DOMContentLoaded", markVisit, {
+            once: true,
+          });
+        } else {
+          markVisit();
+        }
+      })();
+    `);
+    await page.goto(toDataUrl("<html><body>first</body></html>"), {
+      waitUntil: "load"
+    });
+    const first = await page.evaluate(() => {
+      return Number(document.documentElement.dataset.visitCount ?? "0");
+    });
+    expect(first).toBe(1);
+    await page.goto(toDataUrl("<html><body>second</body></html>"), {
+      waitUntil: "load"
+    });
+    const second = await page.evaluate(() => {
+      return Number(document.documentElement.dataset.visitCount ?? "0");
+    });
+    expect(second).toBe(2);
+  });
+  test("applies script (with args) to newly created pages", async () => {
+    const payload = { greeting: "hi", nested: { count: 2 } };
+    const initPayload = (arg) => {
+      function setPayload() {
+        const root = document.documentElement;
+        if (!root) return;
+        root.dataset.initPayload = JSON.stringify(arg);
+      }
+      if (document.readyState === "loading") {
+        document.addEventListener("DOMContentLoaded", setPayload, {
+          once: true
+        });
+      } else {
+        setPayload();
+      }
+    };
+    await ctx.addInitScript(initPayload, payload);
+    const newPage = await ctx.newPage();
+    await newPage.goto(toDataUrl("<html><body>child</body></html>"), {
+      waitUntil: "load"
+    });
+    const observed = await newPage.evaluate(() => {
+      const raw = document.documentElement.dataset.initPayload;
+      return raw ? JSON.parse(raw) : void 0;
+    });
+    expect(observed).toEqual(payload);
+  });
+  test("applies script to newPage(url) on initial document", async () => {
+    const payload = { marker: "newPageUrl" };
+    await ctx.addInitScript((arg) => {
+      function setPayload() {
+        const root = document.documentElement;
+        if (!root) return;
+        root.dataset.initPayload = JSON.stringify(arg);
+      }
+      if (document.readyState === "loading") {
+        document.addEventListener("DOMContentLoaded", setPayload, {
+          once: true
+        });
+      } else {
+        setPayload();
+      }
+    }, payload);
+    const newPage = await ctx.newPage(
+      toDataUrl("<html><body>new page</body></html>")
+    );
+    await newPage.waitForLoadState("load");
+    const observed = await newPage.evaluate(() => {
+      const raw = document.documentElement.dataset.initPayload;
+      return raw ? JSON.parse(raw) : void 0;
+    });
+    expect(observed).toEqual(payload);
+  });
+  test("applies script to pages opened via link clicks", async () => {
+    const payload = { marker: "linkClick" };
+    await ctx.addInitScript((arg) => {
+      function setPayload() {
+        const root = document.documentElement;
+        if (!root) return;
+        root.dataset.initPayload = JSON.stringify(arg);
+      }
+      if (document.readyState === "loading") {
+        document.addEventListener("DOMContentLoaded", setPayload, {
+          once: true
+        });
+      } else {
+        setPayload();
+      }
+    }, payload);
+    const popupUrl = toDataUrl("<html><body>popup</body></html>");
+    const openerHtml = '<!DOCTYPE html><html><body><a id="open" target="_blank" href="' + popupUrl + '">open</a></body></html>';
+    const opener = await ctx.awaitActivePage();
+    await opener.goto(toDataUrl(openerHtml), { waitUntil: "load" });
+    await opener.locator("#open").click();
+    const openerId = opener.targetId();
+    const deadline = Date.now() + 2e3;
+    let popup = ctx.pages().find((p) => p.targetId() !== openerId);
+    while (!popup && Date.now() < deadline) {
+      await opener.waitForTimeout(25);
+      popup = ctx.pages().find((p) => p.targetId() !== openerId);
+    }
+    if (!popup) {
+      throw new Error("Popup page was not created");
+    }
+    await popup.waitForLoadState("load");
+    const observed = await popup.evaluate(() => {
+      const raw = document.documentElement.dataset.initPayload;
+      return raw ? JSON.parse(raw) : void 0;
+    });
+    expect(observed).toEqual(payload);
+  });
+  test("context.addInitScript installs a function callable from page.evaluate", async () => {
+    const page = await ctx.awaitActivePage();
+    await ctx.addInitScript(() => {
+      window.sayHelloFromStagehand = () => "hello from stagehand";
+    });
+    await page.goto("https://example.com", { waitUntil: "domcontentloaded" });
+    const result = await page.evaluate(() => {
+      return window.sayHelloFromStagehand();
+    });
+    expect(result).toBe("hello from stagehand");
+  });
+});
+//# sourceMappingURL=context-addInitScript.spec.js.map

package/dist/esm/lib/v3/tests/context-addInitScript.spec.js.map ADDED Viewed

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../../lib/v3/tests/context-addInitScript.spec.ts"],
+  "sourcesContent": ["import { test, expect } from \"@playwright/test\";\nimport { V3 } from \"../v3.js\";\nimport { v3TestConfig } from \"./v3.config.js\";\nimport { V3Context } from \"../understudy/context.js\";\n\nconst toDataUrl = (html: string): string =>\n  `data:text/html,${encodeURIComponent(html)}`;\n\ntest.describe(\"context.addInitScript\", () => {\n  let v3: V3;\n  let ctx: V3Context;\n\n  test.beforeEach(async () => {\n    v3 = new V3(v3TestConfig);\n    await v3.init();\n    ctx = v3.context;\n  });\n\n  test.afterEach(async () => {\n    await v3?.close?.().catch(() => {});\n  });\n\n  test(\"runs before inline document scripts on navigation\", async () => {\n    const page = await ctx.awaitActivePage();\n\n    await ctx.addInitScript(() => {\n      (window as unknown as { __fromContextInit?: string }).__fromContextInit =\n        \"injected-value\";\n    });\n\n    const html = `<!DOCTYPE html>\n      <html>\n        <body>\n          <script>\n            var value = (window && window.__fromContextInit) || 'missing';\n            document.body.dataset.initWitness = value;\n          </script>\n        </body>\n      </html>`;\n\n    await page.goto(toDataUrl(html), { waitUntil: \"load\" });\n\n    const observed = await page.evaluate(() => {\n      return document.body.dataset.initWitness;\n    });\n    expect(observed).toBe(\"injected-value\");\n  });\n\n  test(\"re-applies the script on every navigation for the same page\", async () => {\n    const page = await ctx.awaitActivePage();\n\n    await ctx.addInitScript(`\n      (function () {\n        function markVisit() {\n          var root = document.documentElement;\n          if (!root) return;\n          var current = Number(window.name || \"0\");\n          var next = current + 1;\n          window.name = String(next);\n          root.dataset.visitCount = String(next);\n        }\n        if (document.readyState === \"loading\") {\n          document.addEventListener(\"DOMContentLoaded\", markVisit, {\n            once: true,\n          });\n        } else {\n          markVisit();\n        }\n      })();\n    `);\n\n    await page.goto(toDataUrl(\"<html><body>first</body></html>\"), {\n      waitUntil: \"load\",\n    });\n    const first = await page.evaluate(() => {\n      return Number(document.documentElement.dataset.visitCount ?? \"0\");\n    });\n    expect(first).toBe(1);\n\n    await page.goto(toDataUrl(\"<html><body>second</body></html>\"), {\n      waitUntil: \"load\",\n    });\n    const second = await page.evaluate(() => {\n      return Number(document.documentElement.dataset.visitCount ?? \"0\");\n    });\n    expect(second).toBe(2);\n  });\n\n  test(\"applies script (with args) to newly created pages\", async () => {\n    const payload = { greeting: \"hi\", nested: { count: 2 } };\n\n    const initPayload = ((arg) => {\n      function setPayload() {\n        const root = document.documentElement;\n        if (!root) return;\n        root.dataset.initPayload = JSON.stringify(arg);\n      }\n      if (document.readyState === \"loading\") {\n        document.addEventListener(\"DOMContentLoaded\", setPayload, {\n          once: true,\n        });\n      } else {\n        setPayload();\n      }\n    }) as (arg: typeof payload) => void;\n    await ctx.addInitScript(initPayload, payload);\n\n    const newPage = await ctx.newPage();\n    await newPage.goto(toDataUrl(\"<html><body>child</body></html>\"), {\n      waitUntil: \"load\",\n    });\n\n    const observed = await newPage.evaluate(() => {\n      const raw = document.documentElement.dataset.initPayload;\n      return raw ? JSON.parse(raw) : undefined;\n    });\n    expect(observed).toEqual(payload);\n  });\n\n  test(\"applies script to newPage(url) on initial document\", async () => {\n    const payload = { marker: \"newPageUrl\" };\n\n    await ctx.addInitScript((arg) => {\n      function setPayload(): void {\n        const root = document.documentElement;\n        if (!root) return;\n        root.dataset.initPayload = JSON.stringify(arg);\n      }\n      if (document.readyState === \"loading\") {\n        document.addEventListener(\"DOMContentLoaded\", setPayload, {\n          once: true,\n        });\n      } else {\n        setPayload();\n      }\n    }, payload);\n\n    const newPage = await ctx.newPage(\n      toDataUrl(\"<html><body>new page</body></html>\"),\n    );\n    await newPage.waitForLoadState(\"load\");\n\n    const observed = await newPage.evaluate(() => {\n      const raw = document.documentElement.dataset.initPayload;\n      return raw ? JSON.parse(raw) : undefined;\n    });\n    expect(observed).toEqual(payload);\n  });\n\n  test(\"applies script to pages opened via link clicks\", async () => {\n    const payload = { marker: \"linkClick\" };\n\n    await ctx.addInitScript((arg) => {\n      function setPayload(): void {\n        const root = document.documentElement;\n        if (!root) return;\n        root.dataset.initPayload = JSON.stringify(arg);\n      }\n      if (document.readyState === \"loading\") {\n        document.addEventListener(\"DOMContentLoaded\", setPayload, {\n          once: true,\n        });\n      } else {\n        setPayload();\n      }\n    }, payload);\n\n    const popupUrl = toDataUrl(\"<html><body>popup</body></html>\");\n    const openerHtml =\n      \"<!DOCTYPE html>\" +\n      \"<html><body>\" +\n      '<a id=\"open\" target=\"_blank\" href=\"' +\n      popupUrl +\n      '\">open</a>' +\n      \"</body></html>\";\n\n    const opener = await ctx.awaitActivePage();\n    await opener.goto(toDataUrl(openerHtml), { waitUntil: \"load\" });\n    await opener.locator(\"#open\").click();\n\n    const openerId = opener.targetId();\n    const deadline = Date.now() + 2000;\n    let popup = ctx.pages().find((p) => p.targetId() !== openerId);\n    while (!popup && Date.now() < deadline) {\n      await opener.waitForTimeout(25);\n      popup = ctx.pages().find((p) => p.targetId() !== openerId);\n    }\n    if (!popup) {\n      throw new Error(\"Popup page was not created\");\n    }\n\n    await popup.waitForLoadState(\"load\");\n\n    const observed = await popup.evaluate(() => {\n      const raw = document.documentElement.dataset.initPayload;\n      return raw ? JSON.parse(raw) : undefined;\n    });\n    expect(observed).toEqual(payload);\n  });\n\n  test(\"context.addInitScript installs a function callable from page.evaluate\", async () => {\n    const page = await ctx.awaitActivePage();\n\n    await ctx.addInitScript(() => {\n      // installed before any navigation\n      // eslint-disable-next-line @typescript-eslint/ban-ts-comment\n      // @ts-expect-error\n      window.sayHelloFromStagehand = () => \"hello from stagehand\";\n    });\n\n    await page.goto(\"https://example.com\", { waitUntil: \"domcontentloaded\" });\n\n    const result = await page.evaluate(() => {\n      // eslint-disable-next-line @typescript-eslint/ban-ts-comment\n      // @ts-expect-error\n      return window.sayHelloFromStagehand();\n    });\n\n    expect(result).toBe(\"hello from stagehand\");\n  });\n});\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/esm/lib/v3/tests/default-page-tracking.spec.js ADDED Viewed

@@ -0,0 +1,53 @@
+import { test, expect } from "@playwright/test";
+import { V3 } from "../v3.js";
+import { v3DynamicTestConfig } from "./v3.dynamic.config.js";
+import { closeV3 } from "./testUtils.js";
+test.describe.configure({ mode: "parallel" });
+test.describe("V3 default page tracking", () => {
+  let v3;
+  test.beforeEach(async () => {
+    v3 = new V3(v3DynamicTestConfig);
+    await v3.init();
+  });
+  test.afterEach(async () => {
+    await closeV3(v3);
+  });
+  test("activePage points to initial page", async () => {
+    const ctx = v3.context;
+    const pages = ctx.pages();
+    expect(pages.length).toBeGreaterThanOrEqual(1);
+    const active = ctx.activePage();
+    expect(active).toBeTruthy();
+    expect(active.mainFrameId().length).toBeGreaterThan(0);
+  });
+  test("activePage switches to most recent top-level page and reverts on close", async () => {
+    const ctx = v3.context;
+    const newPage = await ctx.newPage("https://example.com/");
+    const activeAfterCreate = await ctx.awaitActivePage();
+    expect(activeAfterCreate.url()).toContain(newPage.url());
+  });
+  test("popup default-page flow via five-tab site", async () => {
+    const ctx = v3.context;
+    const root = await ctx.awaitActivePage();
+    await root.goto(
+      "https://browserbase.github.io/stagehand-eval-sites/sites/five-tab/",
+      { waitUntil: "load", timeoutMs: 15e3 }
+    );
+    await root.locator("xpath=/html/body/button").click();
+    const page2 = await ctx.awaitActivePage();
+    expect(page2.url()).toBe(
+      "https://browserbase.github.io/stagehand-eval-sites/sites/five-tab/page2.html"
+    );
+    await page2.locator("xpath=/html/body/button").click();
+    const page3 = await ctx.awaitActivePage();
+    expect(page3.url()).toBe(
+      "https://browserbase.github.io/stagehand-eval-sites/sites/five-tab/page3.html"
+    );
+    await page3.close();
+    const backToPage2 = await ctx.awaitActivePage();
+    expect(backToPage2.url()).toBe(
+      "https://browserbase.github.io/stagehand-eval-sites/sites/five-tab/page2.html"
+    );
+  });
+});
+//# sourceMappingURL=default-page-tracking.spec.js.map

package/dist/esm/lib/v3/tests/default-page-tracking.spec.js.map ADDED Viewed

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../../lib/v3/tests/default-page-tracking.spec.ts"],
+  "sourcesContent": ["import { test, expect } from \"@playwright/test\";\nimport { V3 } from \"../v3.js\";\nimport { v3DynamicTestConfig } from \"./v3.dynamic.config.js\";\nimport { closeV3 } from \"./testUtils.js\";\n\ntest.describe.configure({ mode: \"parallel\" });\ntest.describe(\"V3 default page tracking\", () => {\n  let v3: V3;\n\n  test.beforeEach(async () => {\n    v3 = new V3(v3DynamicTestConfig);\n    await v3.init();\n  });\n\n  test.afterEach(async () => {\n    await closeV3(v3);\n  });\n\n  test(\"activePage points to initial page\", async () => {\n    const ctx = v3.context;\n    // Should have at least one top-level page\n    const pages = ctx.pages();\n    expect(pages.length).toBeGreaterThanOrEqual(1);\n    const active = ctx.activePage();\n    expect(active).toBeTruthy();\n    // mainFrameId should be a non-empty string\n    expect(active!.mainFrameId().length).toBeGreaterThan(0);\n  });\n\n  test(\"activePage switches to most recent top-level page and reverts on close\", async () => {\n    const ctx = v3.context;\n    const newPage = await ctx.newPage(\"https://example.com/\");\n\n    const activeAfterCreate = await ctx.awaitActivePage();\n    expect(activeAfterCreate.url()).toContain(newPage.url());\n  });\n\n  test(\"popup default-page flow via five-tab site\", async () => {\n    const ctx = v3.context;\n\n    // 1) Navigate the default page to the site\n    const root = await ctx.awaitActivePage();\n    await root!.goto(\n      \"https://browserbase.github.io/stagehand-eval-sites/sites/five-tab/\",\n      { waitUntil: \"load\", timeoutMs: 15000 },\n    );\n    // 2) Click button on the page to open a new tab \u2192 page2.html\n    await root.locator(\"xpath=/html/body/button\").click();\n    const page2 = await ctx.awaitActivePage();\n    expect(page2!.url()).toBe(\n      \"https://browserbase.github.io/stagehand-eval-sites/sites/five-tab/page2.html\",\n    );\n\n    // 3) On the default page (now page2), click its button \u2192 open page3 popup\n\n    await page2.locator(\"xpath=/html/body/button\").click();\n    const page3 = await ctx.awaitActivePage();\n    expect(page3!.url()).toBe(\n      \"https://browserbase.github.io/stagehand-eval-sites/sites/five-tab/page3.html\",\n    );\n\n    // 4) Close the current page (page3) and ensure the default page reverts to page2\n    await page3!.close();\n    const backToPage2 = await ctx.awaitActivePage();\n    expect(backToPage2!.url()).toBe(\n      \"https://browserbase.github.io/stagehand-eval-sites/sites/five-tab/page2.html\",\n    );\n  });\n});\n"],
+  "mappings": "AAAA,SAAS,MAAM,cAAc;AAC7B,SAAS,UAAU;AACnB,SAAS,2BAA2B;AACpC,SAAS,eAAe;AAExB,KAAK,SAAS,UAAU,EAAE,MAAM,WAAW,CAAC;AAC5C,KAAK,SAAS,4BAA4B,MAAM;AAC9C,MAAI;AAEJ,OAAK,WAAW,YAAY;AAC1B,SAAK,IAAI,GAAG,mBAAmB;AAC/B,UAAM,GAAG,KAAK;AAAA,EAChB,CAAC;AAED,OAAK,UAAU,YAAY;AACzB,UAAM,QAAQ,EAAE;AAAA,EAClB,CAAC;AAED,OAAK,qCAAqC,YAAY;AACpD,UAAM,MAAM,GAAG;AAEf,UAAM,QAAQ,IAAI,MAAM;AACxB,WAAO,MAAM,MAAM,EAAE,uBAAuB,CAAC;AAC7C,UAAM,SAAS,IAAI,WAAW;AAC9B,WAAO,MAAM,EAAE,WAAW;AAE1B,WAAO,OAAQ,YAAY,EAAE,MAAM,EAAE,gBAAgB,CAAC;AAAA,EACxD,CAAC;AAED,OAAK,0EAA0E,YAAY;AACzF,UAAM,MAAM,GAAG;AACf,UAAM,UAAU,MAAM,IAAI,QAAQ,sBAAsB;AAExD,UAAM,oBAAoB,MAAM,IAAI,gBAAgB;AACpD,WAAO,kBAAkB,IAAI,CAAC,EAAE,UAAU,QAAQ,IAAI,CAAC;AAAA,EACzD,CAAC;AAED,OAAK,6CAA6C,YAAY;AAC5D,UAAM,MAAM,GAAG;AAGf,UAAM,OAAO,MAAM,IAAI,gBAAgB;AACvC,UAAM,KAAM;AAAA,MACV;AAAA,MACA,EAAE,WAAW,QAAQ,WAAW,KAAM;AAAA,IACxC;AAEA,UAAM,KAAK,QAAQ,yBAAyB,EAAE,MAAM;AACpD,UAAM,QAAQ,MAAM,IAAI,gBAAgB;AACxC,WAAO,MAAO,IAAI,CAAC,EAAE;AAAA,MACnB;AAAA,IACF;AAIA,UAAM,MAAM,QAAQ,yBAAyB,EAAE,MAAM;AACrD,UAAM,QAAQ,MAAM,IAAI,gBAAgB;AACxC,WAAO,MAAO,IAAI,CAAC,EAAE;AAAA,MACnB;AAAA,IACF;AAGA,UAAM,MAAO,MAAM;AACnB,UAAM,cAAc,MAAM,IAAI,gBAAgB;AAC9C,WAAO,YAAa,IAAI,CAAC,EAAE;AAAA,MACzB;AAAA,IACF;AAAA,EACF,CAAC;AACH,CAAC;",
+  "names": []
+}

package/dist/esm/lib/v3/tests/downloads.spec.js ADDED Viewed

@@ -0,0 +1,58 @@
+import { test, expect } from "@playwright/test";
+import { V3 } from "../v3.js";
+import Browserbase from "@browserbasehq/sdk";
+import AdmZip from "adm-zip";
+import { v3DynamicTestConfig } from "./v3.dynamic.config.js";
+import { closeV3 } from "./testUtils.js";
+const pdfRe = /sample-(\d{13})+\.pdf/;
+test.describe("downloads on browserbase", () => {
+  let v3;
+  test.beforeEach(async () => {
+    v3 = new V3(v3DynamicTestConfig);
+    await v3.init();
+  });
+  test.afterEach(async () => {
+    await closeV3(v3);
+  });
+  test("downloaded pdf is available via downloads api", async () => {
+    const browserTarget = (process.env.STAGEHAND_BROWSER_TARGET ?? "local").toLowerCase();
+    const isBrowserbase = browserTarget === "browserbase";
+    test.skip(
+      !isBrowserbase,
+      "Skipping Browserbase-only downloads test in LOCAL mode"
+    );
+    test.skip(
+      !process.env.BROWSERBASE_API_KEY,
+      "Skipping test: BROWSERBASE_API_KEY not set"
+    );
+    const page = v3.context.pages()[0];
+    await page.goto(
+      "https://browserbase.github.io/stagehand-eval-sites/sites/download-on-click/"
+    );
+    await page.locator("/html/body/button").click();
+    await expect(async () => {
+      const bb = new Browserbase();
+      const zipBuffer = await bb.sessions.downloads.list(
+        v3.browserbaseSessionId
+      );
+      if (!zipBuffer) {
+        throw new Error(
+          `Download buffer is empty for session ${v3.browserbaseSessionId}`
+        );
+      }
+      const zip = new AdmZip(Buffer.from(await zipBuffer.arrayBuffer()));
+      const zipEntries = zip.getEntries();
+      const pdfEntry = zipEntries.find((entry) => pdfRe.test(entry.entryName));
+      if (!pdfEntry) {
+        throw new Error(
+          `Session ${v3.browserbaseSessionId} is missing a file matching "${pdfRe.toString()}" in its zip entries: ${JSON.stringify(zipEntries.map((entry) => entry.entryName))}`
+        );
+      }
+      const expectedFileSize = 13264;
+      expect(pdfEntry.header.size).toBe(expectedFileSize);
+    }).toPass({
+      timeout: 3e4
+    });
+  });
+});
+//# sourceMappingURL=downloads.spec.js.map

package/dist/esm/lib/v3/tests/downloads.spec.js.map ADDED Viewed

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../../lib/v3/tests/downloads.spec.ts"],
+  "sourcesContent": ["import { test, expect } from \"@playwright/test\";\nimport { V3 } from \"../v3.js\";\nimport Browserbase from \"@browserbasehq/sdk\";\nimport AdmZip from \"adm-zip\";\nimport { v3DynamicTestConfig } from \"./v3.dynamic.config.js\";\nimport { closeV3 } from \"./testUtils.js\";\n\nconst pdfRe = /sample-(\\d{13})+\\.pdf/;\ntest.describe(\"downloads on browserbase\", () => {\n  let v3: V3;\n\n  test.beforeEach(async () => {\n    v3 = new V3(v3DynamicTestConfig);\n    await v3.init();\n  });\n\n  test.afterEach(async () => {\n    await closeV3(v3);\n  });\n\n  test(\"downloaded pdf is available via downloads api\", async () => {\n    const browserTarget = (\n      process.env.STAGEHAND_BROWSER_TARGET ?? \"local\"\n    ).toLowerCase();\n    const isBrowserbase = browserTarget === \"browserbase\";\n    // Skip this test in LOCAL mode as it requires Browserbase session\n    test.skip(\n      !isBrowserbase,\n      \"Skipping Browserbase-only downloads test in LOCAL mode\",\n    );\n\n    // Skip if BROWSERBASE_API_KEY is not set\n    test.skip(\n      !process.env.BROWSERBASE_API_KEY,\n      \"Skipping test: BROWSERBASE_API_KEY not set\",\n    );\n\n    // Tiny timeout to force the race to hit the timeout branch\n    const page = v3.context.pages()[0];\n    await page.goto(\n      \"https://browserbase.github.io/stagehand-eval-sites/sites/download-on-click/\",\n    );\n    await page.locator(\"/html/body/button\").click();\n\n    await expect(async () => {\n      const bb = new Browserbase();\n      const zipBuffer = await bb.sessions.downloads.list(\n        v3.browserbaseSessionId,\n      );\n      if (!zipBuffer) {\n        throw new Error(\n          `Download buffer is empty for session ${v3.browserbaseSessionId}`,\n        );\n      }\n\n      const zip = new AdmZip(Buffer.from(await zipBuffer.arrayBuffer()));\n      const zipEntries = zip.getEntries();\n      const pdfEntry = zipEntries.find((entry) => pdfRe.test(entry.entryName));\n\n      if (!pdfEntry) {\n        throw new Error(\n          `Session ${v3.browserbaseSessionId} is missing a file matching \"${pdfRe.toString()}\" in its zip entries: ${JSON.stringify(zipEntries.map((entry) => entry.entryName))}`,\n        );\n      }\n\n      const expectedFileSize = 13264;\n      expect(pdfEntry.header.size).toBe(expectedFileSize);\n    }).toPass({\n      timeout: 30_000,\n    });\n  });\n});\n"],
+  "mappings": "AAAA,SAAS,MAAM,cAAc;AAC7B,SAAS,UAAU;AACnB,OAAO,iBAAiB;AACxB,OAAO,YAAY;AACnB,SAAS,2BAA2B;AACpC,SAAS,eAAe;AAExB,MAAM,QAAQ;AACd,KAAK,SAAS,4BAA4B,MAAM;AAC9C,MAAI;AAEJ,OAAK,WAAW,YAAY;AAC1B,SAAK,IAAI,GAAG,mBAAmB;AAC/B,UAAM,GAAG,KAAK;AAAA,EAChB,CAAC;AAED,OAAK,UAAU,YAAY;AACzB,UAAM,QAAQ,EAAE;AAAA,EAClB,CAAC;AAED,OAAK,iDAAiD,YAAY;AAChE,UAAM,iBACJ,QAAQ,IAAI,4BAA4B,SACxC,YAAY;AACd,UAAM,gBAAgB,kBAAkB;AAExC,SAAK;AAAA,MACH,CAAC;AAAA,MACD;AAAA,IACF;AAGA,SAAK;AAAA,MACH,CAAC,QAAQ,IAAI;AAAA,MACb;AAAA,IACF;AAGA,UAAM,OAAO,GAAG,QAAQ,MAAM,EAAE,CAAC;AACjC,UAAM,KAAK;AAAA,MACT;AAAA,IACF;AACA,UAAM,KAAK,QAAQ,mBAAmB,EAAE,MAAM;AAE9C,UAAM,OAAO,YAAY;AACvB,YAAM,KAAK,IAAI,YAAY;AAC3B,YAAM,YAAY,MAAM,GAAG,SAAS,UAAU;AAAA,QAC5C,GAAG;AAAA,MACL;AACA,UAAI,CAAC,WAAW;AACd,cAAM,IAAI;AAAA,UACR,wCAAwC,GAAG,oBAAoB;AAAA,QACjE;AAAA,MACF;AAEA,YAAM,MAAM,IAAI,OAAO,OAAO,KAAK,MAAM,UAAU,YAAY,CAAC,CAAC;AACjE,YAAM,aAAa,IAAI,WAAW;AAClC,YAAM,WAAW,WAAW,KAAK,CAAC,UAAU,MAAM,KAAK,MAAM,SAAS,CAAC;AAEvE,UAAI,CAAC,UAAU;AACb,cAAM,IAAI;AAAA,UACR,WAAW,GAAG,oBAAoB,gCAAgC,MAAM,SAAS,CAAC,yBAAyB,KAAK,UAAU,WAAW,IAAI,CAAC,UAAU,MAAM,SAAS,CAAC,CAAC;AAAA,QACvK;AAAA,MACF;AAEA,YAAM,mBAAmB;AACzB,aAAO,SAAS,OAAO,IAAI,EAAE,KAAK,gBAAgB;AAAA,IACpD,CAAC,EAAE,OAAO;AAAA,MACR,SAAS;AAAA,IACX,CAAC;AAAA,EACH,CAAC;AACH,CAAC;",
+  "names": []
+}

package/dist/esm/lib/v3/tests/envReporter.js ADDED Viewed

@@ -0,0 +1,57 @@
+import { getV3DynamicTestConfig } from "./v3.dynamic.config.js";
+function summarizeV3Config() {
+  try {
+    const cfg = getV3DynamicTestConfig();
+    return {
+      env: cfg.env,
+      disableAPI: cfg.disableAPI,
+      selfHeal: cfg.selfHeal,
+      experimental: cfg.experimental,
+      localBrowserLaunchOptions: cfg.localBrowserLaunchOptions ? {
+        headless: cfg.localBrowserLaunchOptions.headless,
+        viewport: cfg.localBrowserLaunchOptions.viewport,
+        hasExecutablePath: Boolean(
+          cfg.localBrowserLaunchOptions.executablePath
+        ),
+        argsCount: cfg.localBrowserLaunchOptions.args?.length ?? 0
+      } : void 0,
+      browserbaseSessionCreateParams: cfg.browserbaseSessionCreateParams ? {
+        region: cfg.browserbaseSessionCreateParams.region,
+        hasViewport: Boolean(
+          cfg.browserbaseSessionCreateParams.browserSettings?.viewport
+        )
+      } : void 0
+    };
+  } catch (error) {
+    return { error: String(error) };
+  }
+}
+function summarizeEnv() {
+  return {
+    STAGEHAND_BROWSER_TARGET: process.env.STAGEHAND_BROWSER_TARGET,
+    BB_ENV: process.env.BB_ENV,
+    // BB_ENV = 'local' | 'dev' | 'prod'                            (hosting environment the stagehand-api server is running in)
+    NODE_ENV: process.env.NODE_ENV,
+    // NODE_ENV = 'development' | 'test' | 'production' | 'staging' (used only to control logging)
+    CI: process.env.CI,
+    // CI = 'true' | 'false'                                        (used only to control test parallelism and pnpm prepare script)
+    STAGEHAND_API_URL: process.env.STAGEHAND_API_URL,
+    BROWSERBASE_REGION: process.env.BROWSERBASE_REGION,
+    BROWSERBASE_API_KEY: process.env.BROWSERBASE_API_KEY ? "[redacted]" : "missing!",
+    BROWSERBASE_PROJECT_ID: process.env.BROWSERBASE_PROJECT_ID ? "[redacted]" : "missing!"
+  };
+}
+class EnvReporter {
+  onTestBegin(test) {
+    const payload = {
+      test: test.titlePath().join(" > "),
+      env: summarizeEnv(),
+      config: summarizeV3Config()
+    };
+    console.log(`[e2e-env] ${JSON.stringify(payload)}`);
+  }
+}
+export {
+  EnvReporter as default
+};
+//# sourceMappingURL=envReporter.js.map

package/dist/esm/lib/v3/tests/envReporter.js.map ADDED Viewed

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../../lib/v3/tests/envReporter.ts"],
+  "sourcesContent": ["import type { Reporter, TestCase } from \"@playwright/test/reporter\";\nimport { getV3DynamicTestConfig } from \"./v3.dynamic.config.js\";\n\ntype ConfigSummary = {\n  env?: string;\n  disableAPI?: boolean;\n  selfHeal?: boolean;\n  experimental?: boolean;\n  localBrowserLaunchOptions?: {\n    headless?: boolean;\n    viewport?: { width?: number; height?: number };\n    hasExecutablePath?: boolean;\n    argsCount?: number;\n  };\n  browserbaseSessionCreateParams?: {\n    region?: string;\n    hasViewport?: boolean;\n  };\n  error?: string;\n};\n\n// Keep this small and log-safe; never emit secrets in CI logs.\nfunction summarizeV3Config(): ConfigSummary {\n  try {\n    const cfg = getV3DynamicTestConfig();\n    return {\n      env: cfg.env,\n      disableAPI: cfg.disableAPI,\n      selfHeal: cfg.selfHeal,\n      experimental: cfg.experimental,\n      localBrowserLaunchOptions: cfg.localBrowserLaunchOptions\n        ? {\n            headless: cfg.localBrowserLaunchOptions.headless,\n            viewport: cfg.localBrowserLaunchOptions.viewport,\n            hasExecutablePath: Boolean(\n              cfg.localBrowserLaunchOptions.executablePath,\n            ),\n            argsCount: cfg.localBrowserLaunchOptions.args?.length ?? 0,\n          }\n        : undefined,\n      browserbaseSessionCreateParams: cfg.browserbaseSessionCreateParams\n        ? {\n            region: cfg.browserbaseSessionCreateParams.region,\n            hasViewport: Boolean(\n              cfg.browserbaseSessionCreateParams.browserSettings?.viewport,\n            ),\n          }\n        : undefined,\n    };\n  } catch (error) {\n    return { error: String(error) };\n  }\n}\n\nfunction summarizeEnv() {\n  return {\n    STAGEHAND_BROWSER_TARGET: process.env.STAGEHAND_BROWSER_TARGET,\n    BB_ENV: process.env.BB_ENV, // BB_ENV = 'local' | 'dev' | 'prod'                            (hosting environment the stagehand-api server is running in)\n    NODE_ENV: process.env.NODE_ENV, // NODE_ENV = 'development' | 'test' | 'production' | 'staging' (used only to control logging)\n    CI: process.env.CI, // CI = 'true' | 'false'                                        (used only to control test parallelism and pnpm prepare script)\n    STAGEHAND_API_URL: process.env.STAGEHAND_API_URL,\n    BROWSERBASE_REGION: process.env.BROWSERBASE_REGION,\n    BROWSERBASE_API_KEY: process.env.BROWSERBASE_API_KEY\n      ? \"[redacted]\"\n      : \"missing!\",\n    BROWSERBASE_PROJECT_ID: process.env.BROWSERBASE_PROJECT_ID\n      ? \"[redacted]\"\n      : \"missing!\",\n  };\n}\n\nexport default class EnvReporter implements Reporter {\n  onTestBegin(test: TestCase): void {\n    const payload = {\n      test: test.titlePath().join(\" > \"),\n      env: summarizeEnv(),\n      config: summarizeV3Config(),\n    };\n    console.log(`[e2e-env] ${JSON.stringify(payload)}`);\n  }\n}\n"],
+  "mappings": "AACA,SAAS,8BAA8B;AAqBvC,SAAS,oBAAmC;AAC1C,MAAI;AACF,UAAM,MAAM,uBAAuB;AACnC,WAAO;AAAA,MACL,KAAK,IAAI;AAAA,MACT,YAAY,IAAI;AAAA,MAChB,UAAU,IAAI;AAAA,MACd,cAAc,IAAI;AAAA,MAClB,2BAA2B,IAAI,4BAC3B;AAAA,QACE,UAAU,IAAI,0BAA0B;AAAA,QACxC,UAAU,IAAI,0BAA0B;AAAA,QACxC,mBAAmB;AAAA,UACjB,IAAI,0BAA0B;AAAA,QAChC;AAAA,QACA,WAAW,IAAI,0BAA0B,MAAM,UAAU;AAAA,MAC3D,IACA;AAAA,MACJ,gCAAgC,IAAI,iCAChC;AAAA,QACE,QAAQ,IAAI,+BAA+B;AAAA,QAC3C,aAAa;AAAA,UACX,IAAI,+BAA+B,iBAAiB;AAAA,QACtD;AAAA,MACF,IACA;AAAA,IACN;AAAA,EACF,SAAS,OAAO;AACd,WAAO,EAAE,OAAO,OAAO,KAAK,EAAE;AAAA,EAChC;AACF;AAEA,SAAS,eAAe;AACtB,SAAO;AAAA,IACL,0BAA0B,QAAQ,IAAI;AAAA,IACtC,QAAQ,QAAQ,IAAI;AAAA;AAAA,IACpB,UAAU,QAAQ,IAAI;AAAA;AAAA,IACtB,IAAI,QAAQ,IAAI;AAAA;AAAA,IAChB,mBAAmB,QAAQ,IAAI;AAAA,IAC/B,oBAAoB,QAAQ,IAAI;AAAA,IAChC,qBAAqB,QAAQ,IAAI,sBAC7B,eACA;AAAA,IACJ,wBAAwB,QAAQ,IAAI,yBAChC,eACA;AAAA,EACN;AACF;AAEA,MAAO,YAA8C;AAAA,EACnD,YAAY,MAAsB;AAChC,UAAM,UAAU;AAAA,MACd,MAAM,KAAK,UAAU,EAAE,KAAK,KAAK;AAAA,MACjC,KAAK,aAAa;AAAA,MAClB,QAAQ,kBAAkB;AAAA,IAC5B;AACA,YAAQ,IAAI,aAAa,KAAK,UAAU,OAAO,CAAC,EAAE;AAAA,EACpD;AACF;",
+  "names": []
+}

package/dist/esm/lib/v3/tests/frame-get-location-and-click.spec.js ADDED Viewed

@@ -0,0 +1,53 @@
+import { expect, test } from "@playwright/test";
+import { V3 } from "../v3.js";
+import { v3TestConfig } from "./v3.config.js";
+test.describe("Coordinate-based clicking", () => {
+  let v3;
+  test.beforeEach(async () => {
+    v3 = new V3(v3TestConfig);
+    await v3.init();
+  });
+  test.afterEach(async () => {
+    await v3?.close?.().catch(() => {
+    });
+  });
+  test("clicking by coordinates toggles a button state", async () => {
+    const page = v3.context.pages()[0];
+    await page.goto(
+      "data:text/html," + encodeURIComponent(
+        `<!doctype html><html><body>
+            <button id="btn" onclick="this.dataset.clicked = (this.dataset.clicked==='1'?'0':'1')">Click</button>
+            <div id="out"></div>
+            <script>
+              const btn = document.getElementById('btn');
+              const out = document.getElementById('out');
+              const update = () => { out.textContent = btn.dataset.clicked === '1' ? 'clicked' : 'idle'; };
+              update();
+              btn.addEventListener('click', update);
+            </script>
+          </body></html>`
+      )
+    );
+    let state = await page.mainFrame().evaluate(() => {
+      const out = document.getElementById("out");
+      return out?.textContent || "";
+    });
+    expect(state).toBe("idle");
+    const { x, y, width, height } = await page.mainFrame().getLocationForSelector("#btn");
+    const cx = Math.round(x + width / 2);
+    const cy = Math.round(y + height / 2);
+    await page.click(cx, cy);
+    state = await page.mainFrame().evaluate(() => {
+      const out = document.getElementById("out");
+      return out?.textContent || "";
+    });
+    expect(state).toBe("clicked");
+    await page.click(cx, cy);
+    state = await page.mainFrame().evaluate(() => {
+      const out = document.getElementById("out");
+      return out?.textContent || "";
+    });
+    expect(state).toBe("idle");
+  });
+});
+//# sourceMappingURL=frame-get-location-and-click.spec.js.map

package/dist/esm/lib/v3/tests/frame-get-location-and-click.spec.js.map ADDED Viewed

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../../lib/v3/tests/frame-get-location-and-click.spec.ts"],
+  "sourcesContent": ["import { expect, test } from \"@playwright/test\";\nimport { V3 } from \"../v3.js\";\nimport { v3TestConfig } from \"./v3.config.js\";\n\ntest.describe(\"Coordinate-based clicking\", () => {\n  let v3: V3;\n\n  test.beforeEach(async () => {\n    v3 = new V3(v3TestConfig);\n    await v3.init();\n  });\n\n  test.afterEach(async () => {\n    await v3?.close?.().catch(() => {});\n  });\n\n  test(\"clicking by coordinates toggles a button state\", async () => {\n    const page = v3.context.pages()[0];\n\n    await page.goto(\n      \"data:text/html,\" +\n        encodeURIComponent(\n          `<!doctype html><html><body>\n            <button id=\"btn\" onclick=\"this.dataset.clicked = (this.dataset.clicked==='1'?'0':'1')\">Click</button>\n            <div id=\"out\"></div>\n            <script>\n              const btn = document.getElementById('btn');\n              const out = document.getElementById('out');\n              const update = () => { out.textContent = btn.dataset.clicked === '1' ? 'clicked' : 'idle'; };\n              update();\n              btn.addEventListener('click', update);\n            </script>\n          </body></html>`,\n        ),\n    );\n\n    // Initial state should be idle\n    let state = await page.mainFrame().evaluate(() => {\n      const out = document.getElementById(\"out\");\n      return out?.textContent || \"\";\n    });\n    expect(state).toBe(\"idle\");\n\n    // Compute button location via Frame.getLocationForSelector\n    const { x, y, width, height } = await page\n      .mainFrame()\n      .getLocationForSelector(\"#btn\");\n\n    // Click near the center of the button using Page.click coordinates\n    const cx = Math.round(x + width / 2);\n    const cy = Math.round(y + height / 2);\n    await page.click(cx, cy);\n\n    state = await page.mainFrame().evaluate(() => {\n      const out = document.getElementById(\"out\");\n      return out?.textContent || \"\";\n    });\n    expect(state).toBe(\"clicked\");\n\n    // Click again to toggle back to idle\n    await page.click(cx, cy);\n    state = await page.mainFrame().evaluate(() => {\n      const out = document.getElementById(\"out\");\n      return out?.textContent || \"\";\n    });\n    expect(state).toBe(\"idle\");\n  });\n});\n"],
+  "mappings": "AAAA,SAAS,QAAQ,YAAY;AAC7B,SAAS,UAAU;AACnB,SAAS,oBAAoB;AAE7B,KAAK,SAAS,6BAA6B,MAAM;AAC/C,MAAI;AAEJ,OAAK,WAAW,YAAY;AAC1B,SAAK,IAAI,GAAG,YAAY;AACxB,UAAM,GAAG,KAAK;AAAA,EAChB,CAAC;AAED,OAAK,UAAU,YAAY;AACzB,UAAM,IAAI,QAAQ,EAAE,MAAM,MAAM;AAAA,IAAC,CAAC;AAAA,EACpC,CAAC;AAED,OAAK,kDAAkD,YAAY;AACjE,UAAM,OAAO,GAAG,QAAQ,MAAM,EAAE,CAAC;AAEjC,UAAM,KAAK;AAAA,MACT,oBACE;AAAA,QACE;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,MAWF;AAAA,IACJ;AAGA,QAAI,QAAQ,MAAM,KAAK,UAAU,EAAE,SAAS,MAAM;AAChD,YAAM,MAAM,SAAS,eAAe,KAAK;AACzC,aAAO,KAAK,eAAe;AAAA,IAC7B,CAAC;AACD,WAAO,KAAK,EAAE,KAAK,MAAM;AAGzB,UAAM,EAAE,GAAG,GAAG,OAAO,OAAO,IAAI,MAAM,KACnC,UAAU,EACV,uBAAuB,MAAM;AAGhC,UAAM,KAAK,KAAK,MAAM,IAAI,QAAQ,CAAC;AACnC,UAAM,KAAK,KAAK,MAAM,IAAI,SAAS,CAAC;AACpC,UAAM,KAAK,MAAM,IAAI,EAAE;AAEvB,YAAQ,MAAM,KAAK,UAAU,EAAE,SAAS,MAAM;AAC5C,YAAM,MAAM,SAAS,eAAe,KAAK;AACzC,aAAO,KAAK,eAAe;AAAA,IAC7B,CAAC;AACD,WAAO,KAAK,EAAE,KAAK,SAAS;AAG5B,UAAM,KAAK,MAAM,IAAI,EAAE;AACvB,YAAQ,MAAM,KAAK,UAAU,EAAE,SAAS,MAAM;AAC5C,YAAM,MAAM,SAAS,eAAe,KAAK;AACzC,aAAO,KAAK,eAAe;AAAA,IAC7B,CAAC;AACD,WAAO,KAAK,EAAE,KAAK,MAAM;AAAA,EAC3B,CAAC;AACH,CAAC;",
+  "names": []
+}