@browserbasehq/orca 3.0.9-alpha-3 → 3.1.0-headers

package/dist/esm/lib/v3/dom/locatorScripts/counts.js

@@ -0,0 +1,272 @@
+import { countXPathMatches } from "./xpathResolver.js";
+export function countCssMatchesPrimary(selectorRaw) {
+    const selector = String(selectorRaw ?? "").trim();
+    if (!selector)
+        return 0;
+    const seen = new WeakSet();
+    const visit = (root) => {
+        if (!root || seen.has(root))
+            return 0;
+        seen.add(root);
+        let total = 0;
+        try {
+            const queryable = root;
+            if (typeof queryable.querySelectorAll === "function") {
+                total += queryable.querySelectorAll(selector).length;
+            }
+        }
+        catch {
+            // ignore query errors
+        }
+        try {
+            const doc = root instanceof Document
+                ? root
+                : (root?.ownerDocument ?? document);
+            const walker = doc.createTreeWalker(root, NodeFilter.SHOW_ELEMENT);
+            let node;
+            while ((node = walker.nextNode())) {
+                if (node instanceof Element && node.shadowRoot) {
+                    total += visit(node.shadowRoot);
+                }
+            }
+        }
+        catch {
+            // ignore traversal errors
+        }
+        return total;
+    };
+    try {
+        return visit(document);
+    }
+    catch {
+        try {
+            return document.querySelectorAll(selector).length;
+        }
+        catch {
+            return 0;
+        }
+    }
+}
+export function countCssMatchesPierce(selectorRaw) {
+    const selector = String(selectorRaw ?? "").trim();
+    if (!selector)
+        return 0;
+    const backdoor = window.__stagehandV3__;
+    if (!backdoor || typeof backdoor.getClosedRoot !== "function") {
+        try {
+            return document.querySelectorAll(selector).length;
+        }
+        catch {
+            return 0;
+        }
+    }
+    const seen = new WeakSet();
+    const queue = [];
+    const enqueue = (node) => {
+        if (!node || seen.has(node))
+            return;
+        seen.add(node);
+        queue.push(node);
+    };
+    enqueue(document);
+    let total = 0;
+    const visitElement = (element) => {
+        const open = element.shadowRoot;
+        if (open)
+            enqueue(open);
+        try {
+            const closed = backdoor.getClosedRoot(element);
+            if (closed)
+                enqueue(closed);
+        }
+        catch {
+            // ignore
+        }
+    };
+    while (queue.length) {
+        const root = queue.shift();
+        if (!root)
+            continue;
+        try {
+            const queryable = root;
+            if (typeof queryable.querySelectorAll === "function") {
+                total += queryable.querySelectorAll(selector).length;
+            }
+        }
+        catch {
+            // ignore query errors
+        }
+        try {
+            const doc = root instanceof Document
+                ? root
+                : root instanceof ShadowRoot
+                    ? (root.host?.ownerDocument ?? document)
+                    : (root.ownerDocument ?? document);
+            const walker = doc.createTreeWalker(root, NodeFilter.SHOW_ELEMENT);
+            let node;
+            while ((node = walker.nextNode())) {
+                if (node instanceof Element) {
+                    visitElement(node);
+                }
+            }
+        }
+        catch {
+            // ignore traversal errors
+        }
+    }
+    return total;
+}
+export function countTextMatches(rawNeedle) {
+    const needle = String(rawNeedle ?? "");
+    if (!needle) {
+        return { count: 0, sample: [], error: null };
+    }
+    const needleLc = needle.toLowerCase();
+    const skipTags = new Set([
+        "SCRIPT",
+        "STYLE",
+        "TEMPLATE",
+        "NOSCRIPT",
+        "HEAD",
+        "TITLE",
+        "LINK",
+        "META",
+        "HTML",
+        "BODY",
+    ]);
+    const shouldSkip = (node) => {
+        if (!node)
+            return false;
+        const tag = node.tagName?.toUpperCase() ?? "";
+        return skipTags.has(tag);
+    };
+    const extractText = (element) => {
+        try {
+            if (shouldSkip(element))
+                return "";
+            const inner = element.innerText;
+            if (typeof inner === "string" && inner.trim())
+                return inner.trim();
+        }
+        catch {
+            // ignore
+        }
+        try {
+            const text = element.textContent;
+            if (typeof text === "string")
+                return text.trim();
+        }
+        catch {
+            // ignore
+        }
+        return "";
+    };
+    const matches = (element) => {
+        const text = extractText(element);
+        return !!text && text.toLowerCase().includes(needleLc);
+    };
+    const backdoor = window.__stagehandV3__;
+    const getClosedRoot = backdoor && typeof backdoor.getClosedRoot === "function"
+        ? (host) => {
+            try {
+                return backdoor.getClosedRoot(host) ?? null;
+            }
+            catch {
+                return null;
+            }
+        }
+        : (host) => {
+            void host;
+            return null;
+        };
+    const seen = new WeakSet();
+    const queue = [];
+    const enqueue = (node) => {
+        if (!node || seen.has(node))
+            return;
+        seen.add(node);
+        queue.push(node);
+    };
+    const walkerFor = (root) => {
+        try {
+            const doc = root instanceof Document
+                ? root
+                : (root?.ownerDocument ?? document);
+            return doc.createTreeWalker(root, NodeFilter.SHOW_ELEMENT);
+        }
+        catch {
+            return null;
+        }
+    };
+    const matchesList = [];
+    enqueue(document);
+    while (queue.length) {
+        const root = queue.shift();
+        if (!root)
+            continue;
+        if (root instanceof Element && matches(root)) {
+            matchesList.push({
+                element: root,
+                tag: root.tagName ?? "",
+                id: root.id ?? "",
+                className: root.className ?? "",
+                text: extractText(root),
+            });
+        }
+        const walker = walkerFor(root);
+        if (!walker)
+            continue;
+        let node;
+        while ((node = walker.nextNode())) {
+            if (!(node instanceof Element))
+                continue;
+            if (matches(node)) {
+                matchesList.push({
+                    element: node,
+                    tag: node.tagName ?? "",
+                    id: node.id ?? "",
+                    className: node.className ?? "",
+                    text: extractText(node),
+                });
+            }
+            const open = node.shadowRoot;
+            if (open)
+                enqueue(open);
+            const closed = getClosedRoot(node);
+            if (closed)
+                enqueue(closed);
+        }
+    }
+    const innermost = [];
+    for (const item of matchesList) {
+        const el = item.element;
+        let skip = false;
+        for (const other of matchesList) {
+            if (item === other)
+                continue;
+            try {
+                if (el.contains(other.element)) {
+                    skip = true;
+                    break;
+                }
+            }
+            catch {
+                // ignore containment errors
+            }
+        }
+        if (!skip)
+            innermost.push(item);
+    }
+    const count = innermost.length;
+    const sample = innermost.slice(0, 5).map((item) => ({
+        tag: item.tag,
+        id: item.id,
+        class: item.className,
+        text: item.text,
+    }));
+    return { count, sample, error: null };
+}
+export function countXPathMatchesMainWorld(rawXp) {
+    return countXPathMatches(rawXp, { pierceShadow: true });
+}
+//# sourceMappingURL=counts.js.map

