snapdrive-ios 0.1.0

package/dist/core/element-finder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"element-finder.d.ts","sourceRoot":"","sources":["../../src/core/element-finder.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EACV,oBAAoB,EACpB,KAAK,EACL,mBAAmB,EACnB,gBAAgB,EACjB,MAAM,oCAAoC,CAAC;AAE5C,MAAM,WAAW,cAAc;IAC7B,WAAW,CAAC,QAAQ,EAAE,oBAAoB,EAAE,EAAE,KAAK,EAAE,MAAM,GAAG,oBAAoB,EAAE,CAAC;IACrF,mBAAmB,CAAC,QAAQ,EAAE,oBAAoB,EAAE,EAAE,OAAO,EAAE,MAAM,GAAG,oBAAoB,EAAE,CAAC;IAC/F,UAAU,CAAC,QAAQ,EAAE,oBAAoB,EAAE,EAAE,IAAI,EAAE,MAAM,GAAG,oBAAoB,EAAE,CAAC;IACnF,UAAU,CAAC,QAAQ,EAAE,oBAAoB,EAAE,EAAE,IAAI,EAAE,MAAM,GAAG,oBAAoB,EAAE,CAAC;IACnF,eAAe,CACb,QAAQ,EAAE,oBAAoB,EAAE,EAChC,SAAS,EAAE,gBAAgB,GAC1B,oBAAoB,EAAE,CAAC;IAC1B,QAAQ,CACN,QAAQ,EAAE,oBAAoB,EAAE,EAChC,SAAS,EAAE,gBAAgB,EAC3B,YAAY,CAAC,EAAE,KAAK,GACnB,mBAAmB,CAAC;IACvB,cAAc,CAAC,OAAO,EAAE,oBAAoB,GAAG,KAAK,CAAC;IACrD,YAAY,CAAC,QAAQ,EAAE,oBAAoB,EAAE,GAAG,MAAM,EAAE,CAAC;IACzD,gBAAgB,CAAC,QAAQ,EAAE,oBAAoB,EAAE,GAAG;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;CACjG;AAED,qBAAa,aAAc,YAAW,cAAc;IAClD;;OAEG;IACH,WAAW,CAAC,QAAQ,EAAE,oBAAoB,EAAE,EAAE,KAAK,EAAE,MAAM,GAAG,oBAAoB,EAAE;IAIpF;;OAEG;IACH,mBAAmB,CAAC,QAAQ,EAAE,oBAAoB,EAAE,EAAE,OAAO,EAAE,MAAM,GAAG,oBAAoB,EAAE;IAK9F;;OAEG;IACH,UAAU,CAAC,QAAQ,EAAE,oBAAoB,EAAE,EAAE,IAAI,EAAE,MAAM,GAAG,oBAAoB,EAAE;IAKlF;;OAEG;IACH,UAAU,CAAC,QAAQ,EAAE,oBAAoB,EAAE,EAAE,IAAI,EAAE,MAAM,GAAG,oBAAoB,EAAE;IAKlF;;OAEG;IACH,eAAe,CACb,QAAQ,EAAE,oBAAoB,EAAE,EAChC,SAAS,EAAE,gBAAgB,GAC1B,oBAAoB,EAAE;IAIzB;;OAEG;IACH,QAAQ,CACN,QAAQ,EAAE,oBAAoB,EAAE,EAChC,SAAS,EAAE,gBAAgB,EAC3B,YAAY,GAAE,KAA0B,GACvC,mBAAmB;IAwBtB;;OAEG;IACH,cAAc,CAAC,OAAO,EAAE,oBAAoB,GAAG,KAAK;IAOpD;;OAEG;IACH,YAAY,CAAC,QAAQ,EAAE,oBAAoB,EAAE,GAAG,MAAM,EAAE;IAUxD;;OAEG;IACH,OAAO,CAAC,gBAAgB;IA6CxB;;;;;OAKG;IACH,OAAO,CAAC,YAAY;IAsBpB;;OAEG;IACH,OAAO,CAAC,YAAY;IAWpB;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAOxB;;;OAGG;IACH,gBAAgB,CAAC,QAAQ,EAAE,oBAAoB,EAAE,GAAG;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI;CAgFhG;AAED,eAAO,MAAM,aAAa,eAAsB,CAAC"}

