@opensteer/browser-core 0.7.0 → 0.7.2

package/dist/index.d.cts

@@ -1132,4 +1132,48 @@ interface VisualStabilityOptions {
 }
 declare function waitForCdpVisualStability(cdp: CdpSessionLike, options?: VisualStabilityOptions): Promise<void>;
 
-export { type BodyPayload, type BodyPayloadEncoding, type Brand, type BrowserCapabilities, type BrowserCapabilityPath, type BrowserCoreEngine, BrowserCoreError, type BrowserCoreErrorCode, type BrowserCoreErrorOptions, type BrowserExecutor, type BrowserInitScriptInput, type BrowserInitScriptRegistration, type BrowserInspector, type BrowserInstrumentation, type BrowserRouteFetchResult, type BrowserRouteHandlerResult, type BrowserRouteRegistration, type BrowserRouteRegistrationInput, type BrowserRouteRequest, type CapturedCdpDomSnapshot, type CdpDomSnapshotDocument, type CdpDomTreeNode, type CdpRareIntegerData, type CdpRareStringData, type CdpShadowBoundaryInfo, type ChooserOpenedStepEvent, type ChooserRef, type ConsoleLevel, type ConsoleStepEvent, type CookiePriority, type CookieRecord, type CookieSameSite, type CoordinateSpace, DEFAULT_VISUAL_STABILITY_SETTLE_MS, DEFAULT_VISUAL_STABILITY_TIMEOUT_MS, DOM_SNAPSHOT_COMPUTED_STYLE_NAMES, type DevicePixelRatio, type DialogOpenedStepEvent, type DialogRef, type DocumentEpoch, type DocumentRef, type DomSnapshot, type DomSnapshotNode, type DownloadFinishedStepEvent, type DownloadRef, type DownloadStartedStepEvent, type EventStreamMessageStepEvent, FakeBrowserCoreEngine, type FakeBrowserCoreEngineOptions, type FakeBrowserCorePageSeed, type FrameInfo, type FrameRef, type FrozenStepEvent, type GetNetworkRecordsInput, type HeaderEntry, type HitTestResult, type HtmlSnapshot, type IndexedDbDatabaseSnapshot, type IndexedDbIndexSnapshot, type IndexedDbObjectStoreSnapshot, type IndexedDbRecord, type KeyModifier, type LayoutViewport, type MouseButton, type NetworkCaptureState, type NetworkInitiator, type NetworkInitiatorType, type NetworkRecord, type NetworkRecordFilterInput, type NetworkRecordKind, type NetworkRequestId, type NetworkResourceType, type NetworkSourceMetadata, type NetworkTiming, type NetworkTransferSizes, type NodeLocator, type NodeRef, type PageClosedStepEvent, type PageCreatedStepEvent, type PageErrorStepEvent, type PageInfo, type PageLifecycleState, type PageRef, type PageScaleFactor, type PageZoomFactor, type PartialBrowserCapabilities, type PausedStepEvent, type Point, type PopupOpenedStepEvent, type Quad, type Rect, type ResumedStepEvent, type ScreenshotArtifact, type ScreenshotFormat, type ScrollOffset, type SessionRef, type SessionStorageSnapshot, type SessionTransportExecutor, type SessionTransportRequest, type SessionTransportResponse, type ShadowDomSnapshotMode, type Size, type StepEvent, type StepResult, type StorageEntry, type StorageOriginSnapshot, type StorageSnapshot, type ViewportMetrics, type VisualStabilityScope, type VisualViewport, type WebSocketClosedStepEvent, type WebSocketFrameStepEvent, type WebSocketOpenedStepEvent, type WorkerCreatedStepEvent, type WorkerDestroyedStepEvent, type WorkerRef, allBrowserCapabilities, bodyPayloadFromUtf8, brand, buildCdpShadowBoundaryIndex, buildDomSnapshotFromCdpCapture, closedPageError, closedSessionError, createBodyPayload, createBrowserCoreError, createChooserRef, createDevicePixelRatio, createDialogRef, createDocumentEpoch, createDocumentRef, createDownloadRef, createFakeBrowserCoreEngine, createFrameRef, createHeaderEntry, createNetworkRequestId, createNodeLocator, createNodeRef, createPageRef, createPageScaleFactor, createPageZoomFactor, createPoint, createQuad, createRect, createScrollOffset, createSessionRef, createSize, createWorkerRef, filterCookieRecords, findDomSnapshotNode, findDomSnapshotNodeByRef, hasCapability, isBrowserCoreError, isChooserRef, isDialogRef, isDocumentRef, isDownloadRef, isFrameRef, isNetworkRequestId, isNodeRef, isPageRef, isSessionRef, isWorkerRef, matchesNetworkRecordFilters, mergeBrowserCapabilities, nextDocumentEpoch, noBrowserCapabilities, normalizeCdpShadowRootType, parseCdpStringTable, quadBounds, rareCdpIntegerValue, rareCdpStringValue, rectContainsPoint, rectToQuad, serializeDocumentEpoch, serializeRef, staleNodeRefError, unsupportedCapabilityError, waitForCdpVisualStability };
+declare const DEFAULT_POST_LOAD_TRACKER_QUIET_WINDOW_MS = 400;
+declare const DEFAULT_ACTION_BOUNDARY_POLL_INTERVAL_MS = 100;
+interface PostLoadTrackerState {
+    readonly installedAt: number;
+    readonly lastMutationAt: number;
+    readonly lastNetworkActivityAt: number;
+    readonly now: number;
+    readonly pendingFetches: number;
+    readonly pendingTimeouts: number;
+    readonly pendingXhrs: number;
+    readonly readyState: string;
+}
+declare function normalizePostLoadTrackerState(value: unknown): PostLoadTrackerState | undefined;
+declare function buildPostLoadTrackerInstallScript(): string;
+declare function buildPostLoadTrackerReadExpression(): string;
+declare function postLoadTrackerIsSettled(tracker: PostLoadTrackerState | undefined, quietWindowMs?: number): boolean;
+
+declare const CROSS_DOCUMENT_INTERACTION_TIMEOUT_MS = 30000;
+declare const CROSS_DOCUMENT_DETECTION_WINDOW_MS = 500;
+interface ActionBoundarySnapshot {
+    readonly pageRef: PageRef;
+    readonly documentRef: DocumentRef;
+}
+type ActionBoundarySettleTrigger = "dom-action" | "navigation";
+type ActionBoundaryTimedOutPhase = "bootstrap";
+interface ActionBoundaryOutcome {
+    readonly trigger: ActionBoundarySettleTrigger;
+    readonly crossDocument: boolean;
+    readonly bootstrapSettled: boolean;
+    readonly timedOutPhase?: ActionBoundaryTimedOutPhase;
+}
+interface WaitForActionBoundaryInput {
+    readonly timeoutMs: number;
+    readonly signal?: AbortSignal;
+    readonly snapshot?: ActionBoundarySnapshot;
+    readonly pollIntervalMs?: number;
+    getCurrentMainFrameDocumentRef(): DocumentRef | undefined;
+    waitForNavigationContentLoaded(timeoutMs: number): Promise<void>;
+    readTrackerState(): Promise<PostLoadTrackerState | undefined>;
+    throwBackgroundError(): void;
+    isPageClosed(): boolean;
+}
+declare function waitForActionBoundary(input: WaitForActionBoundaryInput): Promise<ActionBoundaryOutcome>;
+
+export { type ActionBoundaryOutcome, type ActionBoundarySettleTrigger, type ActionBoundarySnapshot, type ActionBoundaryTimedOutPhase, type BodyPayload, type BodyPayloadEncoding, type Brand, type BrowserCapabilities, type BrowserCapabilityPath, type BrowserCoreEngine, BrowserCoreError, type BrowserCoreErrorCode, type BrowserCoreErrorOptions, type BrowserExecutor, type BrowserInitScriptInput, type BrowserInitScriptRegistration, type BrowserInspector, type BrowserInstrumentation, type BrowserRouteFetchResult, type BrowserRouteHandlerResult, type BrowserRouteRegistration, type BrowserRouteRegistrationInput, type BrowserRouteRequest, CROSS_DOCUMENT_DETECTION_WINDOW_MS, CROSS_DOCUMENT_INTERACTION_TIMEOUT_MS, type CapturedCdpDomSnapshot, type CdpDomSnapshotDocument, type CdpDomTreeNode, type CdpRareIntegerData, type CdpRareStringData, type CdpShadowBoundaryInfo, type ChooserOpenedStepEvent, type ChooserRef, type ConsoleLevel, type ConsoleStepEvent, type CookiePriority, type CookieRecord, type CookieSameSite, type CoordinateSpace, DEFAULT_ACTION_BOUNDARY_POLL_INTERVAL_MS, DEFAULT_POST_LOAD_TRACKER_QUIET_WINDOW_MS, DEFAULT_VISUAL_STABILITY_SETTLE_MS, DEFAULT_VISUAL_STABILITY_TIMEOUT_MS, DOM_SNAPSHOT_COMPUTED_STYLE_NAMES, type DevicePixelRatio, type DialogOpenedStepEvent, type DialogRef, type DocumentEpoch, type DocumentRef, type DomSnapshot, type DomSnapshotNode, type DownloadFinishedStepEvent, type DownloadRef, type DownloadStartedStepEvent, type EventStreamMessageStepEvent, FakeBrowserCoreEngine, type FakeBrowserCoreEngineOptions, type FakeBrowserCorePageSeed, type FrameInfo, type FrameRef, type FrozenStepEvent, type GetNetworkRecordsInput, type HeaderEntry, type HitTestResult, type HtmlSnapshot, type IndexedDbDatabaseSnapshot, type IndexedDbIndexSnapshot, type IndexedDbObjectStoreSnapshot, type IndexedDbRecord, type KeyModifier, type LayoutViewport, type MouseButton, type NetworkCaptureState, type NetworkInitiator, type NetworkInitiatorType, type NetworkRecord, type NetworkRecordFilterInput, type NetworkRecordKind, type NetworkRequestId, type NetworkResourceType, type NetworkSourceMetadata, type NetworkTiming, type NetworkTransferSizes, type NodeLocator, type NodeRef, type PageClosedStepEvent, type PageCreatedStepEvent, type PageErrorStepEvent, type PageInfo, type PageLifecycleState, type PageRef, type PageScaleFactor, type PageZoomFactor, type PartialBrowserCapabilities, type PausedStepEvent, type Point, type PopupOpenedStepEvent, type PostLoadTrackerState, type Quad, type Rect, type ResumedStepEvent, type ScreenshotArtifact, type ScreenshotFormat, type ScrollOffset, type SessionRef, type SessionStorageSnapshot, type SessionTransportExecutor, type SessionTransportRequest, type SessionTransportResponse, type ShadowDomSnapshotMode, type Size, type StepEvent, type StepResult, type StorageEntry, type StorageOriginSnapshot, type StorageSnapshot, type ViewportMetrics, type VisualStabilityScope, type VisualViewport, type WaitForActionBoundaryInput, type WebSocketClosedStepEvent, type WebSocketFrameStepEvent, type WebSocketOpenedStepEvent, type WorkerCreatedStepEvent, type WorkerDestroyedStepEvent, type WorkerRef, allBrowserCapabilities, bodyPayloadFromUtf8, brand, buildCdpShadowBoundaryIndex, buildDomSnapshotFromCdpCapture, buildPostLoadTrackerInstallScript, buildPostLoadTrackerReadExpression, closedPageError, closedSessionError, createBodyPayload, createBrowserCoreError, createChooserRef, createDevicePixelRatio, createDialogRef, createDocumentEpoch, createDocumentRef, createDownloadRef, createFakeBrowserCoreEngine, createFrameRef, createHeaderEntry, createNetworkRequestId, createNodeLocator, createNodeRef, createPageRef, createPageScaleFactor, createPageZoomFactor, createPoint, createQuad, createRect, createScrollOffset, createSessionRef, createSize, createWorkerRef, filterCookieRecords, findDomSnapshotNode, findDomSnapshotNodeByRef, hasCapability, isBrowserCoreError, isChooserRef, isDialogRef, isDocumentRef, isDownloadRef, isFrameRef, isNetworkRequestId, isNodeRef, isPageRef, isSessionRef, isWorkerRef, matchesNetworkRecordFilters, mergeBrowserCapabilities, nextDocumentEpoch, noBrowserCapabilities, normalizeCdpShadowRootType, normalizePostLoadTrackerState, parseCdpStringTable, postLoadTrackerIsSettled, quadBounds, rareCdpIntegerValue, rareCdpStringValue, rectContainsPoint, rectToQuad, serializeDocumentEpoch, serializeRef, staleNodeRefError, unsupportedCapabilityError, waitForActionBoundary, waitForCdpVisualStability };