package/dist/esm/lib/v3/dom/locatorScripts/counts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"counts.js","sourceRoot":"","sources":["../../../../../../lib/v3/dom/locatorScripts/counts.ts"],"names":[],"mappings":"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","sourcesContent":["import { countXPathMatches } from \"./xpathResolver.js\";\n\nexport interface TextMatchSample {\n  tag: string;\n  id: string;\n  class: string;\n  text: string;\n}\n\nexport interface TextMatchResult {\n  count: number;\n  sample: TextMatchSample[];\n  error: null;\n}\n\nexport function countCssMatchesPrimary(selectorRaw: string): number {\n  const selector = String(selectorRaw ?? \"\").trim();\n  if (!selector) return 0;\n\n  const seen = new WeakSet<Node>();\n\n  const visit = (root: Node | null | undefined): number => {\n    if (!root || seen.has(root)) return 0;\n    seen.add(root);\n\n    let total = 0;\n    try {\n      const queryable = root as unknown as ParentNode & {\n        querySelectorAll?: Document[\"querySelectorAll\"];\n      };\n      if (typeof queryable.querySelectorAll === \"function\") {\n        total += queryable.querySelectorAll(selector).length;\n      }\n    } catch {\n      // ignore query errors\n    }\n\n    try {\n      const doc =\n        root instanceof Document\n          ? root\n          : ((root as Element)?.ownerDocument ?? document);\n      const walker = doc.createTreeWalker(root, NodeFilter.SHOW_ELEMENT);\n      let node: Node | null;\n      while ((node = walker.nextNode())) {\n        if (node instanceof Element && node.shadowRoot) {\n          total += visit(node.shadowRoot);\n        }\n      }\n    } catch {\n      // ignore traversal errors\n    }\n\n    return total;\n  };\n\n  try {\n    return visit(document);\n  } catch {\n    try {\n      return document.querySelectorAll(selector).length;\n    } catch {\n      return 0;\n    }\n  }\n}\n\nexport function countCssMatchesPierce(selectorRaw: string): number {\n  const selector = String(selectorRaw ?? \"\").trim();\n  if (!selector) return 0;\n\n  const backdoor = window.__stagehandV3__;\n  if (!backdoor || typeof backdoor.getClosedRoot !== \"function\") {\n    try {\n      return document.querySelectorAll(selector).length;\n    } catch {\n      return 0;\n    }\n  }\n\n  const seen = new WeakSet<Node>();\n  const queue: Node[] = [];\n\n  const enqueue = (node: Node | null | undefined) => {\n    if (!node || seen.has(node)) return;\n    seen.add(node);\n    queue.push(node);\n  };\n\n  enqueue(document);\n  let total = 0;\n\n  const visitElement = (element: Element) => {\n    const open = element.shadowRoot;\n    if (open) enqueue(open);\n    try {\n      const closed = backdoor.getClosedRoot(element);\n      if (closed) enqueue(closed);\n    } catch {\n      // ignore\n    }\n  };\n\n  while (queue.length) {\n    const root = queue.shift();\n    if (!root) continue;\n\n    try {\n      const queryable = root as unknown as ParentNode & {\n        querySelectorAll?: Document[\"querySelectorAll\"];\n      };\n      if (typeof queryable.querySelectorAll === \"function\") {\n        total += queryable.querySelectorAll(selector).length;\n      }\n    } catch {\n      // ignore query errors\n    }\n\n    try {\n      const doc =\n        root instanceof Document\n          ? root\n          : root instanceof ShadowRoot\n            ? (root.host?.ownerDocument ?? document)\n            : ((root as Element).ownerDocument ?? document);\n      const walker = doc.createTreeWalker(root, NodeFilter.SHOW_ELEMENT);\n      let node: Node | null;\n      while ((node = walker.nextNode())) {\n        if (node instanceof Element) {\n          visitElement(node);\n        }\n      }\n    } catch {\n      // ignore traversal errors\n    }\n  }\n\n  return total;\n}\n\nexport function countTextMatches(rawNeedle: string): TextMatchResult {\n  const needle = String(rawNeedle ?? \"\");\n  if (!needle) {\n    return { count: 0, sample: [], error: null };\n  }\n\n  const needleLc = needle.toLowerCase();\n  const skipTags = new Set([\n    \"SCRIPT\",\n    \"STYLE\",\n    \"TEMPLATE\",\n    \"NOSCRIPT\",\n    \"HEAD\",\n    \"TITLE\",\n    \"LINK\",\n    \"META\",\n    \"HTML\",\n    \"BODY\",\n  ]);\n\n  const shouldSkip = (node: Element | null | undefined): boolean => {\n    if (!node) return false;\n    const tag = node.tagName?.toUpperCase() ?? \"\";\n    return skipTags.has(tag);\n  };\n\n  const extractText = (element: Element): string => {\n    try {\n      if (shouldSkip(element)) return \"\";\n      const inner = (element as HTMLElement).innerText;\n      if (typeof inner === \"string\" && inner.trim()) return inner.trim();\n    } catch {\n      // ignore\n    }\n    try {\n      const text = element.textContent;\n      if (typeof text === \"string\") return text.trim();\n    } catch {\n      // ignore\n    }\n    return \"\";\n  };\n\n  const matches = (element: Element): boolean => {\n    const text = extractText(element);\n    return !!text && text.toLowerCase().includes(needleLc);\n  };\n\n  const backdoor = window.__stagehandV3__;\n  const getClosedRoot: (host: Element) => ShadowRoot | null =\n    backdoor && typeof backdoor.getClosedRoot === \"function\"\n      ? (host: Element): ShadowRoot | null => {\n          try {\n            return backdoor.getClosedRoot(host) ?? null;\n          } catch {\n            return null;\n          }\n        }\n      : (host: Element): ShadowRoot | null => {\n          void host;\n          return null;\n        };\n\n  const seen = new WeakSet<Node>();\n  const queue: Node[] = [];\n\n  const enqueue = (node: Node | null | undefined) => {\n    if (!node || seen.has(node)) return;\n    seen.add(node);\n    queue.push(node);\n  };\n\n  const walkerFor = (root: Node): TreeWalker | null => {\n    try {\n      const doc =\n        root instanceof Document\n          ? root\n          : ((root as Element)?.ownerDocument ?? document);\n      return doc.createTreeWalker(root, NodeFilter.SHOW_ELEMENT);\n    } catch {\n      return null;\n    }\n  };\n\n  const matchesList: Array<{\n    element: Element;\n    tag: string;\n    id: string;\n    className: string;\n    text: string;\n  }> = [];\n\n  enqueue(document);\n\n  while (queue.length) {\n    const root = queue.shift();\n    if (!root) continue;\n\n    if (root instanceof Element && matches(root)) {\n      matchesList.push({\n        element: root,\n        tag: root.tagName ?? \"\",\n        id: root.id ?? \"\",\n        className: (root as HTMLElement).className ?? \"\",\n        text: extractText(root),\n      });\n    }\n\n    const walker = walkerFor(root);\n    if (!walker) continue;\n\n    let node: Node | null;\n    while ((node = walker.nextNode())) {\n      if (!(node instanceof Element)) continue;\n\n      if (matches(node)) {\n        matchesList.push({\n          element: node,\n          tag: node.tagName ?? \"\",\n          id: node.id ?? \"\",\n          className: (node as HTMLElement).className ?? \"\",\n          text: extractText(node),\n        });\n      }\n\n      const open = node.shadowRoot;\n      if (open) enqueue(open);\n\n      const closed = getClosedRoot(node);\n      if (closed) enqueue(closed);\n    }\n  }\n\n  const innermost: typeof matchesList = [];\n  for (const item of matchesList) {\n    const el = item.element;\n    let skip = false;\n    for (const other of matchesList) {\n      if (item === other) continue;\n      try {\n        if (el.contains(other.element)) {\n          skip = true;\n          break;\n        }\n      } catch {\n        // ignore containment errors\n      }\n    }\n    if (!skip) innermost.push(item);\n  }\n\n  const count = innermost.length;\n  const sample = innermost.slice(0, 5).map((item) => ({\n    tag: item.tag,\n    id: item.id,\n    class: item.className,\n    text: item.text,\n  }));\n\n  return { count, sample, error: null };\n}\n\nexport function countXPathMatchesMainWorld(rawXp: string): number {\n  return countXPathMatches(rawXp, { pierceShadow: true });\n}\n"]}

