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

package/dist/esm/lib/v3/understudy/locator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"locator.js","sourceRoot":"","sources":["../../../../../lib/v3/understudy/locator.ts"],"names":[],"mappings":"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","sourcesContent":["// lib/v3/understudy/locator.ts\nimport { Protocol } from \"devtools-protocol\";\nimport * as fs from \"fs\";\nimport * as os from \"os\";\nimport * as path from \"path\";\nimport {\n  locatorScriptBootstrap,\n  locatorScriptGlobalRefs,\n  locatorScriptSources,\n} from \"../dom/build/locatorScripts.generated.js\";\nimport type { Frame } from \"./frame.js\";\nimport {\n  FrameSelectorResolver,\n  type SelectorQuery,\n} from \"./selectorResolver.js\";\nimport {\n  StagehandElementNotFoundError,\n  StagehandInvalidArgumentError,\n  StagehandLocatorError,\n  ElementNotVisibleError,\n} from \"../types/public/sdkErrors.js\";\nimport { normalizeInputFiles } from \"./fileUploadUtils.js\";\nimport { SetInputFilesArgument, MouseButton } from \"../types/public/locator.js\";\nimport { NormalizedFilePayload } from \"../types/private/locator.js\";\n\nconst MAX_REMOTE_UPLOAD_BYTES = 50 * 1024 * 1024; // 50MB guard copied from Playwright\n\n/**\n * Locator\n *\n * Purpose:\n * A small, CDP-based element interaction helper scoped to a specific `Frame`.\n * It resolves a CSS/XPath selector inside the frame’s **isolated world**, and then\n * performs low-level actions (click, type, select) using DOM/Runtime/Input\n * protocol domains with minimal abstraction.\n *\n * Key change:\n * - Prefer **objectId**-based CDP calls (scroll, geometry) to avoid brittle\n *   frontend nodeId mappings. nodeId is resolved on a best-effort basis and\n *   returned for compatibility, but actions do not depend on it.\n *\n * Notes:\n * - Resolution is lazy: every action resolves the selector again.\n * - Uses `Page.createIsolatedWorld` so evaluation is isolated from page scripts.\n * - Releases remote objects (`Runtime.releaseObject`) where appropriate.\n */\nexport class Locator {\n  private readonly selectorResolver: FrameSelectorResolver;\n\n  private readonly selectorQuery: SelectorQuery;\n\n  // -1 means \"no explicit nth()\"; default locator resolves to first match for actions.\n  private readonly nthIndex: number;\n\n  constructor(\n    private readonly frame: Frame,\n    private readonly selector: string,\n    private readonly options?: { deep?: boolean; depth?: number },\n    nthIndex: number = -1,\n  ) {\n    this.selectorResolver = new FrameSelectorResolver(this.frame);\n    this.selectorQuery = FrameSelectorResolver.parseSelector(selector);\n    const normalized = Number.isFinite(nthIndex) ? Math.floor(nthIndex) : -1;\n    this.nthIndex = normalized < 0 ? -1 : normalized;\n  }\n\n  /** Return the owning Frame for this locator (typed accessor, no private access). */\n  public getFrame(): Frame {\n    return this.frame;\n  }\n\n  /**\n   * Set files on an <input type=\"file\"> element.\n   *\n   * Mirrors Playwright's Locator.setInputFiles basics:\n   * - Accepts file path(s) or payload object(s) { name, mimeType, buffer }.\n   * - Uses CDP DOM.setFileInputFiles under the hood.\n   * - Best‑effort dispatches change/input via CDP (Chrome does by default).\n   * - Passing an empty array clears the selection.\n   */\n  public async setInputFiles(files: SetInputFilesArgument): Promise<void> {\n    const session = this.frame.session;\n    const { objectId } = await this.resolveNode();\n\n    const tempFiles: string[] = [];\n\n    try {\n      // Validate element is an <input type=\"file\">\n      try {\n        const res = await session.send<Protocol.Runtime.CallFunctionOnResponse>(\n          \"Runtime.callFunctionOn\",\n          {\n            objectId,\n            functionDeclaration: locatorScriptSources.ensureFileInputElement,\n            returnByValue: true,\n          },\n        );\n        const ok = Boolean(res.result.value);\n        if (!ok)\n          throw new StagehandInvalidArgumentError(\n            'Target is not an <input type=\"file\"> element',\n          );\n      } catch (e) {\n        throw new StagehandInvalidArgumentError(\n          e instanceof Error\n            ? e.message\n            : \"Unable to verify file input element\",\n        );\n      }\n\n      const normalized = await normalizeInputFiles(files);\n\n      if (!normalized.length) {\n        await session.send<never>(\"DOM.setFileInputFiles\", {\n          objectId,\n          files: [],\n        });\n        return;\n      }\n\n      if (this.frame.isBrowserRemote()) {\n        await this.assignFilesViaPayloadInjection(objectId, normalized);\n        return;\n      }\n\n      const filePaths: string[] = [];\n      for (const payload of normalized) {\n        if (payload.absolutePath) {\n          filePaths.push(payload.absolutePath);\n          continue;\n        }\n        const ext = path.extname(payload.name);\n        const tmp = path.join(\n          os.tmpdir(),\n          `stagehand-upload-${Date.now()}-${Math.random().toString(36).slice(2)}${ext}`,\n        );\n        await fs.promises.writeFile(tmp, payload.buffer);\n        tempFiles.push(tmp);\n        filePaths.push(tmp);\n      }\n\n      await session.send<never>(\"DOM.setFileInputFiles\", {\n        objectId,\n        files: filePaths,\n      });\n    } finally {\n      // Cleanup: release element and remove any temporary files we created\n      await session\n        .send<never>(\"Runtime.releaseObject\", { objectId })\n        .catch(() => {});\n      for (const p of tempFiles) {\n        try {\n          await fs.promises.unlink(p);\n        } catch {\n          // ignore\n        }\n      }\n    }\n  }\n\n  /**\n   * Remote browser fallback: build File objects inside the page and attach them via JS.\n   *\n   * When Stagehand is driving a browser that cannot see the local filesystem (Browserbase,\n   * remote CDP, etc.), CDP's DOM.setFileInputFiles would fail because Chrome can't reach\n   * our temp files. Instead we base64-encode the payloads, send them into the page, and\n   * let a DOM helper create File objects + dispatch change/input events.\n   */\n  private async assignFilesViaPayloadInjection(\n    objectId: Protocol.Runtime.RemoteObjectId,\n    files: NormalizedFilePayload[],\n  ): Promise<void> {\n    const session = this.frame.session;\n\n    for (const payload of files) {\n      if (payload.buffer.length > MAX_REMOTE_UPLOAD_BYTES) {\n        throw new StagehandInvalidArgumentError(\n          `setInputFiles(): file \"${payload.name}\" is larger than the 50MB limit for remote uploads`,\n        );\n      }\n    }\n\n    const serialized = files.map((payload) => ({\n      name: payload.name,\n      mimeType: payload.mimeType,\n      lastModified: payload.lastModified,\n      base64: payload.buffer.toString(\"base64\"),\n    }));\n\n    const res = await session.send<Protocol.Runtime.CallFunctionOnResponse>(\n      \"Runtime.callFunctionOn\",\n      {\n        objectId,\n        functionDeclaration:\n          locatorScriptSources.assignFilePayloadsToInputElement,\n        arguments: [\n          {\n            value: serialized,\n          },\n        ],\n        returnByValue: true,\n      },\n    );\n\n    const ok = Boolean(res.result?.value);\n    if (!ok) {\n      throw new StagehandInvalidArgumentError(\n        \"Unable to assign file payloads to remote input element\",\n      );\n    }\n  }\n\n  /**\n   * Return the DOM backendNodeId for this locator's target element.\n   * Useful for identity comparisons without needing element handles.\n   */\n  async backendNodeId(): Promise<Protocol.DOM.BackendNodeId> {\n    const session = this.frame.session;\n    const { objectId } = await this.resolveNode();\n    try {\n      await session.send(\"DOM.enable\").catch(() => {});\n      const { node } = await session.send<{ node: Protocol.DOM.Node }>(\n        \"DOM.describeNode\",\n        { objectId },\n      );\n      return node.backendNodeId as Protocol.DOM.BackendNodeId;\n    } finally {\n      await session\n        .send<never>(\"Runtime.releaseObject\", { objectId })\n        .catch(() => {});\n    }\n  }\n\n  /** Return how many nodes the current selector resolves to. */\n  public async count(): Promise<number> {\n    const session = this.frame.session;\n    await session.send(\"Runtime.enable\");\n    await session.send(\"DOM.enable\");\n    return this.selectorResolver.count(this.selectorQuery);\n  }\n\n  /**\n   * Return the center of the element's bounding box in the owning frame's viewport\n   * (CSS pixels), rounded to integers. Scrolls into view best-effort.\n   */\n  public async centroid(): Promise<{ x: number; y: number }> {\n    const session = this.frame.session;\n    const { objectId } = await this.resolveNode();\n    try {\n      await session\n        .send(\"DOM.scrollIntoViewIfNeeded\", { objectId })\n        .catch(() => {});\n      const box = await session.send<Protocol.DOM.GetBoxModelResponse>(\n        \"DOM.getBoxModel\",\n        { objectId },\n      );\n      if (!box.model) throw new ElementNotVisibleError(this.selector);\n      const { cx, cy } = this.centerFromBoxContent(box.model.content);\n      return { x: Math.round(cx), y: Math.round(cy) };\n    } finally {\n      await session\n        .send<never>(\"Runtime.releaseObject\", { objectId })\n        .catch(() => {});\n    }\n  }\n\n  /**\n   * Highlight the element's bounding box using the CDP Overlay domain.\n   * - Scrolls element into view best-effort.\n   * - Shows a semi-transparent overlay briefly, then hides it.\n   */\n  public async highlight(options?: {\n    durationMs?: number;\n    borderColor?: { r: number; g: number; b: number; a?: number };\n    contentColor?: { r: number; g: number; b: number; a?: number };\n  }): Promise<void> {\n    const session = this.frame.session;\n    const { objectId } = await this.resolveNode();\n    const duration = Math.max(0, options?.durationMs ?? 800);\n\n    const borderColor = options?.borderColor ?? { r: 255, g: 0, b: 0, a: 0.9 };\n    const contentColor =\n      options?.contentColor ?? ({ r: 255, g: 200, b: 0, a: 0.2 } as const);\n\n    try {\n      await session.send(\"Overlay.enable\").catch(() => {});\n      await session\n        .send(\"DOM.scrollIntoViewIfNeeded\", { objectId })\n        .catch(() => {});\n\n      // Prefer backendNodeId to keep highlight stable even if objectId is released.\n      await session.send(\"DOM.enable\").catch(() => {});\n      let backendNodeId: Protocol.DOM.BackendNodeId | undefined;\n      try {\n        const { node } = await session.send<{ node: Protocol.DOM.Node }>(\n          \"DOM.describeNode\",\n          { objectId },\n        );\n        backendNodeId = node.backendNodeId as Protocol.DOM.BackendNodeId;\n      } catch {\n        backendNodeId = undefined;\n      }\n\n      const highlightConfig: Protocol.Overlay.HighlightConfig = {\n        showInfo: false,\n        showStyles: false,\n        showRulers: false,\n        showExtensionLines: false,\n        borderColor,\n        contentColor,\n      } as Protocol.Overlay.HighlightConfig;\n\n      const highlightOnce = async () => {\n        await session.send<never>(\"Overlay.highlightNode\", {\n          ...(backendNodeId ? { backendNodeId } : { objectId }),\n          highlightConfig,\n        });\n      };\n\n      // Initial draw\n      await highlightOnce();\n\n      // Keep alive until duration elapses to resist overlay clears on mouse move/repaints\n      if (duration > 0) {\n        const start = Date.now();\n        const tick = Math.min(300, Math.max(100, Math.floor(duration / 50)));\n        while (Date.now() - start < duration) {\n          await new Promise((r) => setTimeout(r, tick));\n          try {\n            await highlightOnce();\n          } catch {\n            // ignore transient errors\n          }\n        }\n        await session.send<never>(\"Overlay.hideHighlight\").catch(() => {});\n      }\n    } finally {\n      // Releasing objectId should not affect highlight when using backendNodeId.\n      await session\n        .send<never>(\"Runtime.releaseObject\", { objectId })\n        .catch(() => {});\n    }\n  }\n\n  /**\n   * Move the mouse cursor to the element's visual center without clicking.\n   * - Scrolls into view best-effort, resolves geometry, then dispatches a mouse move.\n   */\n  async hover(): Promise<void> {\n    const session = this.frame.session;\n    const { objectId } = await this.resolveNode();\n    try {\n      await session\n        .send(\"DOM.scrollIntoViewIfNeeded\", { objectId })\n        .catch(() => {});\n\n      const box = await session.send<Protocol.DOM.GetBoxModelResponse>(\n        \"DOM.getBoxModel\",\n        { objectId },\n      );\n      if (!box.model) throw new ElementNotVisibleError(this.selector);\n      const { cx, cy } = this.centerFromBoxContent(box.model.content);\n\n      await session.send<never>(\"Input.dispatchMouseEvent\", {\n        type: \"mouseMoved\",\n        x: cx,\n        y: cy,\n        button: \"none\",\n      } as Protocol.Input.DispatchMouseEventRequest);\n    } finally {\n      await session\n        .send<never>(\"Runtime.releaseObject\", { objectId })\n        .catch(() => {});\n    }\n  }\n\n  /**\n   * Click the element at its visual center.\n   * Steps:\n   *  1) Resolve selector to { objectId } in the frame world.\n   *  2) Scroll into view via `DOM.scrollIntoViewIfNeeded({ objectId })`.\n   *  3) Read geometry via `DOM.getBoxModel({ objectId })` → compute a center point.\n   *  4) Synthesize mouse press + release via `Input.dispatchMouseEvent`.\n   */\n  async click(options?: {\n    button?: MouseButton;\n    clickCount?: number;\n  }): Promise<void> {\n    const session = this.frame.session;\n    const { objectId } = await this.resolveNode();\n\n    const button = options?.button ?? \"left\";\n    const clickCount = options?.clickCount ?? 1;\n\n    try {\n      // Scroll into view using objectId (avoids frontend nodeId dependence)\n      await session.send(\"DOM.scrollIntoViewIfNeeded\", { objectId });\n\n      // Get geometry using objectId\n      const box = await session.send<Protocol.DOM.GetBoxModelResponse>(\n        \"DOM.getBoxModel\",\n        { objectId },\n      );\n      if (!box.model) throw new ElementNotVisibleError(this.selector);\n      const { cx, cy } = this.centerFromBoxContent(box.model.content);\n\n      // Dispatch input (from the same session) without waiting between events.\n      // This keeps multi-clicks within tight thresholds on remote browsers.\n      const dispatches: Array<Promise<unknown>> = [];\n      dispatches.push(\n        session.send<never>(\"Input.dispatchMouseEvent\", {\n          type: \"mouseMoved\",\n          x: cx,\n          y: cy,\n          button: \"none\",\n        } as Protocol.Input.DispatchMouseEventRequest),\n      );\n\n      for (let i = 1; i <= clickCount; i++) {\n        dispatches.push(\n          session.send<never>(\"Input.dispatchMouseEvent\", {\n            type: \"mousePressed\",\n            x: cx,\n            y: cy,\n            button,\n            clickCount: i,\n          } as Protocol.Input.DispatchMouseEventRequest),\n        );\n\n        dispatches.push(\n          session.send<never>(\"Input.dispatchMouseEvent\", {\n            type: \"mouseReleased\",\n            x: cx,\n            y: cy,\n            button,\n            clickCount: i,\n          } as Protocol.Input.DispatchMouseEventRequest),\n        );\n      }\n\n      await Promise.all(dispatches);\n    } finally {\n      // release the element handle\n      try {\n        await session.send<never>(\"Runtime.releaseObject\", { objectId });\n      } catch {\n        // If the context navigated or was destroyed (e.g., link opens new tab),\n        // releaseObject may fail with -32000. Ignore as best-effort cleanup.\n      }\n    }\n  }\n\n  /**\n   * Dispatch a DOM 'click' MouseEvent on the element itself.\n   * - Does not synthesize real pointer input; directly dispatches an event.\n   * - Useful for elements that rely on click handlers without needing hit-testing.\n   */\n  async sendClickEvent(options?: {\n    bubbles?: boolean;\n    cancelable?: boolean;\n    composed?: boolean;\n    detail?: number;\n  }): Promise<void> {\n    const session = this.frame.session;\n    const { objectId } = await this.resolveNode();\n    const bubbles = options?.bubbles ?? true;\n    const cancelable = options?.cancelable ?? true;\n    const composed = options?.composed ?? true;\n    const detail = options?.detail ?? 1;\n    try {\n      await session\n        .send(\"DOM.scrollIntoViewIfNeeded\", { objectId })\n        .catch(() => {});\n      await session.send<Protocol.Runtime.CallFunctionOnResponse>(\n        \"Runtime.callFunctionOn\",\n        {\n          objectId,\n          functionDeclaration: locatorScriptSources.dispatchDomClick,\n          arguments: [\n            {\n              value: { bubbles, cancelable, composed, detail },\n            },\n          ],\n          returnByValue: true,\n        },\n      );\n    } finally {\n      await session\n        .send<never>(\"Runtime.releaseObject\", { objectId })\n        .catch(() => {});\n    }\n  }\n\n  /**\n   * Scroll the element vertically to a given percentage (0–100).\n   * - If the element is <html> or <body>, scrolls the window/document.\n   * - Otherwise, scrolls the element itself via element.scrollTo.\n   */\n  async scrollTo(percent: number | string): Promise<void> {\n    const session = this.frame.session;\n    const { objectId } = await this.resolveNode();\n    try {\n      await session.send<Protocol.Runtime.CallFunctionOnResponse>(\n        \"Runtime.callFunctionOn\",\n        {\n          objectId,\n          functionDeclaration: locatorScriptSources.scrollElementToPercent,\n          arguments: [{ value: percent as unknown as number }],\n          returnByValue: true,\n        },\n      );\n    } finally {\n      await session\n        .send<never>(\"Runtime.releaseObject\", { objectId })\n        .catch(() => {});\n    }\n  }\n\n  /**\n   * Fill an input/textarea/contenteditable element.\n   * Mirrors Playwright semantics: the DOM helper either applies the native\n   * value setter (for special input types) or asks us to type text via the CDP\n   * Input domain after focusing/selecting.\n   */\n  async fill(value: string): Promise<void> {\n    const session = this.frame.session;\n    // Use the bundled locator globals; the raw fill snippet depends on helper symbols.\n    const fillDeclaration = `function(value) { ${locatorScriptBootstrap}; return ${locatorScriptGlobalRefs.fillElementValue}.call(this, value); }`;\n    const { objectId } = await this.resolveNode();\n\n    let releaseNeeded = true;\n\n    try {\n      const res = await session.send<Protocol.Runtime.CallFunctionOnResponse>(\n        \"Runtime.callFunctionOn\",\n        {\n          objectId,\n          functionDeclaration: fillDeclaration,\n          arguments: [{ value }],\n          returnByValue: true,\n        },\n      );\n      if (res.exceptionDetails) {\n        // prefer exception.description over text (eg \"Uncaught\")\n        const message =\n          res.exceptionDetails.exception?.description ??\n          res.exceptionDetails.text ??\n          \"Unknown exception during locator().fill()\";\n        throw new StagehandLocatorError(\"Filling\", this.selector, message);\n      }\n\n      const result = res.result.value as\n        | { status?: string; reason?: string; value?: string }\n        | null\n        | undefined;\n      const status =\n        typeof result === \"object\" && result ? result.status : undefined;\n\n      if (status === \"done\") {\n        return;\n      }\n\n      if (status === \"needsinput\") {\n        // Release the current handle before synthesizing keyboard input to avoid leaking it.\n        await session\n          .send<never>(\"Runtime.releaseObject\", { objectId })\n          .catch(() => {});\n        releaseNeeded = false;\n\n        const valueToType =\n          typeof result?.value === \"string\" ? result.value : value;\n\n        let prepared = false;\n        try {\n          const { objectId: prepObjectId } = await this.resolveNode();\n          try {\n            const prepRes =\n              await session.send<Protocol.Runtime.CallFunctionOnResponse>(\n                \"Runtime.callFunctionOn\",\n                {\n                  objectId: prepObjectId,\n                  functionDeclaration:\n                    locatorScriptSources.prepareElementForTyping,\n                  returnByValue: true,\n                },\n              );\n            prepared = Boolean(prepRes.result.value);\n          } finally {\n            await session\n              .send<never>(\"Runtime.releaseObject\", { objectId: prepObjectId })\n              .catch(() => {});\n          }\n        } catch {\n          // Ignore preparation failures; we'll fall back to typing best-effort.\n        }\n\n        if (!prepared && valueToType.length > 0) {\n          await this.type(valueToType);\n          return;\n        }\n\n        if (valueToType.length === 0) {\n          // Simulate deleting the currently selected text to clear the field.\n          await session.send<never>(\"Input.dispatchKeyEvent\", {\n            type: \"keyDown\",\n            key: \"Backspace\",\n            code: \"Backspace\",\n            windowsVirtualKeyCode: 8,\n            nativeVirtualKeyCode: 8,\n          } as Protocol.Input.DispatchKeyEventRequest);\n          await session.send<never>(\"Input.dispatchKeyEvent\", {\n            type: \"keyUp\",\n            key: \"Backspace\",\n            code: \"Backspace\",\n            windowsVirtualKeyCode: 8,\n            nativeVirtualKeyCode: 8,\n          } as Protocol.Input.DispatchKeyEventRequest);\n        } else {\n          await session.send<never>(\"Input.insertText\", { text: valueToType });\n        }\n\n        return;\n      }\n\n      if (status === \"error\") {\n        const reason =\n          typeof result?.reason === \"string\" && result.reason.length > 0\n            ? result.reason\n            : \"Failed to fill element\";\n        throw new StagehandInvalidArgumentError(\n          `Failed to fill element (${reason})`,\n        );\n      }\n\n      // Backward compatibility: if no status is returned (older bundle), fall back to setter logic.\n      if (!status) {\n        await this.type(value);\n      }\n    } finally {\n      if (releaseNeeded) {\n        await session\n          .send<never>(\"Runtime.releaseObject\", { objectId })\n          .catch(() => {});\n      }\n    }\n  }\n\n  /**\n   * Type text into the element (focuses first).\n   * - Focus via element.focus() in page JS (no DOM.focus(nodeId)).\n   * - If no delay, uses `Input.insertText` for efficiency.\n   * - With delay, synthesizes `keyDown`/`keyUp` per character.\n   */\n  async type(text: string, options?: { delay?: number }): Promise<void> {\n    const session = this.frame.session;\n    const { objectId } = await this.resolveNode();\n\n    try {\n      // Focus using JS (avoids DOM.focus(nodeId))\n      await session.send<Protocol.Runtime.CallFunctionOnResponse>(\n        \"Runtime.callFunctionOn\",\n        {\n          objectId,\n          functionDeclaration: locatorScriptSources.focusElement,\n          returnByValue: true,\n        },\n      );\n\n      if (!options?.delay) {\n        await session.send<never>(\"Input.insertText\", { text });\n        return;\n      }\n\n      for (const ch of text) {\n        await session.send<never>(\"Input.dispatchKeyEvent\", {\n          type: \"keyDown\",\n          text: ch,\n          key: ch,\n        } as Protocol.Input.DispatchKeyEventRequest);\n\n        await session.send<never>(\"Input.dispatchKeyEvent\", {\n          type: \"keyUp\",\n          text: ch,\n          key: ch,\n        } as Protocol.Input.DispatchKeyEventRequest);\n\n        await new Promise((r) => setTimeout(r, options.delay));\n      }\n    } finally {\n      await session.send<never>(\"Runtime.releaseObject\", { objectId });\n    }\n  }\n\n  /**\n   * Select one or more options on a `<select>` element.\n   * Returns the values actually selected after the operation.\n   */\n  async selectOption(values: string | string[]): Promise<string[]> {\n    const session = this.frame.session;\n    const desired = Array.isArray(values) ? values : [values];\n    const { objectId } = await this.resolveNode();\n\n    try {\n      const res = await session.send<Protocol.Runtime.CallFunctionOnResponse>(\n        \"Runtime.callFunctionOn\",\n        {\n          objectId,\n          functionDeclaration: locatorScriptSources.selectElementOptions,\n          arguments: [{ value: desired }],\n          returnByValue: true,\n        },\n      );\n\n      return (res.result.value as string[]) ?? [];\n    } finally {\n      await session.send<never>(\"Runtime.releaseObject\", { objectId });\n    }\n  }\n\n  /**\n   * Return true if the element is attached and visible (rough heuristic).\n   */\n  async isVisible(): Promise<boolean> {\n    const session = this.frame.session;\n    const { objectId } = await this.resolveNode();\n    try {\n      const res = await session.send<Protocol.Runtime.CallFunctionOnResponse>(\n        \"Runtime.callFunctionOn\",\n        {\n          objectId,\n          functionDeclaration: locatorScriptSources.isElementVisible,\n          returnByValue: true,\n        },\n      );\n      return Boolean(res.result.value);\n    } finally {\n      await session.send<never>(\"Runtime.releaseObject\", { objectId });\n    }\n  }\n\n  /**\n   * Return true if the element is an input[type=checkbox|radio] and is checked.\n   * Also considers aria-checked for ARIA widgets.\n   */\n  async isChecked(): Promise<boolean> {\n    const session = this.frame.session;\n    const { objectId } = await this.resolveNode();\n    try {\n      const res = await session.send<Protocol.Runtime.CallFunctionOnResponse>(\n        \"Runtime.callFunctionOn\",\n        {\n          objectId,\n          functionDeclaration: locatorScriptSources.isElementChecked,\n          returnByValue: true,\n        },\n      );\n      return Boolean(res.result.value);\n    } finally {\n      await session.send<never>(\"Runtime.releaseObject\", { objectId });\n    }\n  }\n\n  /**\n   * Return the element's input value (for input/textarea/select/contenteditable).\n   */\n  async inputValue(): Promise<string> {\n    const session = this.frame.session;\n    const { objectId } = await this.resolveNode();\n    try {\n      const res = await session.send<Protocol.Runtime.CallFunctionOnResponse>(\n        \"Runtime.callFunctionOn\",\n        {\n          objectId,\n          functionDeclaration: locatorScriptSources.readElementInputValue,\n          returnByValue: true,\n        },\n      );\n      return String(res.result.value ?? \"\");\n    } finally {\n      await session.send<never>(\"Runtime.releaseObject\", { objectId });\n    }\n  }\n\n  /**\n   * Return the element's textContent (raw, not innerText).\n   */\n  async textContent(): Promise<string> {\n    const session = this.frame.session;\n    const { objectId } = await this.resolveNode();\n    try {\n      const res = await session.send<Protocol.Runtime.CallFunctionOnResponse>(\n        \"Runtime.callFunctionOn\",\n        {\n          objectId,\n          functionDeclaration: locatorScriptSources.readElementTextContent,\n          returnByValue: true,\n        },\n      );\n      return String(res.result.value ?? \"\");\n    } finally {\n      await session.send<never>(\"Runtime.releaseObject\", { objectId });\n    }\n  }\n\n  /**\n   * Return the element's innerHTML string.\n   */\n  async innerHtml(): Promise<string> {\n    const session = this.frame.session;\n    const { objectId } = await this.resolveNode();\n    try {\n      const res = await session.send<Protocol.Runtime.CallFunctionOnResponse>(\n        \"Runtime.callFunctionOn\",\n        {\n          objectId,\n          functionDeclaration: locatorScriptSources.readElementInnerHTML,\n          returnByValue: true,\n        },\n      );\n      return String(res.result.value ?? \"\");\n    } finally {\n      await session.send<never>(\"Runtime.releaseObject\", { objectId });\n    }\n  }\n\n  /**\n   * Return the element's innerText (layout-aware, visible text).\n   */\n  async innerText(): Promise<string> {\n    const session = this.frame.session;\n    const { objectId } = await this.resolveNode();\n    try {\n      const res = await session.send<Protocol.Runtime.CallFunctionOnResponse>(\n        \"Runtime.callFunctionOn\",\n        {\n          objectId,\n          functionDeclaration: locatorScriptSources.readElementInnerText,\n          returnByValue: true,\n        },\n      );\n      return String(res.result.value ?? \"\");\n    } finally {\n      await session.send<never>(\"Runtime.releaseObject\", { objectId });\n    }\n  }\n\n  /**\n   * Return a locator narrowed to the first match.\n   */\n  first(): Locator {\n    return this.nth(0);\n  }\n\n  /** Return a locator narrowed to the element at the given zero-based index. */\n  nth(index: number): Locator {\n    const value = Number(index);\n    if (!Number.isFinite(value) || value < 0) {\n      throw new StagehandInvalidArgumentError(\n        \"locator().nth() expects a non-negative index\",\n      );\n    }\n\n    const nextIndex = Math.floor(value);\n    if (nextIndex === this.nthIndex) {\n      return this;\n    }\n\n    return new Locator(this.frame, this.selector, this.options, nextIndex);\n  }\n\n  // ---------- helpers ----------\n\n  /**\n   * Resolve `this.selector` within the frame to `{ objectId, nodeId? }`:\n   * Delegates to a shared selector resolver so all selector logic stays in sync.\n   */\n  public async resolveNode(): Promise<{\n    nodeId: Protocol.DOM.NodeId | null;\n    objectId: Protocol.Runtime.RemoteObjectId;\n  }> {\n    const session = this.frame.session;\n\n    await session.send(\"Runtime.enable\");\n    await session.send(\"DOM.enable\");\n\n    const index = this.nthIndex < 0 ? 0 : this.nthIndex;\n    const resolved = await this.selectorResolver.resolveAtIndex(\n      this.selectorQuery,\n      index,\n    );\n    if (!resolved) {\n      throw new StagehandElementNotFoundError([this.selector]);\n    }\n\n    return resolved;\n  }\n\n  /**\n   * Resolve all matching nodes for this locator.\n   * If the locator is narrowed via nth(), only that index is returned.\n   */\n  public async resolveNodesForMask(): Promise<\n    Array<{\n      nodeId: Protocol.DOM.NodeId | null;\n      objectId: Protocol.Runtime.RemoteObjectId;\n    }>\n  > {\n    const session = this.frame.session;\n\n    await session.send(\"Runtime.enable\");\n    await session.send(\"DOM.enable\");\n\n    if (this.nthIndex >= 0) {\n      const resolved = await this.selectorResolver.resolveAtIndex(\n        this.selectorQuery,\n        this.nthIndex,\n      );\n      if (!resolved) {\n        throw new StagehandElementNotFoundError([this.selector]);\n      }\n      return [resolved];\n    }\n\n    const resolved = await this.selectorResolver.resolveAll(this.selectorQuery);\n    if (!resolved.length) {\n      throw new StagehandElementNotFoundError([this.selector]);\n    }\n    return resolved;\n  }\n\n  /** Compute a center point from a BoxModel content quad */\n  private centerFromBoxContent(content: number[]): { cx: number; cy: number } {\n    // content is [x1,y1, x2,y2, x3,y3, x4,y4]\n    if (!content || content.length < 8) {\n      throw new StagehandInvalidArgumentError(\"Invalid box model content quad\");\n    }\n    const xs = [content[0], content[2], content[4], content[6]];\n    const ys = [content[1], content[3], content[5], content[7]];\n    const cx = (xs[0] + xs[1] + xs[2] + xs[3]) / 4;\n    const cy = (ys[0] + ys[1] + ys[2] + ys[3]) / 4;\n    return { cx, cy };\n  }\n}\n"]}