package/dist/index.d.ts

@@ -1132,4 +1132,48 @@ interface VisualStabilityOptions {
 }
 declare function waitForCdpVisualStability(cdp: CdpSessionLike, options?: VisualStabilityOptions): Promise<void>;
 
-export { type BodyPayload, type BodyPayloadEncoding, type Brand, type BrowserCapabilities, type BrowserCapabilityPath, type BrowserCoreEngine, BrowserCoreError, type BrowserCoreErrorCode, type BrowserCoreErrorOptions, type BrowserExecutor, type BrowserInitScriptInput, type BrowserInitScriptRegistration, type BrowserInspector, type BrowserInstrumentation, type BrowserRouteFetchResult, type BrowserRouteHandlerResult, type BrowserRouteRegistration, type BrowserRouteRegistrationInput, type BrowserRouteRequest, type CapturedCdpDomSnapshot, type CdpDomSnapshotDocument, type CdpDomTreeNode, type CdpRareIntegerData, type CdpRareStringData, type CdpShadowBoundaryInfo, type ChooserOpenedStepEvent, type ChooserRef, type ConsoleLevel, type ConsoleStepEvent, type CookiePriority, type CookieRecord, type CookieSameSite, type CoordinateSpace, DEFAULT_VISUAL_STABILITY_SETTLE_MS, DEFAULT_VISUAL_STABILITY_TIMEOUT_MS, DOM_SNAPSHOT_COMPUTED_STYLE_NAMES, type DevicePixelRatio, type DialogOpenedStepEvent, type DialogRef, type DocumentEpoch, type DocumentRef, type DomSnapshot, type DomSnapshotNode, type DownloadFinishedStepEvent, type DownloadRef, type DownloadStartedStepEvent, type EventStreamMessageStepEvent, FakeBrowserCoreEngine, type FakeBrowserCoreEngineOptions, type FakeBrowserCorePageSeed, type FrameInfo, type FrameRef, type FrozenStepEvent, type GetNetworkRecordsInput, type HeaderEntry, type HitTestResult, type HtmlSnapshot, type IndexedDbDatabaseSnapshot, type IndexedDbIndexSnapshot, type IndexedDbObjectStoreSnapshot, type IndexedDbRecord, type KeyModifier, type LayoutViewport, type MouseButton, type NetworkCaptureState, type NetworkInitiator, type NetworkInitiatorType, type NetworkRecord, type NetworkRecordFilterInput, type NetworkRecordKind, type NetworkRequestId, type NetworkResourceType, type NetworkSourceMetadata, type NetworkTiming, type NetworkTransferSizes, type NodeLocator, type NodeRef, type PageClosedStepEvent, type PageCreatedStepEvent, type PageErrorStepEvent, type PageInfo, type PageLifecycleState, type PageRef, type PageScaleFactor, type PageZoomFactor, type PartialBrowserCapabilities, type PausedStepEvent, type Point, type PopupOpenedStepEvent, type Quad, type Rect, type ResumedStepEvent, type ScreenshotArtifact, type ScreenshotFormat, type ScrollOffset, type SessionRef, type SessionStorageSnapshot, type SessionTransportExecutor, type SessionTransportRequest, type SessionTransportResponse, type ShadowDomSnapshotMode, type Size, type StepEvent, type StepResult, type StorageEntry, type StorageOriginSnapshot, type StorageSnapshot, type ViewportMetrics, type VisualStabilityScope, type VisualViewport, type WebSocketClosedStepEvent, type WebSocketFrameStepEvent, type WebSocketOpenedStepEvent, type WorkerCreatedStepEvent, type WorkerDestroyedStepEvent, type WorkerRef, allBrowserCapabilities, bodyPayloadFromUtf8, brand, buildCdpShadowBoundaryIndex, buildDomSnapshotFromCdpCapture, closedPageError, closedSessionError, createBodyPayload, createBrowserCoreError, createChooserRef, createDevicePixelRatio, createDialogRef, createDocumentEpoch, createDocumentRef, createDownloadRef, createFakeBrowserCoreEngine, createFrameRef, createHeaderEntry, createNetworkRequestId, createNodeLocator, createNodeRef, createPageRef, createPageScaleFactor, createPageZoomFactor, createPoint, createQuad, createRect, createScrollOffset, createSessionRef, createSize, createWorkerRef, filterCookieRecords, findDomSnapshotNode, findDomSnapshotNodeByRef, hasCapability, isBrowserCoreError, isChooserRef, isDialogRef, isDocumentRef, isDownloadRef, isFrameRef, isNetworkRequestId, isNodeRef, isPageRef, isSessionRef, isWorkerRef, matchesNetworkRecordFilters, mergeBrowserCapabilities, nextDocumentEpoch, noBrowserCapabilities, normalizeCdpShadowRootType, parseCdpStringTable, quadBounds, rareCdpIntegerValue, rareCdpStringValue, rectContainsPoint, rectToQuad, serializeDocumentEpoch, serializeRef, staleNodeRefError, unsupportedCapabilityError, waitForCdpVisualStability };
+declare const DEFAULT_POST_LOAD_TRACKER_QUIET_WINDOW_MS = 400;
+declare const DEFAULT_ACTION_BOUNDARY_POLL_INTERVAL_MS = 100;
+interface PostLoadTrackerState {
+    readonly installedAt: number;
+    readonly lastMutationAt: number;
+    readonly lastNetworkActivityAt: number;
+    readonly now: number;
+    readonly pendingFetches: number;
+    readonly pendingTimeouts: number;
+    readonly pendingXhrs: number;
+    readonly readyState: string;
+}
+declare function normalizePostLoadTrackerState(value: unknown): PostLoadTrackerState | undefined;
+declare function buildPostLoadTrackerInstallScript(): string;
+declare function buildPostLoadTrackerReadExpression(): string;
+declare function postLoadTrackerIsSettled(tracker: PostLoadTrackerState | undefined, quietWindowMs?: number): boolean;
+
+declare const CROSS_DOCUMENT_INTERACTION_TIMEOUT_MS = 30000;
+declare const CROSS_DOCUMENT_DETECTION_WINDOW_MS = 500;
+interface ActionBoundarySnapshot {
+    readonly pageRef: PageRef;
+    readonly documentRef: DocumentRef;
+}
+type ActionBoundarySettleTrigger = "dom-action" | "navigation";
+type ActionBoundaryTimedOutPhase = "bootstrap";
+interface ActionBoundaryOutcome {
+    readonly trigger: ActionBoundarySettleTrigger;
+    readonly crossDocument: boolean;
+    readonly bootstrapSettled: boolean;
+    readonly timedOutPhase?: ActionBoundaryTimedOutPhase;
+}
+interface WaitForActionBoundaryInput {
+    readonly timeoutMs: number;
+    readonly signal?: AbortSignal;
+    readonly snapshot?: ActionBoundarySnapshot;
+    readonly pollIntervalMs?: number;
+    getCurrentMainFrameDocumentRef(): DocumentRef | undefined;
+    waitForNavigationContentLoaded(timeoutMs: number): Promise<void>;
+    readTrackerState(): Promise<PostLoadTrackerState | undefined>;
+    throwBackgroundError(): void;
+    isPageClosed(): boolean;
+}
+declare function waitForActionBoundary(input: WaitForActionBoundaryInput): Promise<ActionBoundaryOutcome>;
+
+export { type ActionBoundaryOutcome, type ActionBoundarySettleTrigger, type ActionBoundarySnapshot, type ActionBoundaryTimedOutPhase, type BodyPayload, type BodyPayloadEncoding, type Brand, type BrowserCapabilities, type BrowserCapabilityPath, type BrowserCoreEngine, BrowserCoreError, type BrowserCoreErrorCode, type BrowserCoreErrorOptions, type BrowserExecutor, type BrowserInitScriptInput, type BrowserInitScriptRegistration, type BrowserInspector, type BrowserInstrumentation, type BrowserRouteFetchResult, type BrowserRouteHandlerResult, type BrowserRouteRegistration, type BrowserRouteRegistrationInput, type BrowserRouteRequest, CROSS_DOCUMENT_DETECTION_WINDOW_MS, CROSS_DOCUMENT_INTERACTION_TIMEOUT_MS, type CapturedCdpDomSnapshot, type CdpDomSnapshotDocument, type CdpDomTreeNode, type CdpRareIntegerData, type CdpRareStringData, type CdpShadowBoundaryInfo, type ChooserOpenedStepEvent, type ChooserRef, type ConsoleLevel, type ConsoleStepEvent, type CookiePriority, type CookieRecord, type CookieSameSite, type CoordinateSpace, DEFAULT_ACTION_BOUNDARY_POLL_INTERVAL_MS, DEFAULT_POST_LOAD_TRACKER_QUIET_WINDOW_MS, DEFAULT_VISUAL_STABILITY_SETTLE_MS, DEFAULT_VISUAL_STABILITY_TIMEOUT_MS, DOM_SNAPSHOT_COMPUTED_STYLE_NAMES, type DevicePixelRatio, type DialogOpenedStepEvent, type DialogRef, type DocumentEpoch, type DocumentRef, type DomSnapshot, type DomSnapshotNode, type DownloadFinishedStepEvent, type DownloadRef, type DownloadStartedStepEvent, type EventStreamMessageStepEvent, FakeBrowserCoreEngine, type FakeBrowserCoreEngineOptions, type FakeBrowserCorePageSeed, type FrameInfo, type FrameRef, type FrozenStepEvent, type GetNetworkRecordsInput, type HeaderEntry, type HitTestResult, type HtmlSnapshot, type IndexedDbDatabaseSnapshot, type IndexedDbIndexSnapshot, type IndexedDbObjectStoreSnapshot, type IndexedDbRecord, type KeyModifier, type LayoutViewport, type MouseButton, type NetworkCaptureState, type NetworkInitiator, type NetworkInitiatorType, type NetworkRecord, type NetworkRecordFilterInput, type NetworkRecordKind, type NetworkRequestId, type NetworkResourceType, type NetworkSourceMetadata, type NetworkTiming, type NetworkTransferSizes, type NodeLocator, type NodeRef, type PageClosedStepEvent, type PageCreatedStepEvent, type PageErrorStepEvent, type PageInfo, type PageLifecycleState, type PageRef, type PageScaleFactor, type PageZoomFactor, type PartialBrowserCapabilities, type PausedStepEvent, type Point, type PopupOpenedStepEvent, type PostLoadTrackerState, type Quad, type Rect, type ResumedStepEvent, type ScreenshotArtifact, type ScreenshotFormat, type ScrollOffset, type SessionRef, type SessionStorageSnapshot, type SessionTransportExecutor, type SessionTransportRequest, type SessionTransportResponse, type ShadowDomSnapshotMode, type Size, type StepEvent, type StepResult, type StorageEntry, type StorageOriginSnapshot, type StorageSnapshot, type ViewportMetrics, type VisualStabilityScope, type VisualViewport, type WaitForActionBoundaryInput, type WebSocketClosedStepEvent, type WebSocketFrameStepEvent, type WebSocketOpenedStepEvent, type WorkerCreatedStepEvent, type WorkerDestroyedStepEvent, type WorkerRef, allBrowserCapabilities, bodyPayloadFromUtf8, brand, buildCdpShadowBoundaryIndex, buildDomSnapshotFromCdpCapture, buildPostLoadTrackerInstallScript, buildPostLoadTrackerReadExpression, closedPageError, closedSessionError, createBodyPayload, createBrowserCoreError, createChooserRef, createDevicePixelRatio, createDialogRef, createDocumentEpoch, createDocumentRef, createDownloadRef, createFakeBrowserCoreEngine, createFrameRef, createHeaderEntry, createNetworkRequestId, createNodeLocator, createNodeRef, createPageRef, createPageScaleFactor, createPageZoomFactor, createPoint, createQuad, createRect, createScrollOffset, createSessionRef, createSize, createWorkerRef, filterCookieRecords, findDomSnapshotNode, findDomSnapshotNodeByRef, hasCapability, isBrowserCoreError, isChooserRef, isDialogRef, isDocumentRef, isDownloadRef, isFrameRef, isNetworkRequestId, isNodeRef, isPageRef, isSessionRef, isWorkerRef, matchesNetworkRecordFilters, mergeBrowserCapabilities, nextDocumentEpoch, noBrowserCapabilities, normalizeCdpShadowRootType, normalizePostLoadTrackerState, parseCdpStringTable, postLoadTrackerIsSettled, quadBounds, rareCdpIntegerValue, rareCdpStringValue, rectContainsPoint, rectToQuad, serializeDocumentEpoch, serializeRef, staleNodeRefError, unsupportedCapabilityError, waitForActionBoundary, waitForCdpVisualStability };

