@farmslot/recipe-runner 0.23.0

package/dist/runtime/cdp.d.ts

@@ -0,0 +1,138 @@
+import type { UiObserverRef } from '@farmslot/protocol';
+import { type UiPoint } from '../adapters/gesture.js';
+import type { StandardUiAction, UiActionTransport } from '../adapters/ui.js';
+import { type UiScrollSession, type UiScrollToRequest } from '../core/scroll-to.js';
+import type { ActionExecutionContext, RecipeObservationResult } from '../core/types.js';
+export declare function sleep(ms: number): Promise<void>;
+export declare function dataTestId(testId: string): string;
+export interface CdpTargetInfo {
+    id: string;
+    type: string;
+    title?: string;
+    url?: string;
+    webSocketDebuggerUrl?: string;
+    devtoolsFrontendUrl?: string;
+    description?: string;
+}
+export interface RetryJsonGetOptions {
+    timeoutMs?: number;
+    intervalMs?: number;
+}
+export interface JsonGetOptions {
+    timeoutMs?: number;
+}
+export interface SelectCdpTargetOptions {
+    host?: string;
+    port: number;
+    type?: string;
+    urlIncludes?: string;
+    titleIncludes?: string;
+    predicate?: (target: CdpTargetInfo) => boolean;
+}
+interface CdpCallOptions {
+    timeoutMs?: number;
+}
+export declare function jsonGet<T = unknown>(url: string, options?: JsonGetOptions): Promise<T>;
+export declare function retryJsonGet<T = unknown>(url: string, options?: RetryJsonGetOptions): Promise<T>;
+export declare function listCdpTargets(host: string, port: number): Promise<CdpTargetInfo[]>;
+export declare function selectCdpTarget(options: SelectCdpTargetOptions): Promise<CdpTargetInfo>;
+export type CdpEventHandler = (params: Record<string, unknown>) => void;
+export declare class CdpSession {
+    #private;
+    private constructor();
+    static connect(webSocketDebuggerUrl: string, options?: {
+        timeoutMs?: number;
+    }): Promise<CdpSession>;
+    call<T = unknown>(method: string, params?: Record<string, unknown>, options?: CdpCallOptions): Promise<T>;
+    on(method: string, handler: CdpEventHandler): () => void;
+    close(): void;
+}
+export interface CdpCompositorProbe {
+    status: 'ready' | 'suspended' | 'not-interactive';
+    frameAdvanced: boolean;
+    interactiveTargetFound: boolean;
+    hitTestOk: boolean | null;
+    reason?: string;
+}
+interface CdpCallSession {
+    call<T = unknown>(method: string, params?: Record<string, unknown>, options?: CdpCallOptions): Promise<T>;
+}
+/**
+ * Distinguish a reachable JavaScript context from a renderable, interactive
+ * browser page. Hardened pages are retried in an isolated world so page policy
+ * cannot hide requestAnimationFrame from the readiness probe. Navigation races
+ * return a suspended report rather than rejecting the probe.
+ */
+export declare function probeCdpCompositorInteractivity(session: CdpCallSession, timeoutMs?: number): Promise<CdpCompositorProbe>;
+export declare class CdpWebPage {
+    readonly session: CdpSession;
+    constructor(session: CdpSession);
+    static connectToTarget(target: CdpTargetInfo): Promise<CdpWebPage>;
+    navigate(url: string, timeoutMs?: number): Promise<unknown>;
+    private currentNavigationUrl;
+    private waitForNavigationUrlChange;
+    waitForDocumentReady(options: {
+        expectedUrl?: string;
+        timeoutMs?: number;
+    }): Promise<void>;
+    waitForDomSettled(timeoutMs?: number): Promise<void>;
+    evaluate<T = unknown>(expression: string): Promise<T>;
+    evaluateInIsolatedWorld<T = unknown>(expression: string, worldName: string): Promise<T>;
+    click(selector: string): Promise<unknown>;
+    clickText(text: string): Promise<unknown>;
+    private waitForClickTarget;
+    setInput(selector: string, value: string): Promise<unknown>;
+    keyPress(key: string): Promise<unknown>;
+    clickPoint(x: number, y: number): Promise<void>;
+    private pressAndReleasePoint;
+    resolveGesturePoint(target: string | UiPoint): Promise<UiPoint>;
+    /**
+     * Raw ui.scroll movement. offsetX/offsetY set an absolute position; deltaX/deltaY move relative
+     * to the current one (default: one 600px step down). Callers never mix the two.
+     */
+    scroll(options: {
+        selector?: string;
+        offsetX?: number;
+        offsetY?: number;
+        deltaX?: number;
+        deltaY?: number;
+        intoView?: boolean;
+    }): Promise<unknown>;
+    /** ui.scroll_to primitives for one surface; valid while this page connection stays open. */
+    scrollSession(request: UiScrollToRequest): Promise<UiScrollSession>;
+    waitFor(options: {
+        selector?: string;
+        text?: string;
+        expected?: string;
+        timeoutMs?: number;
+    }): Promise<unknown>;
+    waitForSelector(selector: string, options?: {
+        timeoutMs?: number;
+    }): Promise<unknown>;
+    waitForExpression(expression: string, options?: {
+        timeoutMs?: number;
+    }): Promise<unknown>;
+    screenshot(context?: ActionExecutionContext, relPath?: string, metadata?: Record<string, unknown>): Promise<string | {
+        path: string;
+        type: string;
+        nodeId: string;
+        label?: string;
+        category?: string;
+        mimeType: string;
+    }>;
+    observe(refs: readonly UiObserverRef[]): Promise<RecipeObservationResult>;
+    close(): void;
+}
+export interface CdpWebUiTransportInput {
+    action: StandardUiAction;
+    node: Record<string, unknown>;
+    context: ActionExecutionContext;
+}
+export interface CreateCdpWebUiTransportOptions {
+    getPage?(input: CdpWebUiTransportInput): Promise<CdpWebPage>;
+    withPage?<T>(input: CdpWebUiTransportInput, callback: (page: CdpWebPage) => Promise<T>): Promise<T>;
+}
+export declare function createCdpWebUiTransport(options: CreateCdpWebUiTransportOptions): UiActionTransport;
+export declare function selectorForUiInput(node: Record<string, unknown>): string | undefined;
+export {};
+//# sourceMappingURL=cdp.d.ts.map

package/dist/runtime/cdp.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cdp.d.ts","sourceRoot":"","sources":["../../src/runtime/cdp.ts"],"names":[],"mappings":"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"}