package/dist/esm/lib/v3/understudy/locatorInvocation.d.ts

@@ -0,0 +1,8 @@
+import { type LocatorScriptName } from "../dom/build/locatorScripts.generated.js";
+/**
+ * Build an expression that injects the locator bundle (if needed) and invokes a
+ * specific helper via its stable global reference. This keeps Runtime.evaluate
+ * payloads tiny while guaranteeing our selector utilities are present in any
+ * execution context.
+ */
+export declare function buildLocatorInvocation(name: LocatorScriptName, args: string[]): string;

package/dist/esm/lib/v3/understudy/locatorInvocation.js

@@ -0,0 +1,12 @@
+import { locatorScriptBootstrap, locatorScriptGlobalRefs, } from "../dom/build/locatorScripts.generated.js";
+/**
+ * Build an expression that injects the locator bundle (if needed) and invokes a
+ * specific helper via its stable global reference. This keeps Runtime.evaluate
+ * payloads tiny while guaranteeing our selector utilities are present in any
+ * execution context.
+ */
+export function buildLocatorInvocation(name, args) {
+    const invocation = `${locatorScriptGlobalRefs[name]}(${args.join(", ")})`;
+    return `(() => { ${locatorScriptBootstrap}; return ${invocation}; })()`;
+}
+//# sourceMappingURL=locatorInvocation.js.map