package/dist/core/element-finder.js

@@ -0,0 +1,246 @@
+/**
+ * Element finder - search and locate UI elements
+ */
+export class ElementFinder {
+    /**
+     * Find elements with exact label match
+     */
+    findByLabel(elements, label) {
+        return elements.filter((el) => el.label === label);
+    }
+    /**
+     * Find elements with partial label match
+     */
+    findByLabelContains(elements, partial) {
+        const lowerPartial = partial.toLowerCase();
+        return elements.filter((el) => el.label?.toLowerCase().includes(lowerPartial));
+    }
+    /**
+     * Find elements by type
+     */
+    findByType(elements, type) {
+        const lowerType = type.toLowerCase();
+        return elements.filter((el) => el.type?.toLowerCase() === lowerType);
+    }
+    /**
+     * Find elements by role
+     */
+    findByRole(elements, role) {
+        const lowerRole = role.toLowerCase();
+        return elements.filter((el) => el.role?.toLowerCase().includes(lowerRole));
+    }
+    /**
+     * Find elements matching a predicate
+     */
+    findByPredicate(elements, predicate) {
+        return elements.filter((el) => this.matchesPredicate(el, predicate));
+    }
+    /**
+     * Find the best matching element and return search result with tap coordinates
+     */
+    findBest(elements, predicate, screenCenter = { x: 200, y: 400 }) {
+        const matches = this.findByPredicate(elements, predicate);
+        if (matches.length === 0) {
+            return {
+                found: false,
+                elements: [],
+                count: 0,
+            };
+        }
+        // Rank and sort matches
+        const ranked = this.rankElements(matches, screenCenter);
+        const best = ranked[0];
+        return {
+            found: true,
+            element: best,
+            elements: ranked,
+            count: ranked.length,
+            tapCoordinates: this.getCenterPoint(best),
+        };
+    }
+    /**
+     * Calculate center point of element's frame
+     */
+    getCenterPoint(element) {
+        return {
+            x: Math.round(element.frame.x + element.frame.width / 2),
+            y: Math.round(element.frame.y + element.frame.height / 2),
+        };
+    }
+    /**
+     * Get all labels from elements (for debugging/suggestions)
+     */
+    getAllLabels(elements) {
+        const labels = new Set();
+        for (const el of elements) {
+            if (el.label) {
+                labels.add(el.label);
+            }
+        }
+        return Array.from(labels).sort();
+    }
+    /**
+     * Check if element matches predicate
+     */
+    matchesPredicate(el, pred) {
+        // Check label (exact match or regex)
+        if (pred.label !== undefined) {
+            if (pred.label instanceof RegExp) {
+                if (!el.label || !pred.label.test(el.label)) {
+                    return false;
+                }
+            }
+            else {
+                if (el.label !== pred.label) {
+                    return false;
+                }
+            }
+        }
+        // Check labelContains
+        if (pred.labelContains !== undefined) {
+            if (!el.label?.toLowerCase().includes(pred.labelContains.toLowerCase())) {
+                return false;
+            }
+        }
+        // Check type
+        if (pred.type !== undefined) {
+            if (el.type?.toLowerCase() !== pred.type.toLowerCase()) {
+                return false;
+            }
+        }
+        // Check role
+        if (pred.role !== undefined) {
+            if (!el.role?.toLowerCase().includes(pred.role.toLowerCase())) {
+                return false;
+            }
+        }
+        // Check enabled
+        if (pred.enabled !== undefined) {
+            if (el.enabled !== pred.enabled) {
+                return false;
+            }
+        }
+        return true;
+    }
+    /**
+     * Rank elements by priority:
+     * 1. Buttons and tappable elements first
+     * 2. Enabled elements before disabled
+     * 3. Closer to screen center
+     */
+    rankElements(elements, screenCenter) {
+        return [...elements].sort((a, b) => {
+            // Priority 1: Button-like elements
+            const aIsButton = this.isButtonLike(a);
+            const bIsButton = this.isButtonLike(b);
+            if (aIsButton && !bIsButton)
+                return -1;
+            if (!aIsButton && bIsButton)
+                return 1;
+            // Priority 2: Enabled elements
+            if (a.enabled && !b.enabled)
+                return -1;
+            if (!a.enabled && b.enabled)
+                return 1;
+            // Priority 3: Closer to screen center
+            const aDistance = this.distanceToCenter(a, screenCenter);
+            const bDistance = this.distanceToCenter(b, screenCenter);
+            return aDistance - bDistance;
+        });
+    }
+    /**
+     * Check if element is button-like (more likely to be tappable)
+     */
+    isButtonLike(el) {
+        const buttonTypes = ['button', 'link', 'tab', 'cell'];
+        const type = el.type?.toLowerCase() ?? '';
+        const role = el.role?.toLowerCase() ?? '';
+        return (buttonTypes.some((t) => type.includes(t) || role.includes(t)) ||
+            el.traits?.some((t) => t.toLowerCase().includes('button')) === true);
+    }
+    /**
+     * Calculate distance from element center to screen center
+     */
+    distanceToCenter(el, screenCenter) {
+        const center = this.getCenterPoint(el);
+        const dx = center.x - screenCenter.x;
+        const dy = center.y - screenCenter.y;
+        return Math.sqrt(dx * dx + dy * dy);
+    }
+    /**
+     * Find the best scroll region by analyzing element frames
+     * Returns center point of the largest container that likely contains scrollable content
+     */
+    findScrollRegion(elements) {
+        // Default fallback
+        const defaultCenter = { centerX: 200, centerY: 400 };
+        if (elements.length === 0) {
+            return defaultCenter;
+        }
+        // Find container elements (Group, etc.) that could be scroll containers
+        const containerTypes = ['group', 'axgroup', 'scrollview', 'tableview', 'collectionview', 'list'];
+        const containers = elements.filter((el) => {
+            const type = el.type?.toLowerCase() ?? '';
+            const role = el.role?.toLowerCase() ?? '';
+            return containerTypes.some(t => type.includes(t) || role.includes(t));
+        });
+        // If we found containers, find the largest one that's not at the very top
+        // (to avoid navigation bars which are usually at y < 100)
+        let bestContainer = null;
+        let maxArea = 0;
+        const candidateContainers = containers.length > 0 ? containers : elements;
+        for (const el of candidateContainers) {
+            const frame = el.frame;
+            if (!frame)
+                continue;
+            // Skip elements that are likely navigation bars (at very top)
+            if (frame.y < 50 && frame.height < 100)
+                continue;
+            // Skip elements that are likely tab bars (at very bottom, small height)
+            if (frame.y > 700 && frame.height < 100)
+                continue;
+            // Skip very small elements
+            if (frame.width < 100 || frame.height < 100)
+                continue;
+            const area = frame.width * frame.height;
+            if (area > maxArea) {
+                maxArea = area;
+                bestContainer = el;
+            }
+        }
+        if (bestContainer && bestContainer.frame) {
+            const frame = bestContainer.frame;
+            return {
+                centerX: Math.round(frame.x + frame.width / 2),
+                centerY: Math.round(frame.y + frame.height / 2),
+            };
+        }
+        // Fallback: calculate center from all element bounds
+        let minY = Infinity, maxY = 0;
+        let avgX = 0;
+        let count = 0;
+        for (const el of elements) {
+            if (!el.frame)
+                continue;
+            const frame = el.frame;
+            // Skip likely navigation/tab bars
+            if (frame.y < 50 && frame.height < 100)
+                continue;
+            if (frame.y > 700 && frame.height < 100)
+                continue;
+            minY = Math.min(minY, frame.y);
+            maxY = Math.max(maxY, frame.y + frame.height);
+            avgX += frame.x + frame.width / 2;
+            count++;
+        }
+        if (count > 0) {
+            return {
+                centerX: Math.round(avgX / count),
+                centerY: Math.round((minY + maxY) / 2),
+            };
+        }
+        return defaultCenter;
+    }
+}
+export const elementFinder = new ElementFinder();
+//# sourceMappingURL=element-finder.js.map