package/dist/index.js

@@ -2841,6 +2841,282 @@ function sleep(ms) {
   return new Promise((resolve) => setTimeout(resolve, ms));
 }
 
-export { BrowserCoreError, DEFAULT_VISUAL_STABILITY_SETTLE_MS, DEFAULT_VISUAL_STABILITY_TIMEOUT_MS, DOM_SNAPSHOT_COMPUTED_STYLE_NAMES, FakeBrowserCoreEngine, allBrowserCapabilities, bodyPayloadFromUtf8, brand, buildCdpShadowBoundaryIndex, buildDomSnapshotFromCdpCapture, closedPageError, closedSessionError, createBodyPayload, createBrowserCoreError, createChooserRef, createDevicePixelRatio, createDialogRef, createDocumentEpoch, createDocumentRef, createDownloadRef, createFakeBrowserCoreEngine, createFrameRef, createHeaderEntry, createNetworkRequestId, createNodeLocator, createNodeRef, createPageRef, createPageScaleFactor, createPageZoomFactor, createPoint, createQuad, createRect, createScrollOffset, createSessionRef, createSize, createWorkerRef, filterCookieRecords, findDomSnapshotNode, findDomSnapshotNodeByRef, hasCapability, isBrowserCoreError, isChooserRef, isDialogRef, isDocumentRef, isDownloadRef, isFrameRef, isNetworkRequestId, isNodeRef, isPageRef, isSessionRef, isWorkerRef, matchesNetworkRecordFilters, mergeBrowserCapabilities, nextDocumentEpoch, noBrowserCapabilities, normalizeCdpShadowRootType, parseCdpStringTable, quadBounds, rareCdpIntegerValue, rareCdpStringValue, rectContainsPoint, rectToQuad, serializeDocumentEpoch, serializeRef, staleNodeRefError, unsupportedCapabilityError, waitForCdpVisualStability };
+// src/post-load-tracker.ts
+var DEFAULT_POST_LOAD_TRACKER_QUIET_WINDOW_MS = 400;
+var DEFAULT_ACTION_BOUNDARY_POLL_INTERVAL_MS = 100;
+function isRecord(value) {
+  return typeof value === "object" && value !== null;
+}
+function readFiniteNumber(value) {
+  return typeof value === "number" && Number.isFinite(value) ? value : void 0;
+}
+function readNonNegativeNumber(value) {
+  const parsed = readFiniteNumber(value);
+  return parsed === void 0 || parsed < 0 ? 0 : parsed;
+}
+function normalizePostLoadTrackerState(value) {
+  if (!isRecord(value)) {
+    return void 0;
+  }
+  const installedAt = readFiniteNumber(value.installedAt);
+  const lastMutationAt = readFiniteNumber(value.lastMutationAt);
+  const lastNetworkActivityAt = readFiniteNumber(value.lastNetworkActivityAt);
+  const now = readFiniteNumber(value.now);
+  const readyState = typeof value.readyState === "string" ? value.readyState : void 0;
+  if (installedAt === void 0 || lastMutationAt === void 0 || lastNetworkActivityAt === void 0 || now === void 0 || readyState === void 0) {
+    return void 0;
+  }
+  return {
+    installedAt,
+    lastMutationAt,
+    lastNetworkActivityAt,
+    now,
+    pendingFetches: readNonNegativeNumber(value.pendingFetches),
+    pendingTimeouts: readNonNegativeNumber(value.pendingTimeouts),
+    pendingXhrs: readNonNegativeNumber(value.pendingXhrs),
+    readyState
+  };
+}
+function buildPostLoadTrackerInstallScript() {
+  return `(() => {
+    const globalObject = globalThis;
+    if (globalObject.__opensteerActionBoundaryTrackerInstalled) {
+      return true;
+    }
+
+    const tracker = {
+      installedAt: performance.now(),
+      lastMutationAt: performance.now(),
+      lastNetworkActivityAt: performance.now(),
+      pendingFetches: 0,
+      pendingTimeouts: 0,
+      pendingXhrs: 0,
+      readyState: document.readyState,
+      timeoutIds: new Set(),
+    };
+    globalObject.__opensteerActionBoundaryTrackerInstalled = true;
+    globalObject.__opensteerActionBoundaryTracker = tracker;
+
+    const markMutation = () => {
+      tracker.lastMutationAt = performance.now();
+      tracker.readyState = document.readyState;
+    };
+    const markNetwork = () => {
+      tracker.lastNetworkActivityAt = performance.now();
+      tracker.readyState = document.readyState;
+    };
+
+    const startObserver = () => {
+      const target = document.documentElement ?? document;
+      if (!(target instanceof Node)) {
+        return;
+      }
+      const observer = new MutationObserver(markMutation);
+      observer.observe(target, {
+        subtree: true,
+        childList: true,
+        characterData: true,
+        attributes: true,
+      });
+      markMutation();
+    };
+
+    if (document.documentElement) {
+      startObserver();
+    } else {
+      document.addEventListener("DOMContentLoaded", startObserver, { once: true });
+    }
+
+    document.addEventListener("readystatechange", markMutation);
+    addEventListener("load", markMutation, { once: true });
+
+    const nativeSetTimeout = globalObject.setTimeout.bind(globalObject);
+    const nativeClearTimeout = globalObject.clearTimeout.bind(globalObject);
+    globalObject.setTimeout = function(callback, delay, ...args) {
+      tracker.pendingTimeouts += 1;
+      markNetwork();
+      let handle;
+      const wrapped =
+        typeof callback === "function"
+          ? (...callbackArgs) => {
+              if (tracker.timeoutIds.delete(handle)) {
+                tracker.pendingTimeouts = Math.max(0, tracker.pendingTimeouts - 1);
+              }
+              try {
+                return callback(...callbackArgs);
+              } finally {
+                markMutation();
+              }
+            }
+          : callback;
+      handle = nativeSetTimeout(wrapped, delay, ...args);
+      tracker.timeoutIds.add(handle);
+      return handle;
+    };
+    globalObject.clearTimeout = function(handle) {
+      if (tracker.timeoutIds.delete(handle)) {
+        tracker.pendingTimeouts = Math.max(0, tracker.pendingTimeouts - 1);
+      }
+      return nativeClearTimeout(handle);
+    };
+
+    if (typeof globalObject.fetch === "function") {
+      const nativeFetch = globalObject.fetch.bind(globalObject);
+      globalObject.fetch = (...args) => {
+        tracker.pendingFetches += 1;
+        markNetwork();
+        return nativeFetch(...args)
+          .finally(() => {
+            tracker.pendingFetches = Math.max(0, tracker.pendingFetches - 1);
+            markNetwork();
+          });
+      };
+    }
+
+    if (typeof globalObject.XMLHttpRequest === "function") {
+      const NativeXMLHttpRequest = globalObject.XMLHttpRequest;
+      const nativeSend = NativeXMLHttpRequest.prototype.send;
+      NativeXMLHttpRequest.prototype.send = function(...args) {
+        tracker.pendingXhrs += 1;
+        markNetwork();
+        const finalize = () => {
+          this.removeEventListener("loadend", finalize);
+          tracker.pendingXhrs = Math.max(0, tracker.pendingXhrs - 1);
+          markNetwork();
+        };
+        this.addEventListener("loadend", finalize, { once: true });
+        return nativeSend.apply(this, args);
+      };
+    }
+
+    return true;
+  })()`;
+}
+function buildPostLoadTrackerReadExpression() {
+  return `(() => {
+    const tracker = globalThis.__opensteerActionBoundaryTracker;
+    if (!tracker) {
+      return null;
+    }
+
+    return {
+      installedAt: Number(tracker.installedAt ?? 0),
+      lastMutationAt: Number(tracker.lastMutationAt ?? 0),
+      lastNetworkActivityAt: Number(tracker.lastNetworkActivityAt ?? 0),
+      now: Number(performance.now()),
+      pendingFetches: Number(tracker.pendingFetches ?? 0),
+      pendingTimeouts: Number(tracker.pendingTimeouts ?? 0),
+      pendingXhrs: Number(tracker.pendingXhrs ?? 0),
+      readyState: String(document.readyState),
+    };
+  })()`;
+}
+function postLoadTrackerIsSettled(tracker, quietWindowMs = DEFAULT_POST_LOAD_TRACKER_QUIET_WINDOW_MS) {
+  if (!tracker) {
+    return false;
+  }
+  if (tracker.readyState !== "complete") {
+    return false;
+  }
+  if (tracker.pendingFetches > 0 || tracker.pendingTimeouts > 0 || tracker.pendingXhrs > 0) {
+    return false;
+  }
+  const lastActivityAt = Math.max(
+    tracker.installedAt,
+    tracker.lastMutationAt,
+    tracker.lastNetworkActivityAt
+  );
+  return tracker.now - lastActivityAt >= quietWindowMs;
+}
+
+// src/action-boundary.ts
+var CROSS_DOCUMENT_INTERACTION_TIMEOUT_MS = 3e4;
+var CROSS_DOCUMENT_DETECTION_WINDOW_MS = 500;
+async function waitForActionBoundary(input) {
+  if (input.timeoutMs <= 0) {
+    return {
+      trigger: "dom-action",
+      crossDocument: false,
+      bootstrapSettled: false,
+      timedOutPhase: "bootstrap"
+    };
+  }
+  const deadline = Date.now() + input.timeoutMs;
+  const crossDocumentDetectionDeadline = input.snapshot === void 0 ? void 0 : Math.min(deadline, Date.now() + CROSS_DOCUMENT_DETECTION_WINDOW_MS);
+  const pollIntervalMs = input.pollIntervalMs ?? DEFAULT_ACTION_BOUNDARY_POLL_INTERVAL_MS;
+  let trigger = "dom-action";
+  let crossDocument = false;
+  let waitedForNavigationContentLoaded = false;
+  while (Date.now() < deadline) {
+    input.throwBackgroundError();
+    if (input.isPageClosed()) {
+      return {
+        trigger,
+        crossDocument,
+        bootstrapSettled: true
+      };
+    }
+    if (input.signal?.aborted) {
+      if (isTimeoutAbort(input.signal.reason) && Date.now() >= deadline) {
+        return {
+          trigger,
+          crossDocument,
+          bootstrapSettled: false,
+          timedOutPhase: "bootstrap"
+        };
+      }
+      throw abortError(input.signal);
+    }
+    const currentDocumentRef = input.getCurrentMainFrameDocumentRef();
+    if (input.snapshot !== void 0 && currentDocumentRef !== void 0 && currentDocumentRef !== input.snapshot.documentRef) {
+      trigger = "navigation";
+      crossDocument = true;
+      if (!waitedForNavigationContentLoaded) {
+        waitedForNavigationContentLoaded = true;
+        const remaining = Math.max(0, deadline - Date.now());
+        if (remaining > 0) {
+          await input.waitForNavigationContentLoaded(remaining);
+        }
+      }
+    }
+    if (!crossDocument && crossDocumentDetectionDeadline !== void 0 && Date.now() >= crossDocumentDetectionDeadline) {
+      return {
+        trigger,
+        crossDocument,
+        bootstrapSettled: true
+      };
+    }
+    if (crossDocument && postLoadTrackerIsSettled(await input.readTrackerState())) {
+      return {
+        trigger,
+        crossDocument,
+        bootstrapSettled: true
+      };
+    }
+    await delay(Math.min(pollIntervalMs, Math.max(0, deadline - Date.now())));
+  }
+  return {
+    trigger,
+    crossDocument,
+    bootstrapSettled: false,
+    timedOutPhase: "bootstrap"
+  };
+}
+function abortError(signal) {
+  return signal.reason ?? new DOMException("The operation was aborted", "AbortError");
+}
+async function delay(ms) {
+  if (ms <= 0) {
+    return;
+  }
+  await new Promise((resolve) => {
+    setTimeout(resolve, ms);
+  });
+}
+function isTimeoutAbort(reason) {
+  return typeof reason === "object" && reason !== null && "code" in reason && reason.code === "timeout";
+}
+
+export { BrowserCoreError, CROSS_DOCUMENT_DETECTION_WINDOW_MS, CROSS_DOCUMENT_INTERACTION_TIMEOUT_MS, DEFAULT_ACTION_BOUNDARY_POLL_INTERVAL_MS, DEFAULT_POST_LOAD_TRACKER_QUIET_WINDOW_MS, DEFAULT_VISUAL_STABILITY_SETTLE_MS, DEFAULT_VISUAL_STABILITY_TIMEOUT_MS, DOM_SNAPSHOT_COMPUTED_STYLE_NAMES, FakeBrowserCoreEngine, allBrowserCapabilities, bodyPayloadFromUtf8, brand, buildCdpShadowBoundaryIndex, buildDomSnapshotFromCdpCapture, buildPostLoadTrackerInstallScript, buildPostLoadTrackerReadExpression, closedPageError, closedSessionError, createBodyPayload, createBrowserCoreError, createChooserRef, createDevicePixelRatio, createDialogRef, createDocumentEpoch, createDocumentRef, createDownloadRef, createFakeBrowserCoreEngine, createFrameRef, createHeaderEntry, createNetworkRequestId, createNodeLocator, createNodeRef, createPageRef, createPageScaleFactor, createPageZoomFactor, createPoint, createQuad, createRect, createScrollOffset, createSessionRef, createSize, createWorkerRef, filterCookieRecords, findDomSnapshotNode, findDomSnapshotNodeByRef, hasCapability, isBrowserCoreError, isChooserRef, isDialogRef, isDocumentRef, isDownloadRef, isFrameRef, isNetworkRequestId, isNodeRef, isPageRef, isSessionRef, isWorkerRef, matchesNetworkRecordFilters, mergeBrowserCapabilities, nextDocumentEpoch, noBrowserCapabilities, normalizeCdpShadowRootType, normalizePostLoadTrackerState, parseCdpStringTable, postLoadTrackerIsSettled, quadBounds, rareCdpIntegerValue, rareCdpStringValue, rectContainsPoint, rectToQuad, serializeDocumentEpoch, serializeRef, staleNodeRefError, unsupportedCapabilityError, waitForActionBoundary, waitForCdpVisualStability };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map