package/dist/esm/lib/v3/understudy/locatorInvocation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"locatorInvocation.js","sourceRoot":"","sources":["../../../../../lib/v3/understudy/locatorInvocation.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,sBAAsB,EACtB,uBAAuB,GAExB,MAAM,0CAA0C,CAAC;AAElD;;;;;GAKG;AACH,MAAM,UAAU,sBAAsB,CACpC,IAAuB,EACvB,IAAc;IAEd,MAAM,UAAU,GAAG,GAAG,uBAAuB,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC;IAC1E,OAAO,YAAY,sBAAsB,YAAY,UAAU,QAAQ,CAAC;AAC1E,CAAC","sourcesContent":["import {\n  locatorScriptBootstrap,\n  locatorScriptGlobalRefs,\n  type LocatorScriptName,\n} from \"../dom/build/locatorScripts.generated.js\";\n\n/**\n * Build an expression that injects the locator bundle (if needed) and invokes a\n * specific helper via its stable global reference. This keeps Runtime.evaluate\n * payloads tiny while guaranteeing our selector utilities are present in any\n * execution context.\n */\nexport function buildLocatorInvocation(\n  name: LocatorScriptName,\n  args: string[],\n): string {\n  const invocation = `${locatorScriptGlobalRefs[name]}(${args.join(\", \")})`;\n  return `(() => { ${locatorScriptBootstrap}; return ${invocation}; })()`;\n}\n"]}

