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

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

@@ -0,0 +1,306 @@
+import { DEFAULT_IDLE_WAIT, IGNORED_RESOURCE_TYPES, } 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 class NetworkManager {
+    sessions = new Map();
+    observers = new Set();
+    requests = new Map();
+    documentRequestsByFrame = new Map();
+    /**
+     * Begin tracking network traffic for a CDP session (top-level or OOPIF).
+     * Safe to call multiple times; duplicate registrations are ignored.
+     */
+    trackSession(session) {
+        const sid = this.sessionKey(session);
+        if (this.sessions.has(sid))
+            return;
+        const onRequest = (evt) => {
+            if (!evt || !evt.requestId)
+                return;
+            const info = {
+                sessionId: sid,
+                requestId: evt.requestId,
+                requestKey: this.requestKey(sid, evt.requestId),
+                frameId: evt.frameId ?? undefined,
+                loaderId: evt.loaderId ?? undefined,
+                url: evt.request?.url,
+                timestamp: Date.now(),
+                resourceType: evt.type,
+                documentRequest: evt.type === "Document",
+            };
+            this.requests.set(info.requestKey, info);
+            if (info.documentRequest && info.frameId) {
+                this.documentRequestsByFrame.set(info.frameId, info.requestKey);
+            }
+            this.emitStart(info);
+        };
+        const finish = (reqId) => {
+            const key = this.requestKey(sid, reqId);
+            const stored = this.requests.get(key);
+            if (stored?.frameId) {
+                this.documentRequestsByFrame.delete(stored.frameId);
+            }
+            const info = stored ?? {
+                sessionId: sid,
+                requestId: reqId,
+                requestKey: key,
+                timestamp: Date.now(),
+                documentRequest: false,
+            };
+            this.requests.delete(key);
+            this.emitFinish(info);
+        };
+        const fail = (reqId) => {
+            const key = this.requestKey(sid, reqId);
+            const stored = this.requests.get(key);
+            if (stored?.frameId) {
+                this.documentRequestsByFrame.delete(stored.frameId);
+            }
+            const info = stored ?? {
+                sessionId: sid,
+                requestId: reqId,
+                requestKey: key,
+                timestamp: Date.now(),
+                documentRequest: false,
+            };
+            this.requests.delete(key);
+            this.emitFailure(info);
+        };
+        const onFinished = (evt) => {
+            if (!evt?.requestId)
+                return;
+            finish(evt.requestId);
+        };
+        const onFailed = (evt) => {
+            if (!evt?.requestId)
+                return;
+            fail(evt.requestId);
+        };
+        const onResponse = (evt) => {
+            if (!evt?.requestId)
+                return;
+            const url = evt.response?.url ?? "";
+            if (url.startsWith("data:"))
+                finish(evt.requestId);
+        };
+        const onFrameStopped = (evt) => {
+            if (!evt?.frameId)
+                return;
+            const key = this.documentRequestsByFrame.get(evt.frameId);
+            if (!key)
+                return;
+            const stored = this.requests.get(key);
+            if (!stored) {
+                this.documentRequestsByFrame.delete(evt.frameId);
+                return;
+            }
+            this.requests.delete(key);
+            this.documentRequestsByFrame.delete(evt.frameId);
+            this.emitFinish({ ...stored, timestamp: Date.now() });
+        };
+        session.on("Network.requestWillBeSent", onRequest);
+        session.on("Network.loadingFinished", onFinished);
+        session.on("Network.loadingFailed", onFailed);
+        session.on("Network.requestServedFromCache", onFinished);
+        session.on("Network.responseReceived", onResponse);
+        session.on("Page.frameStoppedLoading", onFrameStopped);
+        void session.send("Network.enable").catch(() => { });
+        void session.send("Page.enable").catch(() => { });
+        this.sessions.set(sid, {
+            session,
+            detach: () => {
+                session.off("Network.requestWillBeSent", onRequest);
+                session.off("Network.loadingFinished", onFinished);
+                session.off("Network.loadingFailed", onFailed);
+                session.off("Network.requestServedFromCache", onFinished);
+                session.off("Network.responseReceived", onResponse);
+                session.off("Page.frameStoppedLoading", onFrameStopped);
+            },
+        });
+    }
+    /**
+     * Stop tracking a session and discard any inflight bookkeeping owned by it.
+     */
+    untrackSession(rawSessionId) {
+        const sid = rawSessionId ?? "__main__";
+        const entry = this.sessions.get(sid);
+        if (!entry)
+            return;
+        entry.detach();
+        this.sessions.delete(sid);
+        for (const key of [...this.requests.keys()]) {
+            if (key.startsWith(`${sid}:`))
+                this.requests.delete(key);
+        }
+        for (const [frameId, key] of [...this.documentRequestsByFrame.entries()]) {
+            if (key.startsWith(`${sid}:`)) {
+                this.documentRequestsByFrame.delete(frameId);
+            }
+        }
+    }
+    /**
+     * Register a passive observer for request lifecycle notifications.
+     * Returns a disposer that removes the observer.
+     */
+    addObserver(observer) {
+        this.observers.add(observer);
+        return () => {
+            this.observers.delete(observer);
+        };
+    }
+    /**
+     * Resolve once no (filtered) requests are in flight for the given quiet window.
+     * The waiter automatically unregisters itself on completion or timeout.
+     */
+    waitForIdle(options) {
+        const startTime = options.startTime ?? Date.now();
+        const idleTimeMs = options.idleTimeMs ?? DEFAULT_IDLE_WAIT;
+        const timeoutMs = options.timeoutMs;
+        const remainingBudgetMs = Number.isFinite(timeoutMs)
+            ? timeoutMs
+            : undefined;
+        const originalBudgetMs = Number.isFinite(options.totalBudgetMs ?? NaN)
+            ? options.totalBudgetMs
+            : remainingBudgetMs;
+        const filter = options.filter ??
+            ((info) => {
+                return !IGNORED_RESOURCE_TYPES.has(info.resourceType);
+            });
+        const tracked = new Set();
+        let idleTimer = null;
+        let timeoutTimer = null;
+        let settled = false;
+        let resolveFn = null;
+        let rejectFn = null;
+        const cleanup = (error) => {
+            if (settled)
+                return;
+            settled = true;
+            if (idleTimer)
+                clearTimeout(idleTimer);
+            if (timeoutTimer)
+                clearTimeout(timeoutTimer);
+            removeObserver();
+            tracked.clear();
+            if (error) {
+                rejectFn?.(error);
+            }
+            else {
+                resolveFn?.();
+            }
+        };
+        const maybeIdle = () => {
+            if (settled)
+                return;
+            if (tracked.size === 0) {
+                if (!idleTimer) {
+                    idleTimer = setTimeout(() => {
+                        cleanup();
+                    }, idleTimeMs);
+                }
+            }
+            else if (idleTimer) {
+                clearTimeout(idleTimer);
+                idleTimer = null;
+            }
+        };
+        const observer = {
+            onRequestStarted: (info) => {
+                if (settled)
+                    return;
+                if (info.timestamp < startTime)
+                    return;
+                if (!filter(info))
+                    return;
+                tracked.add(info.requestKey);
+                if (idleTimer) {
+                    clearTimeout(idleTimer);
+                    idleTimer = null;
+                }
+            },
+            onRequestFinished: (info) => {
+                if (settled)
+                    return;
+                if (!tracked.delete(info.requestKey))
+                    return;
+                maybeIdle();
+            },
+            onRequestFailed: (info) => {
+                if (settled)
+                    return;
+                if (!tracked.delete(info.requestKey))
+                    return;
+                maybeIdle();
+            },
+        };
+        const removeObserver = this.addObserver(observer);
+        const promise = new Promise((resolve, reject) => {
+            resolveFn = resolve;
+            rejectFn = reject;
+        });
+        // Trigger initial idle check so that we still respect the quiet window
+        maybeIdle();
+        if (Number.isFinite(timeoutMs)) {
+            timeoutTimer = setTimeout(() => {
+                const elapsed = Date.now() - startTime;
+                const message = originalBudgetMs !== undefined
+                    ? `networkidle timed out after ${originalBudgetMs}ms`
+                    : `networkidle timed out after ${elapsed}ms`;
+                cleanup(new Error(message));
+            }, Math.max(0, timeoutMs));
+        }
+        return {
+            promise,
+            dispose: () => cleanup(new Error("waitForIdle disposed")),
+        };
+    }
+    /**
+     * Tear down all session listeners and clear observers/bookkeeping.
+     */
+    dispose() {
+        for (const { detach } of this.sessions.values()) {
+            detach();
+        }
+        this.sessions.clear();
+        this.observers.clear();
+        this.requests.clear();
+        this.documentRequestsByFrame.clear();
+    }
+    /** Fan-out helper when a tracked request starts. */
+    emitStart(info) {
+        for (const obs of this.observers) {
+            obs.onRequestStarted(info);
+        }
+    }
+    /** Fan-out helper when a tracked request completes successfully. */
+    emitFinish(info) {
+        for (const obs of this.observers) {
+            obs.onRequestFinished(info);
+        }
+    }
+    /** Fan-out helper when a tracked request fails mid-flight. */
+    emitFailure(info) {
+        for (const obs of this.observers) {
+            obs.onRequestFailed(info);
+        }
+    }
+    /** Compute a stable key for a session (falls back to synthetic root id). */
+    sessionKey(session) {
+        return session.id ?? "__main__";
+    }
+    /** Compose the unique key for tracking a request under a session. */
+    requestKey(sessionId, requestId) {
+        return `${sessionId}:${requestId}`;
+    }
+}
+//# sourceMappingURL=networkManager.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"networkManager.js","sourceRoot":"","sources":["../../../../../lib/v3/understudy/networkManager.ts"],"names":[],"mappings":"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","sourcesContent":["import type { Protocol } from \"devtools-protocol\";\nimport type { CDPSessionLike } from \"./cdp.js\";\nimport {\n  DEFAULT_IDLE_WAIT,\n  IGNORED_RESOURCE_TYPES,\n  NetworkObserver,\n  NetworkRequestInfo,\n  WaitForIdleHandle,\n  WaitForIdleOptions,\n} from \"../types/private/network.js\";\n\n/**\n * Cross-session network tracker.\n *\n * Centralises network bookkeeping for a Page: every CDP session (top-level and OOPIF)\n * funnels `Network.*` events through here so higher-level waiters can reason about\n * in-flight requests across the entire frame tree. The manager exposes a simple\n * observer interface plus a \"wait until idle\" helper that resolves once no filtered\n * requests remain for a quiet window.\n */\n\n/**\n * Aggregates network information for all CDP sessions owned by a Page.\n */\nexport class NetworkManager {\n  private readonly sessions = new Map<\n    string,\n    {\n      session: CDPSessionLike;\n      detach: () => void;\n    }\n  >();\n\n  private readonly observers = new Set<NetworkObserver>();\n\n  private readonly requests = new Map<string, NetworkRequestInfo>();\n\n  private readonly documentRequestsByFrame = new Map<string, string>();\n\n  /**\n   * Begin tracking network traffic for a CDP session (top-level or OOPIF).\n   * Safe to call multiple times; duplicate registrations are ignored.\n   */\n  public trackSession(session: CDPSessionLike): void {\n    const sid = this.sessionKey(session);\n    if (this.sessions.has(sid)) return;\n\n    const onRequest = (evt: Protocol.Network.RequestWillBeSentEvent) => {\n      if (!evt || !evt.requestId) return;\n\n      const info: NetworkRequestInfo = {\n        sessionId: sid,\n        requestId: evt.requestId,\n        requestKey: this.requestKey(sid, evt.requestId),\n        frameId: evt.frameId ?? undefined,\n        loaderId: evt.loaderId ?? undefined,\n        url: evt.request?.url,\n        timestamp: Date.now(),\n        resourceType: evt.type,\n        documentRequest: evt.type === \"Document\",\n      };\n\n      this.requests.set(info.requestKey, info);\n      if (info.documentRequest && info.frameId) {\n        this.documentRequestsByFrame.set(info.frameId, info.requestKey);\n      }\n\n      this.emitStart(info);\n    };\n\n    const finish = (reqId: string) => {\n      const key = this.requestKey(sid, reqId);\n      const stored = this.requests.get(key);\n      if (stored?.frameId) {\n        this.documentRequestsByFrame.delete(stored.frameId);\n      }\n      const info: NetworkRequestInfo = stored ?? {\n        sessionId: sid,\n        requestId: reqId,\n        requestKey: key,\n        timestamp: Date.now(),\n        documentRequest: false,\n      };\n      this.requests.delete(key);\n      this.emitFinish(info);\n    };\n\n    const fail = (reqId: string) => {\n      const key = this.requestKey(sid, reqId);\n      const stored = this.requests.get(key);\n      if (stored?.frameId) {\n        this.documentRequestsByFrame.delete(stored.frameId);\n      }\n      const info: NetworkRequestInfo = stored ?? {\n        sessionId: sid,\n        requestId: reqId,\n        requestKey: key,\n        timestamp: Date.now(),\n        documentRequest: false,\n      };\n      this.requests.delete(key);\n      this.emitFailure(info);\n    };\n\n    const onFinished = (evt: { requestId: string }) => {\n      if (!evt?.requestId) return;\n      finish(evt.requestId);\n    };\n\n    const onFailed = (evt: Protocol.Network.LoadingFailedEvent) => {\n      if (!evt?.requestId) return;\n      fail(evt.requestId);\n    };\n\n    const onResponse = (evt: Protocol.Network.ResponseReceivedEvent) => {\n      if (!evt?.requestId) return;\n      const url = evt.response?.url ?? \"\";\n      if (url.startsWith(\"data:\")) finish(evt.requestId);\n    };\n\n    const onFrameStopped = (evt: Protocol.Page.FrameStoppedLoadingEvent) => {\n      if (!evt?.frameId) return;\n      const key = this.documentRequestsByFrame.get(evt.frameId);\n      if (!key) return;\n      const stored = this.requests.get(key);\n      if (!stored) {\n        this.documentRequestsByFrame.delete(evt.frameId);\n        return;\n      }\n      this.requests.delete(key);\n      this.documentRequestsByFrame.delete(evt.frameId);\n      this.emitFinish({ ...stored, timestamp: Date.now() });\n    };\n\n    session.on(\"Network.requestWillBeSent\", onRequest);\n    session.on(\"Network.loadingFinished\", onFinished);\n    session.on(\"Network.loadingFailed\", onFailed);\n    session.on(\"Network.requestServedFromCache\", onFinished);\n    session.on(\"Network.responseReceived\", onResponse);\n    session.on(\"Page.frameStoppedLoading\", onFrameStopped);\n\n    void session.send(\"Network.enable\").catch(() => {});\n    void session.send(\"Page.enable\").catch(() => {});\n\n    this.sessions.set(sid, {\n      session,\n      detach: () => {\n        session.off(\"Network.requestWillBeSent\", onRequest);\n        session.off(\"Network.loadingFinished\", onFinished);\n        session.off(\"Network.loadingFailed\", onFailed);\n        session.off(\"Network.requestServedFromCache\", onFinished);\n        session.off(\"Network.responseReceived\", onResponse);\n        session.off(\"Page.frameStoppedLoading\", onFrameStopped);\n      },\n    });\n  }\n\n  /**\n   * Stop tracking a session and discard any inflight bookkeeping owned by it.\n   */\n  public untrackSession(rawSessionId: string | undefined): void {\n    const sid = rawSessionId ?? \"__main__\";\n    const entry = this.sessions.get(sid);\n    if (!entry) return;\n    entry.detach();\n    this.sessions.delete(sid);\n\n    for (const key of [...this.requests.keys()]) {\n      if (key.startsWith(`${sid}:`)) this.requests.delete(key);\n    }\n\n    for (const [frameId, key] of [...this.documentRequestsByFrame.entries()]) {\n      if (key.startsWith(`${sid}:`)) {\n        this.documentRequestsByFrame.delete(frameId);\n      }\n    }\n  }\n\n  /**\n   * Register a passive observer for request lifecycle notifications.\n   * Returns a disposer that removes the observer.\n   */\n  public addObserver(observer: NetworkObserver): () => void {\n    this.observers.add(observer);\n    return () => {\n      this.observers.delete(observer);\n    };\n  }\n\n  /**\n   * Resolve once no (filtered) requests are in flight for the given quiet window.\n   * The waiter automatically unregisters itself on completion or timeout.\n   */\n  public waitForIdle(options: WaitForIdleOptions): WaitForIdleHandle {\n    const startTime = options.startTime ?? Date.now();\n    const idleTimeMs = options.idleTimeMs ?? DEFAULT_IDLE_WAIT;\n    const timeoutMs = options.timeoutMs;\n    const remainingBudgetMs = Number.isFinite(timeoutMs)\n      ? timeoutMs\n      : undefined;\n    const originalBudgetMs = Number.isFinite(options.totalBudgetMs ?? NaN)\n      ? (options.totalBudgetMs as number)\n      : remainingBudgetMs;\n\n    const filter =\n      options.filter ??\n      ((info: NetworkRequestInfo) => {\n        return !IGNORED_RESOURCE_TYPES.has(info.resourceType);\n      });\n\n    const tracked = new Set<string>();\n    let idleTimer: ReturnType<typeof setTimeout> | null = null;\n    let timeoutTimer: ReturnType<typeof setTimeout> | null = null;\n    let settled = false;\n\n    let resolveFn: (() => void) | null = null;\n    let rejectFn: ((error: Error) => void) | null = null;\n\n    const cleanup = (error?: Error) => {\n      if (settled) return;\n      settled = true;\n      if (idleTimer) clearTimeout(idleTimer);\n      if (timeoutTimer) clearTimeout(timeoutTimer);\n      removeObserver();\n      tracked.clear();\n      if (error) {\n        rejectFn?.(error);\n      } else {\n        resolveFn?.();\n      }\n    };\n\n    const maybeIdle = () => {\n      if (settled) return;\n      if (tracked.size === 0) {\n        if (!idleTimer) {\n          idleTimer = setTimeout(() => {\n            cleanup();\n          }, idleTimeMs);\n        }\n      } else if (idleTimer) {\n        clearTimeout(idleTimer);\n        idleTimer = null;\n      }\n    };\n\n    const observer: NetworkObserver = {\n      onRequestStarted: (info) => {\n        if (settled) return;\n        if (info.timestamp < startTime) return;\n        if (!filter(info)) return;\n        tracked.add(info.requestKey);\n        if (idleTimer) {\n          clearTimeout(idleTimer);\n          idleTimer = null;\n        }\n      },\n      onRequestFinished: (info) => {\n        if (settled) return;\n        if (!tracked.delete(info.requestKey)) return;\n        maybeIdle();\n      },\n      onRequestFailed: (info) => {\n        if (settled) return;\n        if (!tracked.delete(info.requestKey)) return;\n        maybeIdle();\n      },\n    };\n\n    const removeObserver = this.addObserver(observer);\n\n    const promise = new Promise<void>((resolve, reject) => {\n      resolveFn = resolve;\n      rejectFn = reject;\n    });\n\n    // Trigger initial idle check so that we still respect the quiet window\n    maybeIdle();\n\n    if (Number.isFinite(timeoutMs)) {\n      timeoutTimer = setTimeout(\n        () => {\n          const elapsed = Date.now() - startTime;\n          const message =\n            originalBudgetMs !== undefined\n              ? `networkidle timed out after ${originalBudgetMs}ms`\n              : `networkidle timed out after ${elapsed}ms`;\n          cleanup(new Error(message));\n        },\n        Math.max(0, timeoutMs),\n      );\n    }\n\n    return {\n      promise,\n      dispose: () => cleanup(new Error(\"waitForIdle disposed\")),\n    };\n  }\n\n  /**\n   * Tear down all session listeners and clear observers/bookkeeping.\n   */\n  public dispose(): void {\n    for (const { detach } of this.sessions.values()) {\n      detach();\n    }\n    this.sessions.clear();\n    this.observers.clear();\n    this.requests.clear();\n    this.documentRequestsByFrame.clear();\n  }\n\n  /** Fan-out helper when a tracked request starts. */\n  private emitStart(info: NetworkRequestInfo): void {\n    for (const obs of this.observers) {\n      obs.onRequestStarted(info);\n    }\n  }\n\n  /** Fan-out helper when a tracked request completes successfully. */\n  private emitFinish(info: NetworkRequestInfo): void {\n    for (const obs of this.observers) {\n      obs.onRequestFinished(info);\n    }\n  }\n\n  /** Fan-out helper when a tracked request fails mid-flight. */\n  private emitFailure(info: NetworkRequestInfo): void {\n    for (const obs of this.observers) {\n      obs.onRequestFailed(info);\n    }\n  }\n\n  /** Compute a stable key for a session (falls back to synthetic root id). */\n  private sessionKey(session: CDPSessionLike): string {\n    return session.id ?? \"__main__\";\n  }\n\n  /** Compose the unique key for tracking a request under a session. */\n  private requestKey(sessionId: string, requestId: string): string {\n    return `${sessionId}:${requestId}`;\n  }\n}\n"]}