package/dist/core/element-finder.js.map

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

package/dist/core/idb-client.d.ts

@@ -0,0 +1,68 @@
+/**
+ * idb (iOS Development Bridge) client wrapper
+ * Wraps Facebook's idb CLI for UI automation
+ */
+import type { AccessibilityElement, UITree } from '../interfaces/element.interface.js';
+import type { DeviceButton } from '../interfaces/config.interface.js';
+import { type ICommandExecutor } from './command-executor.js';
+import { type ILogger } from '../utils/logger.js';
+export interface TapOptions {
+    duration?: number;
+    deviceUdid?: string;
+}
+export interface SwipeOptions {
+    delta?: number;
+    duration?: number;
+    deviceUdid?: string;
+}
+export interface IDBClientOptions {
+    deviceUdid?: string;
+    timeoutMs?: number;
+}
+export interface IIDBClient {
+    tap(x: number, y: number, options?: TapOptions): Promise<void>;
+    swipe(startX: number, startY: number, endX: number, endY: number, options?: SwipeOptions): Promise<void>;
+    typeText(text: string, deviceUdid?: string): Promise<void>;
+    describeAll(deviceUdid?: string): Promise<UITree>;
+    describePoint(x: number, y: number, deviceUdid?: string): Promise<AccessibilityElement | null>;
+    pressButton(button: DeviceButton, duration?: number, deviceUdid?: string): Promise<void>;
+    keyEvent(keyCode: number, duration?: number, deviceUdid?: string): Promise<void>;
+}
+export declare class IDBClient implements IIDBClient {
+    private executor;
+    private logger;
+    private defaultUdid?;
+    private timeoutMs;
+    private connectedUdids;
+    constructor(options?: IDBClientOptions, executor?: ICommandExecutor, logger?: ILogger);
+    /**
+     * Ensure idb is connected to the target device
+     */
+    private ensureConnected;
+    private buildArgs;
+    tap(x: number, y: number, options?: TapOptions): Promise<void>;
+    swipe(startX: number, startY: number, endX: number, endY: number, options?: SwipeOptions): Promise<void>;
+    typeText(text: string, deviceUdid?: string): Promise<void>;
+    describeAll(deviceUdid?: string): Promise<UITree>;
+    describePoint(x: number, y: number, deviceUdid?: string): Promise<AccessibilityElement | null>;
+    pressButton(button: DeviceButton, duration?: number, deviceUdid?: string): Promise<void>;
+    keyEvent(keyCode: number, duration?: number, deviceUdid?: string): Promise<void>;
+    /**
+     * Parse idb describe-all output into AccessibilityElement array
+     * Handles both JSON array and newline-delimited JSON formats
+     */
+    private parseDescribeOutput;
+    /**
+     * Normalize element from idb output to our interface
+     * Handles different field naming conventions defensively
+     */
+    private normalizeElement;
+    private getString;
+    private getBoolean;
+    private getStringArray;
+    private parseFrame;
+    private parseAXFrameString;
+    private isValidFrame;
+}
+export declare const idbClient: IDBClient;
+//# sourceMappingURL=idb-client.d.ts.map