package/dist/esm/lib/v3/understudy/navigationResponseTracker.d.ts

@@ -0,0 +1,84 @@
+/**
+ * NavigationResponseTracker
+ * -------------------------
+ *
+ * Tracks DevTools Protocol network events for a single navigation command so
+ * Stagehand can surface a Playwright-like response object from `Page.goto` and
+ * related APIs. The tracker listens for `Network.responseReceived` events that
+ * correspond to the targeted document navigation, handles loader-id churn that
+ * arises from redirects or preloading, and enriches the resulting
+ * `Response` with extra header information. It also observes
+ * `Network.loadingFinished` / `Network.loadingFailed` to fulfil the
+ * `response.finished()` contract exposed to consumers.
+ */
+import type { CDPSessionLike } from "./cdp.js";
+import type { Page } from "./page.js";
+import { Response } from "./response.js";
+/**
+ * Watches CDP events on a given session and resolves with the navigation's
+ * primary document response once identified.
+ */
+export declare class NavigationResponseTracker {
+    private readonly page;
+    private readonly session;
+    private readonly navigationCommandId;
+    private expectedLoaderId;
+    private selectedRequestId;
+    private selectedResponse;
+    private acceptNextWithoutLoader;
+    private responseResolved;
+    private resolveResponse;
+    private responsePromise;
+    private readonly pendingResponsesByLoader;
+    private readonly pendingExtraInfo;
+    private readonly listeners;
+    /**
+     * Create a tracker bound to a specific navigation command. The tracker begins
+     * listening for network events immediately so it should be constructed before
+     * the navigation request is dispatched.
+     */
+    constructor(params: {
+        page: Page;
+        session: CDPSessionLike;
+        navigationCommandId: number;
+    });
+    /** Stop listening for CDP events and release any pending bookkeeping. */
+    dispose(): void;
+    /**
+     * Hint the tracker with the loader id returned by `Page.navigate`. Chrome only
+     * emits this once the browser begins navigating, so we store early responses
+     * and match them once the loader id is known.
+     */
+    setExpectedLoaderId(loaderId: string | undefined): void;
+    /**
+     * Some navigation APIs (reload/history traversal) do not provide a loader id
+     * up front. This flag instructs the tracker to accept the next qualifying
+     * document response even if no loader id has been announced yet.
+     */
+    expectNavigationWithoutKnownLoader(): void;
+    /**
+     * Returns a promise that resolves with the matched response (or `null` when
+     * no document response was observed).
+     */
+    navigationCompleted(): Promise<Response | null>;
+    /** Expose the raw response promise (mainly for tests). */
+    response(): Promise<Response | null>;
+    /** Register all CDP listeners relevant to navigation tracking. */
+    private installListeners;
+    /** Attach a CDP listener and track it for later disposal. */
+    private addListener;
+    /** Handle the initial response payload for document navigations. */
+    private onResponseReceived;
+    /** Merge auxiliary header information once Chrome exposes it. */
+    private onResponseReceivedExtraInfo;
+    /** Resolve the response's finished promise when the request completes. */
+    private onLoadingFinished;
+    /** Resolve the response's finished promise with an error on failure. */
+    private onLoadingFailed;
+    /**
+     * Create the `Response` wrapper for the chosen document response and
+     * resolve awaiting consumers. Subsequent events flesh out the header/body
+     * helpers and mark the request as finished.
+     */
+    private selectResponse;
+}