package/dist/esm/lib/v3/dom/locatorScripts/index.d.ts

@@ -0,0 +1,4 @@
+export * from "./scripts.js";
+export * from "./selectors.js";
+export * from "./counts.js";
+export * from "./waitForSelector.js";

package/dist/esm/lib/v3/dom/locatorScripts/index.js

@@ -0,0 +1,5 @@
+export * from "./scripts.js";
+export * from "./selectors.js";
+export * from "./counts.js";
+export * from "./waitForSelector.js";
+//# sourceMappingURL=index.js.map

package/dist/esm/lib/v3/dom/locatorScripts/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../lib/v3/dom/locatorScripts/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC;AAC7B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,aAAa,CAAC;AAC5B,cAAc,sBAAsB,CAAC","sourcesContent":["export * from \"./scripts.js\";\nexport * from \"./selectors.js\";\nexport * from \"./counts.js\";\nexport * from \"./waitForSelector.js\";\n"]}

package/dist/esm/lib/v3/dom/locatorScripts/scripts.d.ts

@@ -0,0 +1,37 @@
+export interface ClickEventOptions {
+    bubbles?: boolean;
+    cancelable?: boolean;
+    composed?: boolean;
+    detail?: number;
+}
+export declare function ensureFileInputElement(this: Element): boolean;
+export interface SerializedFilePayload {
+    name: string;
+    mimeType: string;
+    base64: string;
+    lastModified?: number;
+}
+/** Attach File objects created from serialized payloads to an <input type="file">. */
+export declare function assignFilePayloadsToInputElement(this: Element, payloads: SerializedFilePayload[]): boolean;
+export declare function dispatchDomClick(this: Element, options?: ClickEventOptions): void;
+export declare function scrollElementToPercent(this: Element, percent: number | string): boolean;
+export type FillElementResult = {
+    status: "done";
+} | {
+    status: "needsinput";
+    value: string;
+    reason?: string;
+} | {
+    status: "error";
+    reason: string;
+};
+export declare function prepareElementForTyping(this: Element): boolean;
+export declare function fillElementValue(this: Element, rawValue: string): FillElementResult;
+export declare function focusElement(this: Element): void;
+export declare function selectElementOptions(this: Element, rawValues: string | string[]): string[];
+export declare function isElementVisible(this: Element): boolean;
+export declare function isElementChecked(this: Element): boolean;
+export declare function readElementInputValue(this: Element): string;
+export declare function readElementTextContent(this: Element): string;
+export declare function readElementInnerHTML(this: Element): string;
+export declare function readElementInnerText(this: Element): string;