package/dist/core/idb-client.d.ts.map

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

package/dist/core/idb-client.js

@@ -0,0 +1,327 @@
+/**
+ * idb (iOS Development Bridge) client wrapper
+ * Wraps Facebook's idb CLI for UI automation
+ */
+import { CommandExecutor } from './command-executor.js';
+import { Logger } from '../utils/logger.js';
+export class IDBClient {
+    executor;
+    logger;
+    defaultUdid;
+    timeoutMs;
+    connectedUdids = new Set();
+    constructor(options = {}, executor, logger) {
+        this.executor = executor ?? new CommandExecutor();
+        this.logger = logger ?? new Logger('idb-client');
+        this.defaultUdid = options.deviceUdid;
+        this.timeoutMs = options.timeoutMs ?? 30000;
+    }
+    /**
+     * Ensure idb is connected to the target device
+     */
+    async ensureConnected(deviceUdid) {
+        // Get target UDID
+        let udid = deviceUdid ?? this.defaultUdid;
+        if (!udid) {
+            // Try to find booted device
+            const result = await this.executor.execute('xcrun', ['simctl', 'list', 'devices', 'booted', '-j'], { timeoutMs: 10000 });
+            if (result.exitCode === 0) {
+                try {
+                    const data = JSON.parse(result.stdout);
+                    for (const deviceList of Object.values(data.devices ?? {})) {
+                        for (const device of deviceList) {
+                            if (device.state === 'Booted' && device.udid) {
+                                udid = device.udid;
+                                break;
+                            }
+                        }
+                        if (udid)
+                            break;
+                    }
+                }
+                catch {
+                    // ignore parse error
+                }
+            }
+        }
+        if (!udid) {
+            throw new Error('No simulator UDID specified and no booted simulator found');
+        }
+        // Connect if not already connected
+        if (!this.connectedUdids.has(udid)) {
+            this.logger.debug(`Connecting idb to device: ${udid}`);
+            const connectResult = await this.executor.execute('idb', ['connect', udid], { timeoutMs: 10000 });
+            if (connectResult.exitCode !== 0) {
+                throw new Error(`Failed to connect idb to device ${udid}: ${connectResult.stderr}`);
+            }
+            this.connectedUdids.add(udid);
+            this.logger.info(`Connected idb to device: ${udid}`);
+        }
+        return udid;
+    }
+    buildArgs(baseArgs) {
+        // No --udid flag needed after idb connect
+        return baseArgs;
+    }
+    async tap(x, y, options = {}) {
+        await this.ensureConnected(options.deviceUdid);
+        const args = this.buildArgs(['ui', 'tap', String(Math.round(x)), String(Math.round(y))]);
+        if (options.duration && options.duration > 0) {
+            args.push('--duration', String(options.duration));
+        }
+        const result = await this.executor.execute('idb', args, {
+            timeoutMs: this.timeoutMs,
+        });
+        if (result.exitCode !== 0) {
+            throw new Error(`idb tap failed: ${result.stderr}`);
+        }
+        this.logger.debug(`Tapped at (${x}, ${y})`);
+    }
+    async swipe(startX, startY, endX, endY, options = {}) {
+        await this.ensureConnected(options.deviceUdid);
+        const args = this.buildArgs([
+            'ui',
+            'swipe',
+            String(Math.round(startX)),
+            String(Math.round(startY)),
+            String(Math.round(endX)),
+            String(Math.round(endY)),
+        ]);
+        if (options.delta) {
+            args.push('--delta', String(options.delta));
+        }
+        if (options.duration) {
+            args.push('--duration', String(options.duration));
+        }
+        const result = await this.executor.execute('idb', args, {
+            timeoutMs: this.timeoutMs,
+        });
+        if (result.exitCode !== 0) {
+            throw new Error(`idb swipe failed: ${result.stderr}`);
+        }
+        this.logger.debug(`Swiped from (${startX}, ${startY}) to (${endX}, ${endY})`);
+    }
+    async typeText(text, deviceUdid) {
+        await this.ensureConnected(deviceUdid);
+        const args = this.buildArgs(['ui', 'text', text]);
+        const result = await this.executor.execute('idb', args, {
+            timeoutMs: this.timeoutMs,
+        });
+        if (result.exitCode !== 0) {
+            throw new Error(`idb text failed: ${result.stderr}`);
+        }
+        this.logger.debug(`Typed text: "${text.slice(0, 20)}${text.length > 20 ? '...' : ''}"`);
+    }
+    async describeAll(deviceUdid) {
+        await this.ensureConnected(deviceUdid);
+        const args = this.buildArgs(['ui', 'describe-all']);
+        const result = await this.executor.execute('idb', args, {
+            timeoutMs: this.timeoutMs,
+        });
+        if (result.exitCode !== 0) {
+            throw new Error(`idb describe-all failed: ${result.stderr}`);
+        }
+        const elements = this.parseDescribeOutput(result.stdout);
+        return {
+            elements,
+            timestamp: new Date().toISOString(),
+        };
+    }
+    async describePoint(x, y, deviceUdid) {
+        await this.ensureConnected(deviceUdid);
+        const args = this.buildArgs([
+            'ui',
+            'describe-point',
+            String(Math.round(x)),
+            String(Math.round(y)),
+        ]);
+        const result = await this.executor.execute('idb', args, {
+            timeoutMs: this.timeoutMs,
+        });
+        if (result.exitCode !== 0) {
+            return null;
+        }
+        try {
+            const parsed = JSON.parse(result.stdout);
+            return this.normalizeElement(parsed);
+        }
+        catch {
+            return null;
+        }
+    }
+    async pressButton(button, duration, deviceUdid) {
+        await this.ensureConnected(deviceUdid);
+        const buttonMap = {
+            HOME: 'HOME',
+            LOCK: 'LOCK',
+            SIDE_BUTTON: 'SIDE_BUTTON',
+            SIRI: 'SIRI',
+            APPLE_PAY: 'APPLE_PAY',
+        };
+        const args = this.buildArgs(['ui', 'button', buttonMap[button]]);
+        if (duration) {
+            args.push('--duration', String(duration));
+        }
+        const result = await this.executor.execute('idb', args, {
+            timeoutMs: this.timeoutMs,
+        });
+        if (result.exitCode !== 0) {
+            throw new Error(`idb button press failed: ${result.stderr}`);
+        }
+        this.logger.debug(`Pressed button: ${button}`);
+    }
+    async keyEvent(keyCode, duration, deviceUdid) {
+        await this.ensureConnected(deviceUdid);
+        const args = this.buildArgs(['ui', 'key', String(keyCode)]);
+        if (duration) {
+            args.push('--duration', String(duration));
+        }
+        const result = await this.executor.execute('idb', args, {
+            timeoutMs: this.timeoutMs,
+        });
+        if (result.exitCode !== 0) {
+            throw new Error(`idb key event failed: ${result.stderr}`);
+        }
+        this.logger.debug(`Sent key event: ${keyCode}`);
+    }
+    /**
+     * Parse idb describe-all output into AccessibilityElement array
+     * Handles both JSON array and newline-delimited JSON formats
+     */
+    parseDescribeOutput(output) {
+        const trimmed = output.trim();
+        if (!trimmed) {
+            return [];
+        }
+        try {
+            // Try parsing as JSON array first
+            const parsed = JSON.parse(trimmed);
+            if (Array.isArray(parsed)) {
+                return parsed.map((el) => this.normalizeElement(el)).filter(Boolean);
+            }
+            // Single object
+            const normalized = this.normalizeElement(parsed);
+            return normalized ? [normalized] : [];
+        }
+        catch {
+            // Try parsing as newline-delimited JSON
+            const elements = [];
+            for (const line of trimmed.split('\n')) {
+                const lineTrimmed = line.trim();
+                if (!lineTrimmed)
+                    continue;
+                try {
+                    const parsed = JSON.parse(lineTrimmed);
+                    const normalized = this.normalizeElement(parsed);
+                    if (normalized) {
+                        elements.push(normalized);
+                    }
+                }
+                catch {
+                    this.logger.debug(`Failed to parse line: ${lineTrimmed.slice(0, 50)}`);
+                }
+            }
+            return elements;
+        }
+    }
+    /**
+     * Normalize element from idb output to our interface
+     * Handles different field naming conventions defensively
+     */
+    normalizeElement(raw) {
+        if (!raw || typeof raw !== 'object') {
+            return null;
+        }
+        // Parse frame - handle multiple formats
+        const frame = this.parseFrame(raw);
+        if (!frame || !this.isValidFrame(frame)) {
+            return null;
+        }
+        return {
+            label: this.getString(raw, ['AXLabel', 'label', 'title', 'name']),
+            value: this.getString(raw, ['AXValue', 'value']),
+            type: this.getString(raw, ['type', 'AXType', 'element_type']),
+            role: this.getString(raw, ['role', 'AXRole']),
+            roleDescription: this.getString(raw, ['role_description', 'AXRoleDescription']),
+            identifier: this.getString(raw, ['AXUniqueId', 'identifier', 'accessibilityIdentifier']),
+            frame,
+            enabled: this.getBoolean(raw, ['enabled', 'AXEnabled'], true),
+            traits: this.getStringArray(raw, ['traits', 'AXTraits']),
+        };
+    }
+    getString(obj, keys) {
+        for (const key of keys) {
+            const val = obj[key];
+            if (typeof val === 'string' && val.length > 0) {
+                return val;
+            }
+        }
+        return undefined;
+    }
+    getBoolean(obj, keys, defaultVal) {
+        for (const key of keys) {
+            const val = obj[key];
+            if (typeof val === 'boolean') {
+                return val;
+            }
+        }
+        return defaultVal;
+    }
+    getStringArray(obj, keys) {
+        for (const key of keys) {
+            const val = obj[key];
+            if (Array.isArray(val)) {
+                return val.filter((v) => typeof v === 'string');
+            }
+        }
+        return undefined;
+    }
+    parseFrame(obj) {
+        // Format 1: {frame: {x, y, width, height}}
+        const frameObj = obj['frame'];
+        if (frameObj && typeof frameObj === 'object') {
+            const f = frameObj;
+            if (typeof f['x'] === 'number' &&
+                typeof f['y'] === 'number' &&
+                typeof f['width'] === 'number' &&
+                typeof f['height'] === 'number') {
+                return {
+                    x: f['x'],
+                    y: f['y'],
+                    width: f['width'],
+                    height: f['height'],
+                };
+            }
+        }
+        // Format 2: AXFrame string "{{x, y}, {width, height}}"
+        const axFrame = obj['AXFrame'];
+        if (typeof axFrame === 'string') {
+            return this.parseAXFrameString(axFrame);
+        }
+        return null;
+    }
+    parseAXFrameString(frameStr) {
+        // Format: "{{123.0, 456.0}, {100.0, 50.0}}"
+        try {
+            const cleaned = frameStr.replace(/\s/g, '').replace(/[{}]/g, '');
+            const nums = cleaned.split(',').map(Number);
+            if (nums.length === 4 && nums.every((n) => !isNaN(n))) {
+                return {
+                    x: nums[0],
+                    y: nums[1],
+                    width: nums[2],
+                    height: nums[3],
+                };
+            }
+        }
+        catch {
+            // Fall through to return null
+        }
+        return null;
+    }
+    isValidFrame(frame) {
+        return frame.width > 0 && frame.height > 0 && frame.x >= 0 && frame.y >= 0;
+    }
+}
+export const idbClient = new IDBClient();
+//# sourceMappingURL=idb-client.js.map