package/dist/esm/lib/v3/understudy/navigationResponseTracker.js

@@ -0,0 +1,224 @@
+/**
+ * NavigationResponseTracker
+ * -------------------------
+ *
+ * Tracks DevTools Protocol network events for a single navigation command so
+ * Stagehand can surface a Playwright-like response object from `Page.goto` and
+ * related APIs. The tracker listens for `Network.responseReceived` events that
+ * correspond to the targeted document navigation, handles loader-id churn that
+ * arises from redirects or preloading, and enriches the resulting
+ * `Response` with extra header information. It also observes
+ * `Network.loadingFinished` / `Network.loadingFailed` to fulfil the
+ * `response.finished()` contract exposed to consumers.
+ */
+import { Response } from "./response.js";
+/**
+ * Watches CDP events on a given session and resolves with the navigation's
+ * primary document response once identified.
+ */
+export class NavigationResponseTracker {
+    page;
+    session;
+    navigationCommandId;
+    expectedLoaderId;
+    selectedRequestId = null;
+    selectedResponse = null;
+    acceptNextWithoutLoader = false;
+    responseResolved = false;
+    resolveResponse;
+    responsePromise;
+    pendingResponsesByLoader = new Map();
+    pendingExtraInfo = new Map();
+    listeners = [];
+    /**
+     * Create a tracker bound to a specific navigation command. The tracker begins
+     * listening for network events immediately so it should be constructed before
+     * the navigation request is dispatched.
+     */
+    constructor(params) {
+        this.page = params.page;
+        this.session = params.session;
+        this.navigationCommandId = params.navigationCommandId;
+        this.responsePromise = new Promise((resolve) => {
+            this.resolveResponse = (value) => {
+                if (this.responseResolved)
+                    return;
+                this.responseResolved = true;
+                resolve(value);
+            };
+        });
+        this.installListeners();
+    }
+    /** Stop listening for CDP events and release any pending bookkeeping. */
+    dispose() {
+        for (const { event, handler } of this.listeners) {
+            this.session.off(event, handler);
+        }
+        this.listeners.length = 0;
+        this.pendingResponsesByLoader.clear();
+        this.pendingExtraInfo.clear();
+    }
+    /**
+     * Hint the tracker with the loader id returned by `Page.navigate`. Chrome only
+     * emits this once the browser begins navigating, so we store early responses
+     * and match them once the loader id is known.
+     */
+    setExpectedLoaderId(loaderId) {
+        if (!loaderId)
+            return;
+        this.expectedLoaderId = loaderId;
+        const pending = this.pendingResponsesByLoader.get(loaderId);
+        if (pending) {
+            this.pendingResponsesByLoader.delete(loaderId);
+            this.selectResponse(pending);
+        }
+    }
+    /**
+     * Some navigation APIs (reload/history traversal) do not provide a loader id
+     * up front. This flag instructs the tracker to accept the next qualifying
+     * document response even if no loader id has been announced yet.
+     */
+    expectNavigationWithoutKnownLoader() {
+        this.acceptNextWithoutLoader = true;
+    }
+    /**
+     * Returns a promise that resolves with the matched response (or `null` when
+     * no document response was observed).
+     */
+    async navigationCompleted() {
+        if (!this.responseResolved) {
+            queueMicrotask(() => {
+                if (!this.responseResolved)
+                    this.resolveResponse(null);
+            });
+        }
+        return this.responsePromise;
+    }
+    /** Expose the raw response promise (mainly for tests). */
+    async response() {
+        return this.responsePromise;
+    }
+    /** Register all CDP listeners relevant to navigation tracking. */
+    installListeners() {
+        this.addListener("Network.responseReceived", (event) => {
+            this.onResponseReceived(event);
+        });
+        this.addListener("Network.responseReceivedExtraInfo", (event) => {
+            this.onResponseReceivedExtraInfo(event);
+        });
+        this.addListener("Network.loadingFinished", (event) => {
+            this.onLoadingFinished(event);
+        });
+        this.addListener("Network.loadingFailed", (event) => {
+            this.onLoadingFailed(event);
+        });
+    }
+    /** Attach a CDP listener and track it for later disposal. */
+    addListener(event, handler) {
+        this.session.on(event, handler);
+        this.listeners.push({ event, handler });
+    }
+    /** Handle the initial response payload for document navigations. */
+    onResponseReceived(event) {
+        if (!this.page.isCurrentNavigationCommand(this.navigationCommandId))
+            return;
+        if (!event || !event.response)
+            return;
+        if (event.type !== "Document")
+            return;
+        if (event.frameId !== this.page.mainFrameId())
+            return;
+        const loaderId = event.loaderId ?? "";
+        if (this.acceptNextWithoutLoader) {
+            this.acceptNextWithoutLoader = false;
+            this.selectResponse(event);
+            return;
+        }
+        if (this.expectedLoaderId) {
+            if (loaderId && loaderId !== this.expectedLoaderId) {
+                this.pendingResponsesByLoader.set(loaderId, event);
+                return;
+            }
+            this.selectResponse(event);
+            return;
+        }
+        if (loaderId) {
+            this.pendingResponsesByLoader.set(loaderId, event);
+            return;
+        }
+        this.selectResponse(event);
+    }
+    /** Merge auxiliary header information once Chrome exposes it. */
+    onResponseReceivedExtraInfo(event) {
+        if (!event || !event.requestId)
+            return;
+        if (this.selectedRequestId && event.requestId === this.selectedRequestId) {
+            this.selectedResponse?.applyExtraInfo(event);
+            return;
+        }
+        this.pendingExtraInfo.set(event.requestId, event);
+    }
+    /** Resolve the response's finished promise when the request completes. */
+    onLoadingFinished(event) {
+        if (!event || !event.requestId)
+            return;
+        if (event.requestId !== this.selectedRequestId)
+            return;
+        this.selectedResponse?.markFinished(null);
+    }
+    /** Resolve the response's finished promise with an error on failure. */
+    onLoadingFailed(event) {
+        // Ignore malformed events or ones without a request id
+        if (!event || !event.requestId)
+            return;
+        // Only the tracked document request should toggle the response state
+        if (event.requestId !== this.selectedRequestId)
+            return;
+        // Surface Chrome's failure text through response.finished()
+        const errorText = event.errorText || "Navigation request failed";
+        this.selectedResponse?.markFinished(new Error(errorText));
+    }
+    /**
+     * Create the `Response` wrapper for the chosen document response and
+     * resolve awaiting consumers. Subsequent events flesh out the header/body
+     * helpers and mark the request as finished.
+     */
+    selectResponse(event) {
+        if (event.loaderId) {
+            this.pendingResponsesByLoader.delete(event.loaderId);
+        }
+        if (this.responseResolved)
+            return;
+        if (this.selectedResponse)
+            return;
+        const protocol = event.response?.protocol?.toLowerCase() ?? "";
+        const url = event.response?.url ?? "";
+        const isDataUrl = protocol === "data" || url.startsWith("data:");
+        const isAboutUrl = protocol === "about" || url.startsWith("about:");
+        if (isDataUrl || isAboutUrl) {
+            this.pendingExtraInfo.delete(event.requestId);
+            this.selectedRequestId = null;
+            this.selectedResponse = null;
+            this.resolveResponse(null);
+            return;
+        }
+        const response = new Response({
+            page: this.page,
+            session: this.session,
+            requestId: event.requestId,
+            frameId: event.frameId,
+            loaderId: event.loaderId,
+            response: event.response,
+            fromServiceWorker: Boolean(event.response?.fromServiceWorker),
+        });
+        this.selectedRequestId = event.requestId;
+        this.selectedResponse = response;
+        const extraInfo = this.pendingExtraInfo.get(event.requestId);
+        if (extraInfo) {
+            response.applyExtraInfo(extraInfo);
+            this.pendingExtraInfo.delete(event.requestId);
+        }
+        this.resolveResponse(response);
+    }
+}
+//# sourceMappingURL=navigationResponseTracker.js.map

