agent-browser 0.8.10 → 0.9.0

package/dist/ios-manager.d.ts

@@ -0,0 +1,266 @@
+/**
+ * iOS Simulator Manager - Manages iOS Simulator and Safari automation via Appium.
+ *
+ * This provides 1:1 command parity with BrowserManager for iOS Safari.
+ */
+export interface IOSRefMap {
+    [ref: string]: {
+        selector: string;
+        role?: string;
+        name?: string;
+        xpath?: string;
+    };
+}
+export interface IOSEnhancedSnapshot {
+    tree: string;
+    refs: IOSRefMap;
+}
+interface IOSDeviceInfo {
+    name: string;
+    udid: string;
+    state: string;
+    runtime: string;
+    isAvailable: boolean;
+    isRealDevice?: boolean;
+}
+/**
+ * Manages iOS Simulator and Safari automation via Appium
+ */
+export declare class IOSManager {
+    private simctl;
+    private browser;
+    private appiumProcess;
+    private deviceUdid;
+    private deviceName;
+    private consoleMessages;
+    private refMap;
+    private lastSnapshot;
+    private refCounter;
+    private static readonly APPIUM_PORT;
+    private static readonly APPIUM_HOST;
+    constructor();
+    /**
+     * Check if browser is launched
+     */
+    isLaunched(): boolean;
+    /**
+     * List connected real iOS devices
+     */
+    private listRealDevices;
+    /**
+     * List available iOS simulators
+     */
+    listDevices(): Promise<IOSDeviceInfo[]>;
+    /**
+     * List all devices (simulators + real devices)
+     */
+    listAllDevices(): Promise<IOSDeviceInfo[]>;
+    /**
+     * Find the best default device (most recent iPhone)
+     */
+    private findDefaultDevice;
+    /**
+     * Find device by name or UDID (searches both simulators and real devices)
+     */
+    private findDevice;
+    /**
+     * Check if Appium is installed
+     */
+    private checkAppiumInstalled;
+    /**
+     * Check if Appium server is already running
+     */
+    private isAppiumRunning;
+    /**
+     * Start Appium server if not already running
+     */
+    private startAppiumServer;
+    /**
+     * Boot the iOS simulator
+     */
+    private bootSimulator;
+    /**
+     * Launch iOS Safari via Appium
+     */
+    launch(options?: {
+        device?: string;
+        udid?: string;
+        headless?: boolean;
+    }): Promise<void>;
+    /**
+     * Navigate to URL
+     */
+    navigate(url: string): Promise<{
+        url: string;
+        title: string;
+    }>;
+    /**
+     * Get current URL
+     */
+    getUrl(): Promise<string>;
+    /**
+     * Get page title
+     */
+    getTitle(): Promise<string>;
+    /**
+     * Click/tap an element
+     */
+    click(selector: string): Promise<void>;
+    /**
+     * Alias for click (semantic clarity for touch)
+     */
+    tap(selector: string): Promise<void>;
+    /**
+     * Type text into an element
+     */
+    type(selector: string, text: string, options?: {
+        delay?: number;
+        clear?: boolean;
+    }): Promise<void>;
+    /**
+     * Fill an element (clear first, then type)
+     */
+    fill(selector: string, value: string): Promise<void>;
+    /**
+     * Get element by selector or ref
+     */
+    private getElement;
+    /**
+     * Get ref data from ref string
+     */
+    private getRefData;
+    /**
+     * Take a screenshot
+     */
+    screenshot(options?: {
+        path?: string;
+        fullPage?: boolean;
+    }): Promise<{
+        path?: string;
+        base64?: string;
+    }>;
+    /**
+     * Get page snapshot with refs
+     */
+    getSnapshot(options?: {
+        interactive?: boolean;
+    }): Promise<IOSEnhancedSnapshot>;
+    /**
+     * Get cached ref map
+     */
+    getRefMap(): IOSRefMap;
+    /**
+     * Scroll the page
+     */
+    scroll(options?: {
+        selector?: string;
+        x?: number;
+        y?: number;
+        direction?: 'up' | 'down' | 'left' | 'right';
+        amount?: number;
+    }): Promise<void>;
+    /**
+     * Swipe gesture (iOS-specific)
+     */
+    swipe(direction: 'up' | 'down' | 'left' | 'right', options?: {
+        distance?: number;
+    }): Promise<void>;
+    /**
+     * Execute JavaScript
+     */
+    evaluate<T = unknown>(script: string, ...args: unknown[]): Promise<T>;
+    /**
+     * Wait for element
+     */
+    wait(options: {
+        selector?: string;
+        timeout?: number;
+        state?: 'attached' | 'detached' | 'visible' | 'hidden';
+    }): Promise<void>;
+    /**
+     * Press a key
+     */
+    press(key: string): Promise<void>;
+    /**
+     * Hover over element (limited on touch - just scrolls into view)
+     */
+    hover(selector: string): Promise<void>;
+    /**
+     * Get page content (HTML)
+     */
+    getContent(selector?: string): Promise<string>;
+    /**
+     * Get text content of element
+     */
+    getText(selector: string): Promise<string>;
+    /**
+     * Get attribute value
+     */
+    getAttribute(selector: string, attribute: string): Promise<string | null>;
+    /**
+     * Check if element is visible
+     */
+    isVisible(selector: string): Promise<boolean>;
+    /**
+     * Check if element is enabled
+     */
+    isEnabled(selector: string): Promise<boolean>;
+    /**
+     * Navigate back
+     */
+    goBack(): Promise<void>;
+    /**
+     * Navigate forward
+     */
+    goForward(): Promise<void>;
+    /**
+     * Reload page
+     */
+    reload(): Promise<void>;
+    /**
+     * Select option(s) from dropdown
+     */
+    select(selector: string, values: string | string[]): Promise<void>;
+    /**
+     * Check a checkbox
+     */
+    check(selector: string): Promise<void>;
+    /**
+     * Uncheck a checkbox
+     */
+    uncheck(selector: string): Promise<void>;
+    /**
+     * Focus an element
+     */
+    focus(selector: string): Promise<void>;
+    /**
+     * Clear input field
+     */
+    clear(selector: string): Promise<void>;
+    /**
+     * Get element count
+     */
+    count(selector: string): Promise<number>;
+    /**
+     * Get bounding box
+     */
+    getBoundingBox(selector: string): Promise<{
+        x: number;
+        y: number;
+        width: number;
+        height: number;
+    } | null>;
+    /**
+     * Get device info
+     */
+    getDeviceInfo(): {
+        name: string;
+        udid: string;
+    } | null;
+    /**
+     * Close browser and cleanup
+     */
+    close(): Promise<void>;
+}
+export {};
+//# sourceMappingURL=ios-manager.d.ts.map

package/dist/ios-manager.d.ts.map

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