package/dist/esm/lib/v3/understudy/navigationResponseTracker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"navigationResponseTracker.js","sourceRoot":"","sources":["../../../../../lib/v3/understudy/navigationResponseTracker.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * NavigationResponseTracker\n * -------------------------\n *\n * Tracks DevTools Protocol network events for a single navigation command so\n * Stagehand can surface a Playwright-like response object from `Page.goto` and\n * related APIs. The tracker listens for `Network.responseReceived` events that\n * correspond to the targeted document navigation, handles loader-id churn that\n * arises from redirects or preloading, and enriches the resulting\n * `Response` with extra header information. It also observes\n * `Network.loadingFinished` / `Network.loadingFailed` to fulfil the\n * `response.finished()` contract exposed to consumers.\n */\n\nimport type { Protocol } from \"devtools-protocol\";\nimport type { CDPSessionLike } from \"./cdp.js\";\nimport type { Page } from \"./page.js\";\nimport { Response } from \"./response.js\";\n\n/**\n * Watches CDP events on a given session and resolves with the navigation's\n * primary document response once identified.\n */\nexport class NavigationResponseTracker {\n  private readonly page: Page;\n  private readonly session: CDPSessionLike;\n  private readonly navigationCommandId: number;\n\n  private expectedLoaderId: string | undefined;\n  private selectedRequestId: string | null = null;\n  private selectedResponse: Response | null = null;\n  private acceptNextWithoutLoader = false;\n\n  private responseResolved = false;\n  private resolveResponse!: (value: Response | null) => void;\n  private responsePromise: Promise<Response | null>;\n\n  private readonly pendingResponsesByLoader = new Map<\n    string,\n    Protocol.Network.ResponseReceivedEvent\n  >();\n  private readonly pendingExtraInfo = new Map<\n    string,\n    Protocol.Network.ResponseReceivedExtraInfoEvent\n  >();\n\n  private readonly listeners: Array<{\n    event: string;\n    handler: (event: unknown) => void;\n  }> = [];\n\n  /**\n   * Create a tracker bound to a specific navigation command. The tracker begins\n   * listening for network events immediately so it should be constructed before\n   * the navigation request is dispatched.\n   */\n  constructor(params: {\n    page: Page;\n    session: CDPSessionLike;\n    navigationCommandId: number;\n  }) {\n    this.page = params.page;\n    this.session = params.session;\n    this.navigationCommandId = params.navigationCommandId;\n\n    this.responsePromise = new Promise<Response | null>((resolve) => {\n      this.resolveResponse = (value) => {\n        if (this.responseResolved) return;\n        this.responseResolved = true;\n        resolve(value);\n      };\n    });\n\n    this.installListeners();\n  }\n\n  /** Stop listening for CDP events and release any pending bookkeeping. */\n  public dispose(): void {\n    for (const { event, handler } of this.listeners) {\n      this.session.off(event, handler as never);\n    }\n    this.listeners.length = 0;\n    this.pendingResponsesByLoader.clear();\n    this.pendingExtraInfo.clear();\n  }\n\n  /**\n   * Hint the tracker with the loader id returned by `Page.navigate`. Chrome only\n   * emits this once the browser begins navigating, so we store early responses\n   * and match them once the loader id is known.\n   */\n  public setExpectedLoaderId(loaderId: string | undefined): void {\n    if (!loaderId) return;\n    this.expectedLoaderId = loaderId;\n    const pending = this.pendingResponsesByLoader.get(loaderId);\n    if (pending) {\n      this.pendingResponsesByLoader.delete(loaderId);\n      this.selectResponse(pending);\n    }\n  }\n\n  /**\n   * Some navigation APIs (reload/history traversal) do not provide a loader id\n   * up front. This flag instructs the tracker to accept the next qualifying\n   * document response even if no loader id has been announced yet.\n   */\n  public expectNavigationWithoutKnownLoader(): void {\n    this.acceptNextWithoutLoader = true;\n  }\n\n  /**\n   * Returns a promise that resolves with the matched response (or `null` when\n   * no document response was observed).\n   */\n  public async navigationCompleted(): Promise<Response | null> {\n    if (!this.responseResolved) {\n      queueMicrotask(() => {\n        if (!this.responseResolved) this.resolveResponse(null);\n      });\n    }\n    return this.responsePromise;\n  }\n\n  /** Expose the raw response promise (mainly for tests). */\n  public async response(): Promise<Response | null> {\n    return this.responsePromise;\n  }\n\n  /** Register all CDP listeners relevant to navigation tracking. */\n  private installListeners(): void {\n    this.addListener(\"Network.responseReceived\", (event) => {\n      this.onResponseReceived(event as Protocol.Network.ResponseReceivedEvent);\n    });\n    this.addListener(\"Network.responseReceivedExtraInfo\", (event) => {\n      this.onResponseReceivedExtraInfo(\n        event as Protocol.Network.ResponseReceivedExtraInfoEvent,\n      );\n    });\n    this.addListener(\"Network.loadingFinished\", (event) => {\n      this.onLoadingFinished(event as Protocol.Network.LoadingFinishedEvent);\n    });\n    this.addListener(\"Network.loadingFailed\", (event) => {\n      this.onLoadingFailed(event as Protocol.Network.LoadingFailedEvent);\n    });\n  }\n\n  /** Attach a CDP listener and track it for later disposal. */\n  private addListener(event: string, handler: (event: unknown) => void): void {\n    this.session.on(event, handler as never);\n    this.listeners.push({ event, handler });\n  }\n\n  /** Handle the initial response payload for document navigations. */\n  private onResponseReceived(\n    event: Protocol.Network.ResponseReceivedEvent,\n  ): void {\n    if (!this.page.isCurrentNavigationCommand(this.navigationCommandId)) return;\n    if (!event || !event.response) return;\n    if (event.type !== \"Document\") return;\n    if (event.frameId !== this.page.mainFrameId()) return;\n\n    const loaderId = event.loaderId ?? \"\";\n    if (this.acceptNextWithoutLoader) {\n      this.acceptNextWithoutLoader = false;\n      this.selectResponse(event);\n      return;\n    }\n\n    if (this.expectedLoaderId) {\n      if (loaderId && loaderId !== this.expectedLoaderId) {\n        this.pendingResponsesByLoader.set(loaderId, event);\n        return;\n      }\n      this.selectResponse(event);\n      return;\n    }\n\n    if (loaderId) {\n      this.pendingResponsesByLoader.set(loaderId, event);\n      return;\n    }\n\n    this.selectResponse(event);\n  }\n\n  /** Merge auxiliary header information once Chrome exposes it. */\n  private onResponseReceivedExtraInfo(\n    event: Protocol.Network.ResponseReceivedExtraInfoEvent,\n  ): void {\n    if (!event || !event.requestId) return;\n    if (this.selectedRequestId && event.requestId === this.selectedRequestId) {\n      this.selectedResponse?.applyExtraInfo(event);\n      return;\n    }\n    this.pendingExtraInfo.set(event.requestId, event);\n  }\n\n  /** Resolve the response's finished promise when the request completes. */\n  private onLoadingFinished(\n    event: Protocol.Network.LoadingFinishedEvent,\n  ): void {\n    if (!event || !event.requestId) return;\n    if (event.requestId !== this.selectedRequestId) return;\n    this.selectedResponse?.markFinished(null);\n  }\n\n  /** Resolve the response's finished promise with an error on failure. */\n  private onLoadingFailed(event: Protocol.Network.LoadingFailedEvent): void {\n    // Ignore malformed events or ones without a request id\n    if (!event || !event.requestId) return;\n    // Only the tracked document request should toggle the response state\n    if (event.requestId !== this.selectedRequestId) return;\n    // Surface Chrome's failure text through response.finished()\n    const errorText = event.errorText || \"Navigation request failed\";\n    this.selectedResponse?.markFinished(new Error(errorText));\n  }\n\n  /**\n   * Create the `Response` wrapper for the chosen document response and\n   * resolve awaiting consumers. Subsequent events flesh out the header/body\n   * helpers and mark the request as finished.\n   */\n  private selectResponse(event: Protocol.Network.ResponseReceivedEvent): void {\n    if (event.loaderId) {\n      this.pendingResponsesByLoader.delete(event.loaderId);\n    }\n\n    if (this.responseResolved) return;\n    if (this.selectedResponse) return;\n\n    const protocol = event.response?.protocol?.toLowerCase() ?? \"\";\n    const url = event.response?.url ?? \"\";\n    const isDataUrl = protocol === \"data\" || url.startsWith(\"data:\");\n    const isAboutUrl = protocol === \"about\" || url.startsWith(\"about:\");\n\n    if (isDataUrl || isAboutUrl) {\n      this.pendingExtraInfo.delete(event.requestId);\n      this.selectedRequestId = null;\n      this.selectedResponse = null;\n      this.resolveResponse(null);\n      return;\n    }\n\n    const response = new Response({\n      page: this.page,\n      session: this.session,\n      requestId: event.requestId,\n      frameId: event.frameId,\n      loaderId: event.loaderId,\n      response: event.response,\n      fromServiceWorker: Boolean(event.response?.fromServiceWorker),\n    });\n\n    this.selectedRequestId = event.requestId;\n    this.selectedResponse = response;\n\n    const extraInfo = this.pendingExtraInfo.get(event.requestId);\n    if (extraInfo) {\n      response.applyExtraInfo(extraInfo);\n      this.pendingExtraInfo.delete(event.requestId);\n    }\n\n    this.resolveResponse(response);\n  }\n}\n"]}

package/dist/esm/lib/v3/understudy/networkManager.d.ts

@@ -0,0 +1,53 @@
+import type { CDPSessionLike } from "./cdp.js";
+import { NetworkObserver, WaitForIdleHandle, WaitForIdleOptions } from "../types/private/network.js";
+/**
+ * Cross-session network tracker.
+ *
+ * Centralises network bookkeeping for a Page: every CDP session (top-level and OOPIF)
+ * funnels `Network.*` events through here so higher-level waiters can reason about
+ * in-flight requests across the entire frame tree. The manager exposes a simple
+ * observer interface plus a "wait until idle" helper that resolves once no filtered
+ * requests remain for a quiet window.
+ */
+/**
+ * Aggregates network information for all CDP sessions owned by a Page.
+ */
+export declare class NetworkManager {
+    private readonly sessions;
+    private readonly observers;
+    private readonly requests;
+    private readonly documentRequestsByFrame;
+    /**
+     * Begin tracking network traffic for a CDP session (top-level or OOPIF).
+     * Safe to call multiple times; duplicate registrations are ignored.
+     */
+    trackSession(session: CDPSessionLike): void;
+    /**
+     * Stop tracking a session and discard any inflight bookkeeping owned by it.
+     */
+    untrackSession(rawSessionId: string | undefined): void;
+    /**
+     * Register a passive observer for request lifecycle notifications.
+     * Returns a disposer that removes the observer.
+     */
+    addObserver(observer: NetworkObserver): () => void;
+    /**
+     * Resolve once no (filtered) requests are in flight for the given quiet window.
+     * The waiter automatically unregisters itself on completion or timeout.
+     */
+    waitForIdle(options: WaitForIdleOptions): WaitForIdleHandle;
+    /**
+     * Tear down all session listeners and clear observers/bookkeeping.
+     */
+    dispose(): void;
+    /** Fan-out helper when a tracked request starts. */
+    private emitStart;
+    /** Fan-out helper when a tracked request completes successfully. */
+    private emitFinish;
+    /** Fan-out helper when a tracked request fails mid-flight. */
+    private emitFailure;
+    /** Compute a stable key for a session (falls back to synthetic root id). */
+    private sessionKey;
+    /** Compose the unique key for tracking a request under a session. */
+    private requestKey;
+}